Connectors tutorial
Connectors guide
A connector is an interface between an electric vehicle and the charging infrastructure. Connectors ensure physical compatibility and electrical safety enabling energy transfer at the correct voltage and current levels. Different connector types (for example, Type 2, CCS, NACS) support varying charging speeds and standards from slow AC charging to ultra-fast DC charging. Accurate connector information is essential for interoperability, route planning, and user experience — EV drivers need to know which chargers match their vehicle’s connector type to avoid failed charging attempts. You can deliver reliable EV services and seamless integration with APIs and routing systems by modeling connector attributes (type, power, availability).
In OCPI 2, connectors act as the smallest billable and operational unit within a location, linked to Electrical Vehicle Supply Equipments (EVSEs). Each connector includes detailed attributes such as standard, format, power type, and maximum capacity, ensuring consistent interoperability across platforms enabling precise pricing and availability information.
Connector details in HERE EV Charge Points API v3 and HERE Map Content
The EVSE contains connector attributes → connectors array. For details, see HERE EV Charge Points API v3 API reference.
In HERE Map Content (HMC), connector details are available under the pooled EVSE structure. For details, see HMC EV layer schema.
A connector group collates all the connectors of the location level presenting connector type, maximum power and number of connectors.
Example of a connector group in EV Charge Points API v3.
"connectorGroups": [
{
"standard": "CHADEMO",
"maxPower": 100000,
"connectorCount": 4
},
{
"standard": "IEC_62196_T1_COMBO",
"maxPower": 100000,
"connectorCount": 2
},
{
"standard": "IEC_62196_T1_COMBO",
"maxPower": 350000,
"connectorCount": 2
}
]Filter the HERE EV Charge Points API v3 results
The HERE EV Charge Points API v3 supports filtering that allows receiving only the requested connectors for charging locations in the API request by using the connectorTypes query parameter. For details, see HERE EV Charge Points API v3 API reference.
Use the countryMetadata endpoint to view available connector types by country.
See How to get one or multiple charging locations to learn more about the HERE EV Charge Points API v3
locations.
The following command uses cURL syntax, queries the EV data for the locations ids: [246udbvy497hq-aGVyZS1ldjplY29tb3ZlbWVudDoyMDEyMTg1ODgz, 246udbvy413fw-aGVyZS1ldjplY29tb3ZlbWVudDoyMDEyNDI4MTEx], and filters the data so the response includes connectors information only for types IEC_62196_T2_COMBO and IEC_62196_T2. Adding | jq to your request formats the response with jq:
curl -H "Authorization: Bearer $ACCESS_TOKEN" "https://evcp.hereapi.com/v3/locations?ids=246udbvy497hq-aGVyZS1ldjplY29tb3ZlbWVudDoyMDEyMTg1ODgz,246udbvy413fw-aGVyZS1ldjplY29tb3ZlbWVudDoyMDEyNDI4MTEx&fields=address,evses&connectorTypes=IEC_62196_T2_COMBO,IEC_62196_T2" | jqThis reduces the payload size and eliminates irrelevant information, excluding locations without any EVSEs matching the requested connector types.
Filtering can be used only when querying with multiple IDs.
Get and use connector IDs in the HERE Geocoding and Search API v7
Connector IDs are required when filtering EV charging stations in the HERE Geocoding and Search API v7. This section shows where to retrieve these IDs and how to apply them in search requests.
The legacy connector names and IDs mapping table is available in the migration guide.
Step 1: Retrieve connector IDs from the metadata endpoint
Connector IDs are provided by the EV Charge Points v3 metadata endpoint. This endpoint returns the list of supported connector types by country, including their numeric IDs.
Use the metadata endpoint to:
- Discover available connector types per country
- Map connector IDs to human-readable names
Important
These connector IDs are legacy HERE identifiers. They are used for filtering in the HERE Search API and EV Charge Points API v2 only. They are not part of the EVCP API v3 connector model, which uses a different (OCPI-aligned) representation.
Step 2: Use connector IDs in the Search API
Once you have the connector IDs, you can use them to filter EV charging stations in Search queries.
Include the connector ID in the &evStation[connectorTypeIds] parameter:
GET https://search.hereapi.com/v1/discover
?q=charging
&at=52.5169972,13.3860851
&limit=20
&lang=en-US
&show=ev
&evStation[connectorTypeIds]=34
&apiKey=YOUR_API_KEYevStation[connectorTypeIds] filters results to stations that support the specified connector type ID.
You can specify multiple IDs:
&evStation[connectorTypeIds]=34,43This returns stations supporting any of the listed connector types.
Differentiate between Tesla Supercharger locations in HERE EV Charge Points API v3 and HMC
To differentiate between the Tesla Supercharger locations that are usable by Tesla electric vehicles only or by Tesla NACS partners, inspect the connector types. As a basic rule:
- Connector type
SAE_J3400⇒ NACS partner compatible - Connector type
TESLA_S⇒ Tesla exclusive
If you are using the HERE Geocoding and Search API v7 or legacy HERE EV Charge Points API v2,
SAE_J3400is the connector ID=43 andTESLA_Sis the connector ID=68.
In addition, there may be charging locations that have a SAE_J3400 connector but are still Tesla exclusive. Therefore, it's important to inspect the restrictionReason information as well. If the restrictionReason is BRAND_ONLY, the location is a Tesla exclusive charger. Read more about the topic from Tesla's website: Supercharging Other EVs.
If you use the legacy HERE EV Charge Points API v2, do not rely on the legacy
access_typeflag for the differentiation.access_type=Restrictedand "restrictions" aren't one-to-one. HERE EV Charge Points API v3 and HMC EV Layer follow a more precise approach.
Connector types
Further information see OCPI specification.
Connector Maximum Power
Each connector lists a maximum power value in Watts. This is based on its electrical specification, including voltage, current, and number of phases. It represents the theoretical upper limit for the connector, not a guarantee of charging speed.
Actual charging power depends on
Vehicle battery capability and charging curve
EVSE configuration
Site-level power sharing (dynamic load balancing)
Available power may vary during a session.
Note for developers: Display maximum power as an indicative value only. Use wording such as “Up to X kW” and clarify that actual charging power may be lower due to vehicle limits, EVSE settings, and power sharing.