Stations
This resource retrieves a list of charging stations for electric vehicles that match the specified criteria.
Requests against this resource use the HTTP GET method. The search criteria are specified by means of query parameters, which must include a search geometry.
A search geometry can be one of:
-
prox
– a circular area defined by the coordinates of its center and a radius. -
corridor
– a path defined as a set of points (latitude, longitude pairs) and a width. -
bbox
– a square defined by its top left latitude and longitude and its bottom right latitude and longitude.
Request Example
The code block below shows a search request for charging stations in Berlin using a bearer token:
GET https://ev-v2.cc.api.here.com/ev/stations.xml
?prox=52.516667,13.383333,5000
-H 'Authorization: Bearer{YOUR_TOKEN}'
The code block below shows a search request for charging stations in Berlin using an API Key:
GET
https://ev-v2.cc.api.here.com/ev/stations.xml
?prox=52.516667,13.383333,5000&apiKey={YOUR_API_KEY};
The following code block shows a search request for charging stations in Berlin with multiple connector types filtering using a Bearer token:
GET https://ev-v2.cc.api.here.com/ev/stations.xml
?prox=52.516667,13.383333,5000
&connectortype=30,31
-H 'Authorization: Bearer{YOUR_TOKEN}'
The following code block shows a search request for charging stations in Berlin with multiple connector types filtering using a API Key:
GET
https://ev-v2.cc.api.here.com/ev/stations.xml
?prox=52.516667,13.383333,5000&apiKey={YOUR_API_KEY};
Request Parameters
The table below documents both mandatory and optional request parameters supported by this resource.
Parameter | Required | Description |
---|---|---|
app_id - Legacy | Yes | A-20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an |
app_code - Legacy | Yes | A-20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an |
prox | prox , bbox or corridor must be present | A circular search area defined by the latitude and longitude of its center (compliant with WGS 84) and an integer representing the radius of the area in meters, all separated by commas. For example, Radius can be a maximum of 200 km. |
bbox | prox , bbox or corridor must be present | Bounding box defined by the latitude and longitude (compliant with WGS 84) of its top left and bottom right corners. The top left and bottom right pairs are separated by a semicolon and the latitude and longitude pairs are separated by commas. For example, one possible bounding box value is The bounding box can have a maximum height / width of 400km. If this limit is exceeded, the service responds with 'HTTP 400 Bad Request' response. |
corridor | prox , bbox or corridor must be present | A strip defined as a semicolon-separated list of points (pairs of comma-separated latitude and longitude WGS 84 compliant values) For example, specifies a journey from Berlin to Hamburg via Magdeburg.Maximum corridor area is 5000 km2. If this limit is exceeded, the service responds with 'HTTP 400 Bad Request' response. Note that requests to the |
connectortype | No | Comma-separated list of integer values identifying the connector types to be included in the response. The available connector types are:
You can retrieve the list of currently supported connector types using the For more information on the current connector types, see Connector Types. |
powerfeedtype | No | An integer identifying the type of power feed included in the response. Note: This information in only provided for charging stations in North America and Australia. If you use this query parameter in requests to the resource for search geometries that do not report this information, then the response does not contain any charging stations. The available values are as follows:
You can retrieve the list of currently supported powerfeed types using the For more information on the current power feed types, see Powerfeed Types. |
corridorwidth | No | The width of the corridor in meters. This parameter takes effect only if The maximum corridor width is 20 km. Default: 5000 meters |
powermin | No | At least one connector in the station must have a Accepted are float values: Default: doesn't apply |
powermax | No | At least one connector in the station must have a Accepted are float values: Default: doesn't apply |
sortkey | No | Criteria for sorting a list of search results: The possible values are:
Default: distance |
sortorder | No | The sort order in the response. The possible values are:
Default: asc |
maxresults | No | The maximum number of results a response can contain. This parameter can be used with the Default: 50 |
offset | No | A value specifying the index of the first result. The offset together with the "maxresults" value can be used to support a paging mechanism on search results. This parameter can be used with the Default: 0 |
Response to this Request
For more information on responses to queries against the stations
resource, see Stations Response.