Afnemen
Warning
Deze API's zijn nog in ontwikkeling en de specificaties kunnen nog wijzigen.
Voor het aansluiten als afnemer is de onderstaande API-specificatie opgesteld, deze kan worden geïmplementeerd als client.
GeoJSON API
De ontwikkelde GeoJSON API is ontwikkeld met een boundingbox. Dit betekend dat je een samenvatting van de OCPI-data kan downloaden op basis van een stukje van Nederland (BoundingBox). Op basis van de volgende regex: ^-?\d+(?:\.\d+)?,-?\d+(?:\.\d+)?,-?\d+(?:\.\d+)?,-?\d+(?:\.\d+)?$ dienen de coördinaten meegegeven te worden.
Deze regex valideert een bounding box in het formaat: minLon, minLat, maxLon, maxLat. Dit patroon wordt 4 keer herhaalt, zodat al deze waarden meegegeven kunnen worden.
| Teken | Betekenis |
|---|---|
| ^ | Begin van de regel, er mag niets vóór de bounding box staan. |
| -? | Optioneel een minteken (toestaan van negatieve coordinaten) |
| \d+ | Één of meer cijfers |
| (?:...) | Optioneel decimaal stuk. Hiermee zijn zowel 52 als 52.1245 geldig |
| , | Verplicht een komma-teken als scheiding tussen de vier waarden |
| $ | Einde van de regel, er mag niets achter de boundig box staan. |
Via bijvoorbeeld https://bboxfinder.com kan je een boundingbox intekenen.
Er zitten ook wat beperkingen aan de bounding box:
- Maximaal bounding box gebied: 1.0 degree2
- Maximaal 1000 features
- Maximaal 10 requests per seconde (wanneer deze limiet wordt overschreden komt er een HTTP 429 error-code)
Voorbeeld bounding box URL
https://dotnl.ndw.nu/api/rest/geojson/dynamic-road-status/charge-point-data/v1/features?bbox=5.136386,52.081982,5.172843,52.097560
OpenAPI specificatie GeoJSON API
Afname van heel Nederland
Op de open data pagina van NDW is het ook mogelijk de volledige dataset in één keer af te nemen.
Info
Er is een OpenAPI spec opgesteld voor het afnemen van de verschillende datasets zoals hieronder genoemd. Dit zijn geen API's maar hiervoor werkt een cURL commando bijvoorbeeld wel. Datasets die via een cURL commando zijn op te halen: - OCPI Tarieven - OCPI Locaties - GeoJSON volledig Nederland
Voorbeeld voor afname met cURL:
curl -s https://opendata.ndw.nu/charging_point_locations_ocpi.json.gz | gunzip
OpenAPI specificatie OCPI & GeoJSON
Servicedesk
Voor meer informatie kan contact opgenomen worden met de NDW Servicedesk.
Ga terug naar de vorige pagina