Reachable range parameters including origin and budget constraints
Promise resolving to a polygon representing the reachable area
Private Preview: needs an API key with Calculate Reachable Range access, unavailable on a Freemium or Pay As You Grow (PAYG) basis: request it from TomTom Sales.
Key features:
Common use cases:
// Calculate 30-minute drive time range
const range30min = await calculateReachableRange({
origin: [4.9041, 52.3676], // Amsterdam
budget: { type: 'timeMinutes', value: 30 }
});
// EV range down to 20% remaining battery
const evRange = await calculateReachableRange({
origin: [4.9041, 52.3676],
budget: { type: 'remainingChargePCT', value: 20 },
vehicle: {
engineType: 'electric',
model: {
engine: {
consumption: {
speedsToConsumptionsKWH: [
{ speedKMH: 50, consumptionUnitsPer100KM: 8 },
{ speedKMH: 80, consumptionUnitsPer100KM: 12 }
]
},
charging: { maxChargeKWH: 60 }
}
},
state: { currentChargePCT: 80 }
}
});
// Traffic-aware range at departure time
const morningRange = await calculateReachableRange({
origin: [4.9041, 52.3676],
budget: { type: 'timeMinutes', value: 45 },
when: { option: 'departAt', date: new Date('2025-10-20T08:00:00Z') } // Rush hour
});
Calculate the area reachable from a starting point within given constraints.
The Reachable Range service (also known as isochrone) computes a polygon representing all locations that can be reached from an origin within specified limits of time, distance, or energy consumption. This is essential for range analysis, service area visualization, and logistics planning.