The reachable range parameters, one for each area to calculate.
Optionaloptions: { signal?: AbortSignal }
Optionalsignal?: AbortSignalAn AbortSignal to cancel the in-flight request and skip the remaining ones.
It is composed with any per-entry signal, so either one cancels.
A FeatureCollection with a polygon per range the service could calculate, in request order.
Private Preview. It needs the same API key access as calculateReachableRange.
Use it to compare the service areas of different store locations, create 15/30/45 minute drive time rings from one origin, compare ranges for different vehicle types or times of day, or find optimal facility locations with minimal overlap.
Note that ranges are calculated sequentially to avoid rate limiting. For large batches, consider implementing your own parallel processing with appropriate throttling.
A range the service answers with a 4xx error is skipped, not thrown, unless that error is a 401,
403, 404 or 429. An origin off the road network, such as a point at sea, answers a 400
MAP_MATCHING_FAILURE, which calculateReachableRange rejects with. So features can be shorter
than paramsArray, or empty, and each feature's properties carries the request it answers. A 5xx, a
network failure, an abort and a request the SDK's validation rejects still reject the whole batch.
// Calculate concentric drive time rings (15, 30, 45 minutes)
const timeRings = await calculateReachableRanges([
{ origin: [4.9, 52.3], budget: { type: 'timeMinutes', value: 15 } },
{ origin: [4.9, 52.3], budget: { type: 'timeMinutes', value: 30 } },
{ origin: [4.9, 52.3], budget: { type: 'timeMinutes', value: 45 } }
]);
// Compare service areas of multiple stores
const storeRanges = await calculateReachableRanges([
{ origin: [4.9, 52.3], budget: { type: 'timeMinutes', value: 30 } },
{ origin: [4.5, 51.9], budget: { type: 'timeMinutes', value: 30 } },
{ origin: [5.1, 52.1], budget: { type: 'timeMinutes', value: 30 } }
]);
Calculates multiple reachable range areas from different origins or with different constraints.
It computes several isochrone polygons in sequence. Use it to compare ranges from multiple locations, visualise multiple time/distance rings from the same origin, or analyse different vehicle scenarios.