HERE EV Charge Points API
EV Charging Stations API Developer's Guide

Get charging station details

This section provides an example of a request for full static and dynamic information about a specific charging station.

User story

Based on the results of a search for charging stations, the user wishes to retrieve the full/updated information about a single charging station only.

Request summary

Resource: station/{id} – where id is an attribute of the evStation element with a unique value. Note that resource representation is specified via extensions .xml or .json. For more information, see Station Details.

Request example

Note: id values change without notice. If the id is no longer available in the resource, a 404 not found status message is returned.

The code block below demonstrates the complete request, specifying that the response data are to be delivered in JSON.

GET 
https://ev-v2.cc.api.here.com/ev/stations/276u33db-b2c840878cfc409fa5a0aef858419037.json
-H 'Authorization: Bearer {YOUR_TOKEN}"

Here is the same request indicating that the response data are to be delivered in XML.

GET 
https://ev-v2.cc.api.here.com/ev/stations/276u33db-b2c840878cfc409fa5a0aef858419037.xml
-H 'Authorization: Bearer {YOUR_TOKEN}"

Response example

The response to the request contains:

  • information about the charging station
  • list of connectors at the charging station
  • connector detail information
  • dynamic connector availability information

The example response in JSON format is as follows:


{
  "hasMore": false,
  "evStations": {
  "evStation": [
    {
    "poolId": "276u33db2r2h0-aGVyZS1ldjplY29tb3ZlbWVudDo4OTIyMDgzOTE",
    "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,
        "openingTime": "0:00 - 24:00",
        "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,
        "numberOfAvailable": 2,
        "lastUpdateTimestamp": "2019-03-12T13:36:40.919Z"
        }
      }
      ]
    },
    "evStationDetails": {
      "paymentMethods": {
      "subscription": {
        "provider": "RWE eRoaming",
        "accept": true
      },
      "note": "Mobile Payment Option Available",
      "creditCard": {
        "types": {
        "type": [
          "AMEX",
          "MASTERCARD",
          "VISA",
          "CARTEBLANCHE",
          "DINERSCLUB",
          "DISCOVER",
          "OTHER"
        ]
        },
        "accept": true
      },
      "cash": {
        "currencies": {
        "currency": [
          "USD",
          "EUR",
          "GBP"
        ]
        },
        "accept": true
      },
      "debitCard": {
        "accept": true
      },
      "check": {
        "types": {
        "type": [
          "MONEY ORDER",
          "PERSONAL",
          "TRAVELERS",
          "OTHER"
        ]
        },
        "accept": true
      },
      "ePayment": {
        "types": {
        "type": [
          "PAYPAL",
          "OTHER"
        ]
        },
        "accept": true
      },
      "other": {
        "types": {
        "type": [
          "CASHBACK",
          "LOAN",
          "WIRETRANSFERS"
        ]
        },
        "accept": true
      }
      },
      "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"
      }
      ]
    },
    "position": {
      "latitude": 52.5199013,
      "longitude": 13.3800898
    },
    "name": "RWE Effizienz GmbH",
    "id": "276u33db-b2c840878cfc409fa5a0aef858419037",
    "lastUpdateTimestamp": "2015-08-28T04:39:27.737Z",
    "timeZone": "Europe/Berlin"
    }
  ]
  }
}

The example response in XML format is as follows:


<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ev:evStationsResult xmlns:common="http://www.here.com/2014/02/ACS-Common" xmlns:ev="http://www.here.com/2014/02/ACS-EV" xmlns:fuel="http://www.here.com/2014/02/ACS-Fuel" xmlns:parking-offstreet="http://www.here.com/2014/02/ACS-Parking-Offstreet">
  <hasMore>false</hasMore>
  <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>
      <position>
        <latitude>52.5199013</latitude>
        <longitude>13.3800898</longitude>
      </position>
      <name>RWE Effizienz GmbH</name>
      <poolId>276u33db2r2h0-aGVyZS1ldjplY29tb3ZlbWVudDo4OTIyMDgzOTE</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>
            <openingTime>0:00 - 24:00</openingTime>
            <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>
            <numberOfAvailable>2</numberOfAvailable>
            <lastUpdateTimestamp>2019-03-12T13:46:41.491Z</lastUpdateTimestamp>
          </chargingPoint>
        </connector>
      </connectors>
      <evStationDetails>
        <paymentMethods>
          <subscription accept="true">
            <provider>RWE eRoaming</provider>
          </subscription>
          <note>Mobile Payment Option Available</note>
          <creditCard accept="true">
            <types>
              <type>AMEX</type>
              <type>MASTERCARD</type>
              <type>VISA</type>
              <type>CARTEBLANCHE</type>
              <type>DINERSCLUB</type>
              <type>DISCOVER</type>
              <type>OTHER</type>
            </types>
          </creditCard>
          <cash accept="true">
            <currencies>
              <currency>USD</currency>
              <currency>EUR</currency>
              <currency>GBP</currency>
            </currencies>
          </cash>
          <debitCard accept="true"/>
          <check accept="true">
            <types>
              <type>MONEY ORDER</type>
              <type>PERSONAL</type>
              <type>TRAVELERS</type>
              <type>OTHER</type>
            </types>
          </check>
          <ePayment accept="true">
            <types>
              <type>PAYPAL</type>
              <type>OTHER</type>
            </types>
          </ePayment>
          <other accept="true">
            <types>
              <type>CASHBACK</type>
              <type>LOAN</type>
              <type>WIRETRANSFERS</type>
            </types>
          </other>
        </paymentMethods>
        <notes>Ladestation RWE Effizienz GmbH</notes>
      </evStationDetails>
    </evStation>
  </evStations>
</ev:evStationsResult>

For more details about responses to this type of request, see Stations Response.