Data consumption
Warning
These APIs are still under development and their specifications may change.
DOT-NL (Data Platform Openly Accessible Charging Points Netherlands) is the portal that receives real-time data about alternative energy infrastructure for vehicles from suppliers and makes it available as open data.
GeoJSON API
The developed GeoJSON API uses a bounding box. This means you can download a summary of the OCPI data based on a specific area of the Netherlands (BoundingBox). Based on the following regex: ^-?\d+(?:\.\d+)?,-?\d+(?:\.\d+)?,-?\d+(?:\.\d+)?,-?\d+(?:\.\d+)?$. the coordinates must be provided.
This regex validates a bounding box in the format:minLon, minLat, maxLon, maxLat. This pattern is repeated four times so that all values can be supplied.
| Character | Meaning |
|---|---|
| ^ | Start of the string, nothing may appear before the bounding box |
| -? | Optional minus sign (allowing negative coordinates) |
| \d+ | One or more digits |
| (?:...) | Optional decimal part; both 52 and 52.1245 are valid |
| , | A comma is required as separator between the four values |
| $ | End of the string, nothing may appear after the bounding box |
You can draw a bounding box using, for example, https://bboxfinder.com.
There are also some limitations on the bounding box:
- Maximum bounding box area: 1.0 degree2
- Maximum of 1000 features
- Maximum of 10 requests per second (exceeding this limit will result in an HTTP 429 error code)
Example boundingbox 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 Specification GeoJSON API
Consumption of the Entire Netherlands
On the opendata page, it is also possible to download the complete dataset in a single request.
Info
An OpenAPI specification has been created for retrieving the different datasets listed below. These are not APIs; however, using a cURL command is possible. Datasets that can be retrieved using a cURL command and for which an OpenAPI specification has been created include: - OCPI Tariffs - OCPI Locations - GeoJSON (entire Netherlands)
Example of retrieval using cURL:
curl -s https://opendata.ndw.nu/charging_point_locations_ocpi.json.gz | gunzip
OpenAPI specification OCPI & GeoJSON
Servicedesk
For more information, please contact the NDW Servicedesk
Go back to the previous page