How to get list of charging stations
This section provides an example of a request for a list of charging stations within a specified search geometry.
User story
In this example, the user wants to find a charging station with an IEC 62196-2 type 2 (Mennekes) connector for an electric vehicle within 200m of latitude 52.512433 and longitude 13.38052, which is in Berlin, Germany. The latitude and longitude values are in WGS 84 format.
Request Summary
| Component | Description |
|---|---|
| Resource | stations– note that resource representation is specified via extensions .xml or .json. |
| Parameters | • prox– indicates the area searched for charging stations; in this case the area is a circle defined by a point within Berlin and a radius of 5km. • connectortype– indicates the type of connector required for a charging station to be included in the response; in this case 31 – IEC 62196-2 type 2 (Mennekes). |
Request example
The code block below demonstrates the complete request, specifying that the response data is to be delivered in JSON.
Note
Be sure to use your own unique
API keywhen creating the call
GET
https://ev-v2.cc.api.here.com/ev/stations.json
?prox=52.512433,13.38052,200
&connectortype=31
-H 'X-API-Key:{YOUR_API_KEY}'
GET
https://ev-v2.cc.api.here.com/ev/stations.json?prox=52.512433,13.38052,200&connectortype=31&apiKey={YOUR_API_KEY};
Here is the same request indicating that the response data is to be delivered in XML.
GET
https://ev-v2.cc.api.here.com/ev/stations.xml
?prox=52.512433,13.38052,200
&connectortype=31
-H 'X-API-Key:{YOUR_API_KEY}'
GET
https://ev-v2.cc.api.here.com/ev/stations.xml
?prox=52.512433,13.38052,200&connectortype=31&apiKey={YOUR_API_KEY};Response Example
The response to the request contains:
- Information about the charging stations.
- Information about the connectors at charging stations containing the address, the number of connectors and the opening hours.
- Roaming information. For details about roaming information, see Charge card (eMSP) acceptance
The response contains separate lastUpdateTimestamp values on different detail levels. The timestamps reflects updated times for:
evStation[].lastUpdateTimestamp: represents the latest lastUpdateTimestamp among all connectors within the given station. This value reflects the most recent update time from any connector at the station level...connector[].lastUpdateTimestamp: represents the latest timestamp when dynamic connector availability was last updated among all connectors in given group..connector[].chargingPoint.lastUpdateTimestamp: represents the latest timestamp when dynamic connector availability was last updated among all connectors in given group
The example response in JSON format is as follows:
{
"hasMore": false,
"count": 1,
"evStations": {
"evStation": [
{
"id": "ZW06NDE4ZTUzYmZkMDQ5YWY1Yzc1MjQ0YmRkOWRkZWYyMjI",
"lastUpdateTimestamp": "2024-02-19T17:54:37.000Z",
"timeZone": "Europe/Helsinki",
"address": {
"state": "Pohjois-Suomi",
"county": "Pohjois-Pohjanmaa",
"city": "Oulu",
"country": "FIN",
"district": "Oulu",
"street": "Kiilakivenkuja",
"streetNumber": "2",
"postalCode": "90250",
"unparsedAddress": "Kiilakivenkuja 2",
"sideOfStreet": "RIGHT"
},
"contacts": {
"phone": [
{
"value": "+35820334455",
"label": "PHONE"
}
],
"website": [
{
"value": "https://rechargeinfra.com",
"label": "WEBSITE"
}
]
},
"distance": 0,
"position": {
"latitude": 64.985063,
"longitude": 25.511302
},
"entrancePosition": {
"latitude": 64.984878,
"longitude": 25.51129
},
"name": "Recharge",
"brand": "Recharge",
"poolId": "246ued1sw0v2m-aGVyZS1ldjplY29tb3ZlbWVudDoxNTUyMzM5Nzc0",
"cpoId": "0476045c-f356-11ed-a976-42010aa40fc0",
"totalNumberOfConnectors": 4,
"connectors": {
"connector": [
{
"supplierName": "Recharge",
"connectorType": {
"name": "IEC 62196-3 type 2 combo (Mennekes)",
"id": "34"
},
"chargeCapacity": "1000-1000VDC, at max 300A",
"maxPowerLevel": 300,
"customerChargeLevel": "4",
"customerConnectorName": "AC/DC combo (Mennekes - type 2)",
"fixedCable": true,
"connectorDetails": {
"reservable": true,
"open24x7": true,
"openingHours": {
"regularOpeningHours": [
{
"daymask": 127,
"period": [
{
"from": "00:00:00",
"to": "23:59:59"
}
]
}
]
},
"pay": true,
"pricing": [
{
"pricingModel": "kWh",
"price": {
"value": 0.496,
"currency": "EUR"
},
"unit": {
"value": "kWh",
"amount": 1
}
}
]
},
"chargingPoint": {
"chargeMode": "4",
"voltsRange": "1000-1000V DC",
"ampsRange": "300A",
"numberOfConnectors": 4,
"numberOfAvailable": 3,
"numberOfInUse": 1,
"lastUpdateTimestamp": "2024-02-27T09:54:15.000Z"
},
"lastUpdateTimestamp": "2024-02-19T08:44:20.000Z",
"connectorStatuses": {
"connectorStatus": [
{
"cpoEvseId": "6666",
"cpoEvseEMI3Id": "FI*CHA*EF933*A",
"physicalReference": "F933",
"cpoConnectorId": "6666",
"state": "AVAILABLE"
},
{
"cpoEvseId": "6667",
"cpoEvseEMI3Id": "FI*CHA*EF933*B",
"physicalReference": "F933",
"cpoConnectorId": "6667",
"state": "AVAILABLE"
},
{
"cpoEvseId": "7580",
"cpoEvseEMI3Id": "FI*CHA*EF968*A",
"physicalReference": "F968",
"cpoConnectorId": "7580",
"state": "AVAILABLE"
},
{
"cpoEvseId": "7581",
"cpoEvseEMI3Id": "FI*CHA*EF968*B",
"physicalReference": "F968",
"cpoConnectorId": "7581",
"state": "OCCUPIED"
}
]
},
"supplierUID": "1f7ef60a-cca5-11ed-8dd9-42010aa40002",
"supplierEmaID": [
"SE-REC"
]
}
]
},
"evStationDetails": {
"privateAccess": false,
"restrictedAccess": false,
"accessibilityType": "PUBLIC",
"paymentMethods": {
"other": {
"accept": true,
"types": {
"type": [
"app",
"rfid-reader",
"terminal-qr-code",
"terminal-sms"
]
}
}
}
},
"roaming": [
{
"emsp": "Plugsurfing",
"partnerId": "1f351b84-cca5-11ed-8155-42010aa40002"
},
{
"emsp": "Shell Recharge",
"partnerId": "1f39ad02-cca5-11ed-9d1a-42010aa40002",
"emaId": [
"AT-SHE",
"AT-TNM",
"BE-SFS",
"BE-SHL",
"BE-TNM",
"DK-TNM",
"ES-TNM",
"FR-TNM",
"GB-TNM",
"IE-TNM",
"IT-TNM",
"LU-SFS",
"LU-SHL",
"LU-TNM",
"NL-SFS",
"NL-SHL",
"NL-TNM",
"NO-TNM",
"SE-TNM"
]
},
{
"emsp": "Recharge",
"partnerId": "1f7ef60a-cca5-11ed-8dd9-42010aa40002",
"emaId": [
"SE-REC"
]
},
{
"emsp": "ChargePoint",
"partnerId": "1f90fdf0-cca5-11ed-be23-42010aa40002",
"emaId": [
"AT-CPI",
"BE-ALD",
"BE-CPI",
"DE-CPI",
"ES-CPI",
"FR-CPI",
"GB-CPI",
"IE-CPI",
"IT-CPI",
"LU-ALD",
"NL-ALD",
"NL-CPI",
"SE-CPI"
]
},
{
"emsp": "Freshmile",
"partnerId": "21d6b686-cca5-11ed-83b8-42010aa40002"
},
{
"emsp": "BMW",
"partnerId": "21ef8850-cca5-11ed-9d2b-42010aa40002"
},
{
"emsp": "Kia",
"partnerId": "2421fb30-cca5-11ed-89c1-42010aa40002"
},
{
"emsp": "Mobiliti",
"partnerId": "27393dba-cca5-11ed-9b8b-42010aa40002"
},
{
"emsp": "AUDI",
"partnerId": "295adedc-cca5-11ed-8fa2-42010aa40002",
"emaId": [
"DE-AUC"
]
},
{
"emsp": "Kople",
"partnerId": "2b8fafe8-cca5-11ed-a62f-42010aa40002",
"emaId": [
"NO-KPL"
]
},
{
"emsp": "Hyundai",
"partnerId": "2d6754b0-cca5-11ed-ade1-42010aa40002"
},
{
"emsp": "Jaguar Charging",
"partnerId": "3379b852-cca5-11ed-8856-42010aa40002"
},
{
"emsp": "Lotus",
"partnerId": "79c4c474-19a2-11ee-880e-42010aa40002"
},
{
"emsp": "Bosch",
"partnerId": "268699a8-cca5-11ed-951e-42010aa40002",
"emaId": [
"DE-8RB"
]
},
{
"emsp": "vinfast",
"partnerId": "3a632824-cca5-11ed-8029-42010aa40002"
}
]
}
]
}
}
For more details about responses to this type of request, see Stations Response.
Updated 2 days ago