Clarification of the Object table and JSON output of charging stations details API made by Here

In this article, I will focus on clarifying the object table and JSON output of Here charging stations details API. For programmers who are familiar with these data structures, understanding the object table and JSON output can help them better utilize the data provided by the API. Specifically, I will examine how the charging station details are organized into an object table and explain the structure and formatting of the JSON output. By the end of this article, readers should have a clear understanding of how the charging station details are represented in the object table and JSON output of Here charging stations details API.

Table

• hasMore: A boolean value that indicates whether there are more results available that can be obtained by using pagination.

• evStations: An array of charging stations.

• evStation: A charging station object that contains information about the charging station, such as its location, status, and the connectors available at the station.

• poolId: A unique identifier for the pool of charging stations.

• totalNumberOfConnectors: An integer that represents the total number of connectors available across all the charging stations.

• connectors: An array of connector objects.

• connector: A connector object that contains information about the connector, such as its ID, type, status, and the charging capacity.

• supplierName: The name of the supplier that operates the charging station.

• connectorType: The type of the connector, such as CHAdeMO, CCS, or Tesla Supercharger.

• name: The name of the charging station.

• id: A unique identifier for the charging station.

• chargeCapacity: The maximum power that the charging station can deliver.

• maxPowerLevel: The maximum power level that the connector supports.

• customerChargeLevel: The minimum charge level that the customer can choose.

• customerConnectorName: The name of the connector that the customer has used for charging.

• fixedCable: A boolean value that indicates whether the cable is fixed to the charging station or not.

• connectorDetails: Additional information about the connector, such as the voltage, current, and phase.

• privateAccess: A boolean value that indicates whether the charging station is accessible only to a specific group of users.

• open24x7: A boolean value that indicates whether the charging station is open 24/7 or not.

• openingTime: The opening hours of the charging station.

• etc: Other objects and their descriptions that are not listed in the table.

The information in the table is useful because it provides a comprehensive list of objects that are available in the Here charging stations details API. Developers can use this information to understand the structure of the data and extract the specific information they need for their applications. For instance, by knowing the names and descriptions of the objects, developers can write code to parse the JSON response from the API and extract the relevant information. The table can also be used as a reference for debugging or troubleshooting issues that arise when working with the API. Overall, the information in the table serves as a valuable resource for developers who are working with the Here charging stations details API.

JSON output

This JSON output contains information about electric vehicle (EV) charging stations. The "hasMore" key indicates whether there are more EV stations to be fetched. The "evStations" object contains an array of "evStation" objects, each of which provides details about a particular charging station. Each "evStation" object has a unique "id" and "name" identifying the charging station. The "totalNumberOfConnectors" key specifies the total number of connectors available at the station, and the "connectors" object contains an array of "connector" objects, each of which provides details about a particular connector, including its supplier, type, and charging capabilities. The "evStationDetails" object provides additional information about the charging station, such as its accessibility, payment methods, and any notes about the station. The "address" object provides information about the station's location, including the city, country, region, street, street number, and postal code. The "contacts" object provides a phone number associated with the station. The "position" object provides the latitude and longitude of the station's location, and the "lastUpdateTimestamp" key indicates when the information about the station was last updated. Finally, the "timeZone" key indicates the time zone of the charging station.

{
"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": {
"privateAccess": false,
"restrictedAccess": true,
"accessibilityType": "RESTRICTED",
"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"
}
]
}
}

Final words

In this article, we discussed the object table and JSON output of the Here charging stations details API. We first converted an HTML table to a readable format and then provided detailed descriptions for each object in the table. We also explained why the information in the table is useful for developers and users who need to access and interact with electric vehicle charging station data. By understanding the objects returned by the API, developers can create applications that consume and display the charging station data, while users can benefit from the detailed information provided by the API when planning their trips or deciding where to charge their electric vehicles. Overall, this conversation provided valuable insights into the Here charging stations details API and its objects.

Reference

The Here charging stations details API is available through the third party data marketplace of Worldindata. Developers can request access to the API by signing up on the Worldindata platform and selecting the Here charging stations details API as a data source. Once access is granted, developers can start using the API to retrieve information about electric vehicle charging stations. The API provides detailed information about individual charging stations, including their location, number of connectors, connector type, charging capacity, opening times, and more. This information can be used by developers to create applications that help electric vehicle drivers locate charging stations, plan their trips, and monitor charging progress. With the growing popularity of electric vehicles, the Here charging stations details API can be a valuable resource for developers looking to create innovative solutions for this market.