Skip to content
/
Look up a public EVSE's G...

Look up a public EVSE's Google and Apple place IDs

Request

Returns the Google Maps and Apple Maps place IDs for a public EVSE, so the EV Route Planner can hand each charging stop to a maps app by name rather than by coordinates.

Core searches each provider for EVSEs near the given point and keeps a result only when it lies within 100 m (and, for Apple, has a similar name). Results are cached per EVSE: a found ID for a year, a miss for 30 days.

Each ID is null when no match was found, when the provider is not configured, or when the provider could not be reached.

Error responses follow RFC 9457 Problem Details. Problem types emitted by this endpoint:

  • validation-failed-route-planner-place-ids — missing or invalid name / latitude / longitude query parameter (400).
Security
oauth2(Required scopes: route_planner_preferences:read)
Query
namestring, [ 1 .. 200 ] charactersrequired

The EVSE's name, as the planner shows it.

latitudenumber, [ -90 .. 90 ]required

The EVSE's latitude.

longitudenumber, [ -180 .. 180 ]required

The EVSE's longitude.

Headers
EvEnergy-Versionnumber

Specify the version of this endpoint to use.

Value:2
curl -i -X GET \
  'https://developers.ev.energy/_mock/ev.energy-api-v2/route_planner/place_ids?name=string&latitude=-90&longitude=-180' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'EvEnergy-Version: 2'

Responses

The EVSE's place IDs, each nullable.

Headers
EvEnergy-Versionnumber

Indicates the version of the API that generated this response. If EvEnergy-Version was not specified in the request, this will be your OAuth application's default version.

Value:2
X-RateLimit-Limitnumber

The maximum number of requests that can be made to this endpoint per hour. Defaults to 1000 but may vary per client.

Default:1000
X-RateLimit-Remainingnumber

The number of requests remaining until this client's rate limit is reached.

Default:999
RetryAfternumber

The number of seconds until this client's requests will not be rate limited.

Default:3600
Bodyapplication/json
google_place_idstring or nullrequired

Google Maps place ID, or null when there is no match.

Example:"ChIJ2eUgeAK6j4ARbn5u_wAGqWA"
apple_place_idstring or nullrequired

Apple Maps place ID, or null when there is no match.

Example:"I7C250D2CDCB364A"
Response
{
  "google_place_id": "ChIJ2eUgeAK6j4ARbn5u_wAGqWA",
  "apple_place_id": "I7C250D2CDCB364A"
}