EV Charging Stations API Developer's Guide

Stations Count

This resource returns number 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.

Note the filtering criteria are not taken into consideration in counting requests.

Request Example

The code block below shows a count request for charging stations in Berlin using a bearer token.

GET 
https://ev-v2.cc.api.here.com/ev/stations/count.xml
?prox=52.516667,13.383333,5000
-H 'Authorization: Bearer{YOUR_TOKEN}'

The code block below shows a count request for charging stations in Berlin using an API Key.

GET
https://ev-v2.cc.api.here.com/ev/stations/count.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_id` and `app_code` with every request. For more information on authentication, see the Identity & Access Management Developer Guide.
`app_code - Legacy`	Yes	A-20 byte Base64 URL-safe encoded string used for the authentication of the client application. You must include an `app_id` and `app_code` with every request. For more information on authentication, see the Identity & Access Management Developer Guide.
`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, `prox=52.516667,13.383333,5000` searches for charging stations within 5km of latitude 52.50° N and 13.55 ° E, which is within Berlin. 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 `bbox=52.8,11.37309;52.31,13.2`. The bounding box size (width and/or high) must be no larger than 400km.
`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, `corridor=52.51666,13.38333; 52.13333,11.61666;53.56527,10.00138` specifies a journey from Berlin to Hamburg via Magdeburg. Maximum corridor area is 5000 km² Note that requests to the `stations/count` resource can be a maximum of 4 kb in size in total. Since the `corridor` query parameter is the item that is most likely to contain the most information, a useful guideline is that this parameter can contain approximately 150 points (latitude/longitude pairs with an accuracy of 5 decimal points [for example, `11.37309`]). Note that the amount of data you can include depends on the exact formulation of the request. If URL size is over 4 kb use `POST` HTTP method for this resource. Corridor area can not exceeds 1000 km²
`corridorwidth`	No	The width of the corridor in meters. This parameter takes effect only if `corridor` is included in the request. The maximum corridor width is 20 km. Default: 5000 meters
`powermin`	No	At least one connector in the station must have a `maxPowerLevel` value greater than or equal to this parameter. Accepted are float values: `powermin=11.6` Default: doesn't apply
`powermax`	No	At least one connector in the station must have a `maxPowerLevel` value less than or equal to this parameter. Accepted are float values: `powermax=55.3` Default: doesn't apply

Response to this Request

For more information on responses to queries against the stations/count resource, see Stations Count Response.