Long Distance EV Routing

Important note Long Distance EV Routing is unavailable on a Freemium or Pay As You Grow (PAYG) basis. Click the Request Access button above to contact our Sales team.

Long Distance EV Routing calculates routes for electric vehicles on extended journeys. When you provide an electric vehicle configuration with charging preferences, the calculateRoute method automatically calculates energy consumption, determines optimal charging stop locations, estimates charging time at each stop, and returns an extended route with additional legs for each charging stop.

Activation

Long Distance EV Routing is activated when you provide:

vehicle.preferences.chargingPreferences – Minimum charge at destination/stops

Additionally, these vehicle model parameters become required:

vehicle.model.engine.charging.batteryCurve – Battery charging characteristics
vehicle.model.engine.charging.chargingConnectors – Supported charging connectors

See Vehicle Configuration for the full EV configuration details.

Response Structure

See Route Object for the base route structure details.

Routes with charging stops contain additional information:

Route Summary:

totalChargingTimeInSeconds – Total time spent charging (sum of all stops)
remainingChargeAtArrivalInPCT – Battery level (in % of maxChargeKWH) when arriving at destination
remainingChargeAtArrivalInkWh – Battery level (in kWh) when arriving at destination

Each Leg Summary:

remainingChargeAtArrivalInPCT – Battery level (in % of maxChargeKWH) at end of this leg
remainingChargeAtArrivalInkWh – Battery level (in kWh) at end of this leg

Charging Stop Leg Summary:

chargingInformationAtEndOfLeg – Details about the charging stop (if leg ends at one):
- chargePointOperator – Operator of the charging station name and ID
- chargingConnectionInfo – Connector type, power, voltage, current
- chargingParkExternalId – Unique ID of the charging park
- chargingParkName – Name of the charging park
- chargingParkOpeningHours – Flag indicating 24/7 operation and time zone offset
- chargingParkOperatorName – Name of the charging park operator
- chargingParkPowerInkW – Maximum power of the charging park
- chargingParkSpeed – Speed category of the charging park (slow, regular, fast, ultra-fast)
- chargingParkUuid – UUID of the charging park
- chargingStopType – Type of charging stop (‘Auto_Generated’ or ‘User_Defined’)
- chargingTimeInSeconds – Time required to charge to target level
- targetChargeInPCT – Target battery level (in % of maxChargeKWH) after charging
- targetChargeInkWh – Target battery level (in kWh) after charging

Example

1
import { calculateRoute } from '@tomtom-org/maps-sdk/services';
2

3
const result = await calculateRoute({
4
    locations: [
5
        [4.9041, 52.3676],  // Amsterdam
6
        [13.4050, 52.5200]  // Berlin (long distance)
7
    ],
8
    vehicle: {
9
        engineType: 'electric',
10
        model: {
11
            engine: {
12
                charging: {
13
                    maxChargeKWH: 75,
14
                    batteryCurve: [
15
                        { stateOfChargeInkWh: 50, maxPowerInkW: 200 },
16
                        { stateOfChargeInkWh: 70, maxPowerInkW: 100 },
17
                        { stateOfChargeInkWh: 80, maxPowerInkW: 40 },
18
                    ],
19
                    chargingConnectors: [
20
                        {
21
                            currentType: 'DC',
22
                            plugTypes: ['Combo_to_IEC_62196_Type_2_Base'],
23
                            efficiency: 0.9,
24
                            maxPowerInkW: 150
25
                        }
26
                    ]
27
                },
28
                consumption: {
29
                    speedsToConsumptionsKWH: [
30
                        { speedKMH: 50, consumptionUnitsPer100KM: 15 },
31
                        { speedKMH: 90, consumptionUnitsPer100KM: 18 },
32
                        { speedKMH: 120, consumptionUnitsPer100KM: 23 }
33
                    ]
34
                }
35
            }
36
        },
37
        state: {
38
            currentChargePCT: 80
39
        },
40
        preferences: {
41
            chargingPreferences: {
42
                minChargeAtDestinationPCT: 20,
43
                minChargeAtChargingStopsPCT: 10
44
            }
45
        }
46
    }
47
});
48

49
// Route now contains charging stops
50
console.log(`Total legs: ${result.features[0].properties.sections.leg.length}`);
51
console.log(`Total charging time: ${result.features[0].properties.summary.totalChargingTimeInSeconds}s`);

Unsupported options

costModel.routeType – only ‘fast’ is supported (default)

API Reference

CalculateRouteParams – Route calculation parameters
VehicleParameters – Vehicle configuration
ChargingStop – Charging stop details
Long Distance EV Routing API – API documentation

Route Planning Parameters – All routing options
Vehicle Configuration – Complete guide to EV parameters
Route Object – Understanding route structure