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 5km of latitude 52.516667 and longitude 13.383333, which is in Berlin, Germany. The latitude and longitude values are in WGS 84 format.
Request Summary
| 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: Substitute your own unique
API key GET
https://ev-v2.cc.api.here.com/ev/stations.json
?prox=52.516667,13.383333,5000
&connectortype=31
-H 'Authorization: Bearer{YOUR_TOKEN}'
GET
https://ev-v2.cc.api.here.com/ev/stations.json
?prox=52.516667,13.383333,5000&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.516667,13.383333,5000
&connectortype=31
-H 'Authorization: Bearer{YOUR_TOKEN}'
GET
https://ev-v2.cc.api.here.com/ev/stations.xml
?prox=52.516667,13.383333,5000&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.
- Detailed information about the connectors at a charging stations.
The example response in JSON format is as follows:
{
"hasMore": true,
"count": 50,
"evStations": {
"evStation": [
{
"poolId": "276u33db845jn-aGVyZS1ldjplY29tb3ZlbWVudDo4OTU5MDU0ODI",
"totalNumberOfConnectors": 2,
"connectors": {
"connector": [
{
"supplierName": "RWE eRoaming",
"connectorType": {
"name": "IEC 62196-2 type 2 (Mennekes)",
"id": "31"
},
"chargeCapacity": "380-480VAC, 3-phase at max. 32 A",
"maxPowerLevel": 22.08,
"customerChargeLevel": "3",
"customerConnectorName": "AC EV connector (Mennekes - type 2)",
"fixedCable": false,
"connectorDetails": {
"privateAccess": false,
"open24x7": true,
"openingHours": {
"regularOpeningHours": [
{
"daymask": 127,
"period": [
{
"from": "00:00:00",
"to": "24:00:00"
}
]
}
],
"annualOpenings": [ ]
},
"pay": true,
"manufacturer": "RWE"
},
"chargingPoint": {
"chargeMode": "3",
"voltsRange": "380-480V AC",
"phases": 3,
"ampsRange": "32A",
"numberOfConnectors": 2
}
}
]
},
"evStationDetails": {
"privateAccess": false,
"restrictedAccess": true,
"accessibilityType": "RESTRICTED",
"paymentMethods": {
"subscription": {
"provider": "RWE eRoaming",
"accept": true
},
"note": "Mobile Payment Option Available"
},
"notes": "Ladestation RWE Effizienz GmbH"
},
"address": {
"city": "Berlin",
"country": "DEU",
"region": "Berlin",
"street": "Luisenstraße",
"streetNumber": "31",
"postalCode": "10117"
},
"contacts": {
"phone": [
{
"value": "+498002255793",
"label": "PHONE"
}
]
},
"distance": 421,
"position": {
"latitude": 52.5199013,
"longitude": 13.3800898
},
"name": "RWE Effizienz GmbH",
"id": "276u33db-b2c840878cfc409fa5a0aef858419037",
"lastUpdateTimestamp": "2015-08-28T04:39:27.737Z",
"timeZone":"Europe/Berlin"
},
{
--- removed to shorten document
}
]
}
}
The example response in XML format is as follows:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ev:evStationsResult xmlns:fuel="http://www.here.com/2014/02/ACS-Fuel" xmlns:common="http://www.here.com/2014/02/ACS-Common" xmlns:ev="http://www.here.com/2014/02/ACS-EV" xmlns:parking-offstreet="http://www.here.com/2014/02/ACS-Parking-Offstreet">
<hasMore>true</hasMore>
<count>50</count>
<evStations>
<evStation id="276u33db-b2c840878cfc409fa5a0aef858419037" lastUpdateTimestamp="2015-08-28T04:39:27.737Z" timeZone="Europe/Berlin">
<address>
<city>Berlin</city>
<country>DEU</country>
<region>Berlin</region>
<street>Luisenstraße</street>
<streetNumber>31</streetNumber>
<postalCode>10117</postalCode>
</address>
<contacts>
<phone>
<value>+498002255793</value>
<label>PHONE</label>
</phone>
</contacts>
<distance>421</distance>
<position>
<latitude>52.5199013</latitude>
<longitude>13.3800898</longitude>
</position>
<name>RWE Effizienz GmbH</name>
<poolId>276u33db845jn-aGVyZS1ldjplY29tb3ZlbWVudDo4OTU5MDU0ODI</poolId>
<totalNumberOfConnectors>2</totalNumberOfConnectors>
<connectors>
<connector>
<supplierName>RWE eRoaming</supplierName>
<connectorType>
<name>IEC 62196-2 type 2 (Mennekes)</name>
<id>31</id>
</connectorType>
<chargeCapacity>380-480VAC, 3-phase at max. 32 A</chargeCapacity>
<maxPowerLevel>22.08</maxPowerLevel>
<customerChargeLevel>3</customerChargeLevel>
<customerConnectorName>AC EV connector (Mennekes - type 2)</customerConnectorName>
<fixedCable>false</fixedCable>
<connectorDetails>
<privateAccess>false</privateAccess>
<open24x7>true</open24x7>
<openingHours>
<regularOpeningHours>
<daymask>127</daymask>
<period>
<from>00:00:00</from>
<to>24:00:00</to>
</period>
</regularOpeningHours>
</openingHours>
<pay>true</pay>
<manufacturer>RWE</manufacturer>
</connectorDetails>
<chargingPoint>
<chargeMode>3</chargeMode>
<voltsRange>380-480V AC</voltsRange>
<phases>3</phases>
<ampsRange>32A</ampsRange>
<numberOfConnectors>2</numberOfConnectors>
</chargingPoint>
</connector>
</connectors>
<evStationDetails>
<privateAccess>false</privateAccess>
<restrictedAccess>true</restrictedAccess>
<accessibilityType>RESTRICTED</accessibilityType>
<paymentMethods>
<subscription accept="true">
<provider>RWE eRoaming</provider>
</subscription>
<note>Mobile Payment Option Available</note>
</paymentMethods>
<notes>Ladestation RWE Effizienz GmbH</notes>
</evStationDetails>
</evStation>
<evStation id="276u33db-822fe7352e204e36b733275c62e2ec4e" lastUpdateTimestamp="2015-08-28T08:53:33.834Z" timeZone="Europe/Berlin">
--- removed to shorten document
</evStation>
</evStations>
</ev:evStationsResult>
For more details about responses to this type of request, see Stations Response.
