---
title: "Use to create a map that depicts the area accessible from a given point within a certain threshold based on time, distance or fuel capacity."
method: GET
path: "/route/range/{format}"
---

# Use to create a map that depicts the area accessible from a given point within a certain threshold based on time, distance or fuel capacity.

`GET /route/range/{format}`

> [!NOTE]
>
> **Azure Maps Route v1 service retirement**
>
> The Azure Maps [Route v1](/rest/api/maps/route?view=rest-maps-1.0) service is now deprecated and will be retired on 3/31/28. To avoid service disruptions, all calls to Route v1 service will need to be updated to use [Route v2025-01-01](/rest/api/maps/route) service by 3/31/28. For more information, see [Migrate Azure Maps Route 1.0 APIs](/azure/azure-maps/migrate-route-v1-api).

The `Get Route Range` (Isochrone) API is an HTTP `GET` request that will calculate a set of locations that can be reached from the origin point based on fuel, energy, time or distance budget that is specified. A polygon boundary (or Isochrone) is returned in a counterclockwise  orientation as well as the precise polygon center which was the result of the origin point.

The returned polygon can be used for further processing such as  [Search Inside Geometry](/rest/api/maps/search/post-search-inside-geometry) to  search for POIs within the provided isochrone.

## Query parameters

- `api-version` string, required
- `query` number[], required
- `fuelBudgetInLiters` number, double
- `energyBudgetInkWh` number, double
- `timeBudgetInSec` number, double
- `distanceBudgetInMeters` number, double
- `departAt` string, date-time
- `routeType` 'fastest' | 'shortest' | 'eco' | 'thrilling'
- `traffic` boolean
- `avoid` string[]
- `travelMode` 'car' | 'truck' | 'taxi' | 'bus' | 'van' | 'motorcycle'
- `hilliness` 'low' | 'normal' | 'high'
- `windingness` 'low' | 'normal' | 'high'
- `vehicleAxleWeight` integer
- `vehicleWidth` number, double
- `vehicleHeight` number, double
- `vehicleLength` number, double
- `vehicleMaxSpeed` integer
- `vehicleWeight` integer
- `vehicleCommercial` boolean
- `vehicleLoadType` 'USHazmatClass1' | 'USHazmatClass2' | 'USHazmatClass3' | 'USHazmatClass4' | 'USHazmatClass5' | 'USHazmatClass6' | 'USHazmatClass7' | 'USHazmatClass8' | 'USHazmatClass9' | 'otherHazmatExplosive' | 'otherHazmatGeneral' | 'otherHazmatHarmfulToWater'
- `vehicleEngineType` 'combustion' | 'electric'
- `constantSpeedConsumptionInLitersPerHundredkm` string
- `currentFuelInLiters` number, double
- `auxiliaryPowerInLitersPerHour` number, double
- `fuelEnergyDensityInMJoulesPerLiter` number, double
- `accelerationEfficiency` number, double
- `decelerationEfficiency` number, double
- `uphillEfficiency` number, double
- `downhillEfficiency` number, double
- `constantSpeedConsumptionInkWhPerHundredkm` string
- `currentChargeInkWh` number, double
- `maxChargeInkWh` number, double
- `auxiliaryPowerInkW` number, double

## Parameters

- `../../../Common/preview/1.0/common.json#/components/parameters/ClientId` — unresolved $ref
- `../../../Common/preview/1.0/common.json#/components/parameters/ResponseFormat` — unresolved $ref

## Response `200`

OK

- RouteRangeResult — This object is returned from a successful Route Reachable Range call
  - `formatVersion` string — Format Version property
  - `reachableRange` RouteRange — Reachable Range
    - `center` LatLongPair — unresolved $ref
    - `boundary` LatLongPair[] — Polygon boundary of the reachable range represented as a list of points. — unresolved $ref
  - `report` RouteReport — Reports the effective settings used in the current call.
    - `effectiveSettings` EffectiveSetting[] — Effective parameters or data used when calling this Route API.
      - `key` string — Name of the parameter used.
      - `value` string — Value of the parameter used.

## Other responses

- `default` — unresolved $ref

## Changes

- **2026-07-13** (1.0) `03ff5298fed3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/maps-route/changes/route/range/:format/get.md)

---

[API](https://skmtc.dev/azure/apis/maps-route.md) · [All operations](https://skmtc.dev/azure/apis/maps-route/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/maps-route/revisions/03ff5298fed3/schema)