Obtain variants by make and model

After you selected a specific vehicle make and model, use the /makes/{makeId}/models/{modelId}/variants endpoint to retrieves all available variants for that combination. Each variant typically represents a different battery configuration (for example, 40/60/80 kWh options) and has its own unique profileId.

Prerequisites

Browse available manufacturers and save the selected manufacturer's id as {makeId}.
List models by make with that {makeId}, then save the selected model's id as {modelId}.

Use the {makeId} and {modelId} values together in the variants request. For example, use renault and kangooVanETechElectric to retrieve variants for the Renault Kangoo Van E-Tech Electric.

Understand the profileId parameter

The profileId is a crucial identifier used by the HERE Tour Planning API to map specific vehicle variants to their distinct performance profiles. This ID dictates essential characteristics such as efficiency curves, battery capacity, and recharging behavior for a particular model configuration. Selecting the correct variant (and thus the corresponding profileId) is vital; an incorrect selection can lead to inaccurate range estimations or suboptimal stop scheduling in tour plans.

Retrieve vehicle variants for a make and model combination

Get all variants for a specific make and model combination, as shown in the following example, which retrieves all available variants for the Renault (make) and Kangoo Van E-Tech Electric (model) combination:

Request example

curl "https://evprofiles.tourplanning.hereapi.com/v1/makes/renault/models/kangooVanETechElectric/variants?apiKey=YOUR_API_KEY"

Response

The following snippet shows the corresponding response, in the JSON format:

{
  "items": [
    {
      "profileId": "124",
      "power": 90,
      "unladenWeight": 0,
      "grossWeight": 2227,
      "range": 291,
      "width": 1919,
      "height": 1846,
      "lengthClasses": [
        {
          "class": "L1"
        }
      ],
      "weightClasses": null,
      "heightClasses": [
        {
          "class": "H1"
        }
      ],
      "bodyType": "Panel_Van",
      "versions": null,
      "releaseYear": 2022
    },
    {
      "profileId": "143",
      "power": 90,
      "unladenWeight": 0,
      "grossWeight": 2510,
      "range": 276,
      "width": 1919,
      "height": 1834,
      "lengthClasses": [
        {
          "class": "L2"
        }
      ],
      "weightClasses": null,
      "heightClasses": [
        {
          "class": "H1"
        }
      ],
      "bodyType": "Panel_Van",
      "versions": null,
      "releaseYear": 2022
    },
    {
      "profileId": "190",
      "power": 90,
      "unladenWeight": 1908,
      "grossWeight": 2580,
      "range": 261,
      "width": 1919,
      "height": 1834,
      "lengthClasses": [
        {
          "class": "L2"
        }
      ],
      "weightClasses": null,
      "heightClasses": [
        {
          "class": "H1"
        }
      ],
      "bodyType": "Doublecab",
      "versions": null,
      "releaseYear": 2024
    }
  ],
  "limit": 10,
  "count": 3
}

For full reference information about response parameters for the /makes/{makeId}/models/{modelId}/variants endpoint, see Understand EV Profiles API response format.

Next steps

Browse the list of vehicle variants and then select the profile that matches the vehicles in your EV fleet, saving the profileId value for use in Tour Planning API requests.

For example, if your Kangoo Van E-Tech Electric consists of the double cab variant designed for people transportation, select the variant with "profileId": "190".
Use the selected profileId when planning tours to accurately reflect the specific EV's capabilities in the Tour Planning API, ensuring more realistic and optimized routes for your EV fleet performance.

📘
Note
In the HERE Tour Planning API, use the ID as the evProfileId parameter value.

For a practical demonstration on how to create tours for EVs that include profileId for accurate power consumption and range estimation, see Plan efficient routes for EV fleets in the HERE Tour Planning API Developer Guide.