GuidesAPI ReferenceChangelog
Guides

API Changes

Added

  • Additional IDs on station, pool, evse, and connector levels

  • Format of “pool ID” follows the “station ID” format to ensure consistent IDs.

  • EV API endpoints /pool, /evses and /station have new ID values.

    ID valuesDescriptionEndpoint
    evStations.evStation.cpoIdLocation ID from CPO (Charge point owner)/stations
    pools.evStations.evStation.connectors.connector.connectorStatuses.connectorStatus.cpoEvseUIdEVSE ID on connector level from CPO (Charge point owner)/pools
    evStations.evStation.cpoIdLocation ID from CPO (Charge point owner)/stations
    pools.evStations.evStation.connectors.connector.connectorStatuses.connectorStatus.cpoEvseUIdEVSE ID on connector level from CPO (Charge point owner)/stations
    pools.evStations.evStation.connectors.connector.connectorStatuses.connectorStatus.cpoEvseIdEVSE ID on connector level in eMI3 format/pools
    pools.evStations.evStation.connectors.connector.connectorStatuses.connectorStatus.cpoEvseIdEVSE ID on connector level in eMI3 format/stations
    pools.evStations.evStation.connectors.connector.connectorStatuses.connectorStatus.physical_referenceEVSE reference printed on the EVSE/pools
    pools.evStations.evStation.connectors.connector.connectorStatuses.connectorStatus.physical_referenceEVSE reference printed on the EVSE/stations
    evses.pools.stations.cpoIdLocation ID from CPO (Charge point owner)/evses
    evses.pools.stations.evses.cpoEvseUIdEVSE ID from CPO (Charge point owner)/evses
    evses.pools.stations.evses.cpoIdEVSE ID in eMI3 format (re-mapped values)/evses
    evses.pools.stations.evses.physical_referenceEVSE reference printed on the EVSE/evses
  • Roaming attributes for the eMSP (e-Mobility Service Provider) offer different subscription types and cards ("subscription cards" in data) to charge your electric vehicle.

    Note: Please note that this feature does require an additional license.

    eMSP attributesDescription
    evStation.roamingNew set of attributes for eMSP information
    evStation.roaming.emspThe eMSP subscription or card provider name
    evStation.roaming.partner_idUnique and stable ID for the eMSP provided by HERE
    evStation.roaming.ema_idThe unique E-Mobility Account Identifier (eMA ID) for a provider. It is created by HERE's platform by combining the country code where the charging station is located, and the party id of the provider. For example, NL-ECO. NOTE: eMSP may have several ema_ids if they act in multiple countries.
    connector.supplierUIDThe unique id for a charge point operator (CPO). It is created by HERE's platform, and it is stable.
    connector.supplierEmaIDThe E-Mobility Account Identifier (eMA ID) for the charge point operator. It is created by by HERE's platform by combining the country code where the charging station is located, and the party id of the operator. For example, NL-ECO. NOTE: CPO may have several ema_ids if they act in multiple countries.

Changed

  • EV Data quality improved for freshness, data de-duplication, and coverage.
  • Improved the address quality with advanced geocoding. More accurate addresses contain detailed information such as house numbers. The original address from the CPO is available on “pools.evStations.evStation.address.unparsedAddress”. Improved geocoding for the routing points enhances the entrance location routing points accuracy.
  • Improved translations and transliterations for names, addresses, and labels

Removed

  • None