API 1.8
XML Schemas
XML schemas can be found here.
Example
Static Feed
The static feed for Germany
https://api.tomtom.com/electromobility/api/1.8/static/de?key=<apiKey>
Example Response
The available static information for all known charging stations in the requested country is provided as xml. The order of the stations is not specified.
<?xml version="1.0" encoding="UTF-8" ?> <chargingParks xmlns="http://www.tomtom.com/service/tis/chargingstation/static/1.0" xmlns:meta="http://www.tomtom.com/service/tis/chargingstation/metadata/1.0" xmlns:p="http://www.tomtom.com/service/tis/primitives/1.0" xmlns:lb="http://www.tomtom.com/service/tis/locBbox" xmlns:lp="http://www.tomtom.com/service/tis/location/point/1.0" xmlns:la="http://www.tomtom.com/service/tis/location/address/1.0" xmlns:lh="http://www.tomtom.com/service/tis/location/hash/1.0" xmlns:oh="http://www.tomtom.com/service/tis/openinghours/1.0" schemaVersion="1.0"> <meta:metaData> <meta:creatorVersion>0.01-9.1.RC2@0</meta:creatorVersion> <meta:creatorUUID>1232abdf-6ef7-4310-81b5-e7e4be3786f0</meta:creatorUUID> <meta:creationTimeUTC>2016-01-13T09:06:46Z</meta:creationTimeUTC> <meta:description>Example showing static charging station information</meta:description> </meta:metaData> <chargingPark> <uuid>9876dcba-5f0e-2314-435a-aa34cd12f9fe</uuid> <externalId>042009000104250</externalId> <properties> <name>Baker Motor</name> <countryCode>DE</countryCode> <contact> <email>aEmail@address.com</email> <web>http://tomtom.com</web> <phone>+49 228 123231</phone> <fax>+49 228 123232</fax> </contact> <operator> <name>operator's name</name> <contact> <email>operatorEmail@address.com</email> <web>http://tomtom.com/operator</web> <phone>+49 228 223231</phone> <fax>+49 228 223232</fax> </contact> <address> <la:street>An den Treptowers 1</la:street> <la:city>Berlin</la:city> <la:postalCode>5455</la:postalCode> <la:country>DE</la:country> </address> </operator> <oh:openingHours> <oh:openingPeriod> <oh:day> <oh:from>Mo</oh:from> <oh:to>Fr</oh:to> </oh:day> <oh:time> <oh:opens>00:00</oh:opens> </oh:time> </oh:openingPeriod> <oh:openingPeriod> <oh:day> <oh:from>Su</oh:from> <oh:to>Su</oh:to> </oh:day> <oh:time> <oh:opens>06:30</oh:opens> <oh:closes>10:00</oh:closes> </oh:time> </oh:openingPeriod> </oh:openingHours> <paymentOptions> <paymentOption> <method>Direct</method> <currencies> <currency>EUR</currency> <currency>USD</currency> </currencies> <brands> <brand>visa</brand> <brand>maestro</brand> </brands> <benefits> <benefit>Special benefit</benefit> <benefit>Special benefit 2</benefit> </benefits> </paymentOption> <paymentOption> <method>Subscription</method> <brands> <brand>ChargeMSP</brand> <brand>PlugMSP</brand> </brands> </paymentOption> <paymentOption> <method>Subscription</method> <brands> <brand>F2C-MSP</brand> </brands> <benefits> <benefit>20% discount</benefit> </benefits> </paymentOption> </paymentOptions> </properties> <locations> <lb:boundingBox> <lb:lowerLeft> <p:latitude>50.73689</p:latitude> <p:longitude>7.10662</p:longitude> </lb:lowerLeft> <lb:upperRight> <p:latitude>50.73698</p:latitude> <p:longitude>7.10674</p:longitude> </lb:upperRight> </lb:boundingBox> <lp:pointLocation> <p:latitude>50.73689</p:latitude> <p:longitude>7.10674</p:longitude> </lp:pointLocation> <lh:locationHash>7230324</lh:locationHash> </locations> <chargingStations> <chargingStation> <uuid>1232abdf-6ef7-4310-81b5-e7e4be3786f0</uuid> <externalId>anExternalId-A</externalId> <name>First station</name> <accessibilityType>Public</accessibilityType> <locations> <lb:boundingBox> <lb:lowerLeft> <p:latitude>50.73689</p:latitude> <p:longitude>7.10662</p:longitude> </lb:lowerLeft> <lb:upperRight> <p:latitude>50.73698</p:latitude> <p:longitude>7.10674</p:longitude> </lb:upperRight> </lb:boundingBox> <lp:pointLocation> <p:latitude>50.73689</p:latitude> <p:longitude>7.10674</p:longitude> </lp:pointLocation> <lh:locationHash>6138943</lh:locationHash> </locations> <chargingPoints> <chargingPoint> <uuid>5e332e95-b0bc-3f35-0000-00090af7026d</uuid> <externalId>anExternalId-A_1a</externalId> <name>Connector A</name> <connectors> <connector> <plugType>IEC_62196_Type_3_Outlet</plugType> <ratedPower>22</ratedPower> <currentType>AC3</currentType> </connector> </connectors> <locations> <lp:pointLocation> <p:latitude>50.73689</p:latitude> <p:longitude>7.10676</p:longitude> </lp:pointLocation> </locations> </chargingPoint> <chargingPoint> <uuid>7260f725-04ea-38a4-0000-00090af7026d</uuid> <externalId>anExternalId-A_1b</externalId> <name>Connector B</name> <connectors> <connector> <plugType>Combo_to_IEC_62196_Type_2_Base</plugType> <ratedPower>50</ratedPower> <voltageRange>V_50_500</voltageRange> <current>125</current> <currentType>DC</currentType> </connector> <connector> <plugType>Combo_to_IEC_62196_Type_2_Base</plugType> <ratedPower>50</ratedPower> <voltageRange>V_50_500</voltageRange> <current>125</current> <currentType>DC</currentType> </connector> </connectors> </chargingPoint> <chargingPoint> <uuid>1232abdf-6ef7-4310-81b5-e7e4be3786f3</uuid> <externalId>anExternalId-A_2a</externalId> <name>Connector C</name> <connectors> <connector> <plugType>Unspecified</plugType> </connector> </connectors> <locations> <lp:pointLocation> <p:latitude>50.73689</p:latitude> <p:longitude>7.10678</p:longitude> </lp:pointLocation> </locations> </chargingPoint> </chargingPoints> </chargingStation> <!-- Can contain more --> </chargingStations> </chargingPark> </chargingParks>
Usage and Freshness
By nature of this static feed, there is infrequent changes in the provided content. It is reasonable to expect update requests of approximately once per day. Using the support for If-None-Match or If-Modified-Since header fields, update request frequencies higher than once per day could be used to minimize the delay between updated information being available on the server and being received by the client.
Dynamic Feed
The dynamic feed for Germany
https://api.tomtom.com/electromobility/api/1.8/dynamic/de?key=<apiKey>
Example Response
The Dynamic Feed provides information for all known charging points in the requested country, referenced by UUID. The order of the stations is not specified.
<?xml version="1.0" encoding="UTF-8"?> <chargingParksDynamic xmlns="http://www.tomtom.com/service/tis/chargingstation/dynamic/1.8" xmlns:meta="http://www.tomtom.com/service/tis/chargingstation/metadata/1.8" schemaVersion="1.8"> <meta:metaData> <meta:creatorUUID>0d96c37e-cfdf-4f50-a1bc-5a05044ecbd4</meta:creatorUUID> <meta:creationTimeUTC>2020-02-11T13:07:47</meta:creationTimeUTC> </meta:metaData> <chargingStationUpdate> <referenceUuid>798c93fc-ba74-102b-b5ef-00304891a58c</referenceUuid> <chargingPointUpdates> <chargingPointUpdate> <referenceUuid>7260f725-04ea-38a4-0000-00090af7026d</referenceUuid> <status>Available</status> </chargingPointUpdate> <chargingPointUpdate> <referenceUuid>2823a471-1d57-311f-0000-00090af7026d</referenceUuid> <status>Occupied</status> </chargingPointUpdate> </chargingPointUpdates> <!-- Can contain more --> </chargingStationUpdate> </chargingParksDynamic>
Usage and Freshness
Updates are provided regularly; typically at a rate of once per minute. Using the support for If-None-Match or If-Modified-Since header fields, any update request frequencies higher than once-per-minute can be used to minimize the delay between updated information being available in the server and being received by the client.