Map Search
No OAuth-enabled endpoints in this section. Turn off the OAuth filter in the sidebar to see all of its endpoints.
Report a map problem
Record a user-reported problem about a location, evse, or tariff
Request bodyapplication/json
The external location id the problem applies to
The country code of the location origin
The party id of the location origin
Optional evse uid the problem applies to
Optional tariff id the problem applies to
The type/category of the reported problem
missing_tariff200Report recorded application/json
400Invalid request parameters
500Internal server error
Search for charging locations
Search for charging locations within a bounding box with various filters
Request bodyapplication/json
The precision of the grid to use for the search
bboxobjectThe bounding box to search within
The bounding box to search within
The latitude of the north-west corner of the bounding box
The longitude of the north-west corner of the bounding box
The latitude of the south-east corner of the bounding box
The longitude of the south-east corner of the bounding box
The minimum power of the locations to search for
The statuses of the locations to search for
The power type of the locations to search for
Whether to only include locations that come with no additional charges
The publishing mode of the locations to search for
The location IDs to restrict the search to
The connector types to search for, e.g. CHADEMO
Whether to use geo hash aggregation
The precision of the geo hash to use for the search
Only include locations provided by the specified operators
Filter by charging accessibility (TESLA, ALL)
Whether to only include locations with EVSEs that support remote start/stop
Free text term matched (substring/fuzzy) against location id, EVSE id/uid, name and address fields
Combined country_code + party_id of the location origin, e.g. NLGFX. First two characters are the country code, the remainder is the party id
Restrict results to a single origin party id. Overrides the party id derived from infraProviderId when both are set
Restrict results to any of the given origin party ids. Ignored when partyId is set
Match locations that contain an EVSE with the given external evse_id or uid
Lower bound (inclusive) for the location lastUpdated timestamp (RFC3339)
Upper bound (inclusive) for the location lastUpdated timestamp (RFC3339)
Exclude locations provided by the specified operators. Applied after the include operator list.
Match locations whose EVSEs expose any of the given AUTH_METHOD_CAPABILITY_* values (OR semantics).
nearestToobjectSort results by ascending distance from this point. Disables geohash aggregation and returns a single bucket whose ids/distances are parallel and ordered by metres asc.
Sort results by ascending distance from this point. Disables geohash aggregation and returns a single bucket whose ids/distances are parallel and ordered by metres asc.
Latitude of the reference point
Longitude of the reference point
Vehicle heading in degrees (0-360). Only honoured when nearestTo is also set; restricts results to locations within a 90-degree forward cone of the travel direction and biases the remaining distance sort so locations more directly ahead outrank those off to the side at similar real distance. Distances in the response remain real metres.
200Successful search results with location data application/json
dataobject[]The geo hash buckets found in the search
The geo hash buckets found in the search
The geo hash key of the bucket
The number of locations in the geo hash bucket
centroidobjectThe centroid of the geo hash bucket
The centroid of the geo hash bucket
The location IDs in the geo hash bucket
Metres from the request nearestTo point, parallel to ids. Present only when the request included nearestTo.
statusesobject[]The statuses of the locations in the geo hash bucket
The statuses of the locations in the geo hash bucket
The status name
AVAILABLECHARGINGUNAVAILABLEOUTOFORDERPLANNEDRESERVEDCLOSEDBLOCKEDThe number of locations with the status