---
title: "The Route Range API creates a polygon that depicts the area reachable from a given location within a certain threshold based on the specified time or distance budget."
method: POST
path: "/route/range"
---

# The Route Range API creates a polygon that depicts the area reachable from a given location within a certain threshold based on the specified time or distance budget.

`POST /route/range`

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 spatial filtering to search for features of interest within the provided Isochrone.



For information about routing availability in countries/regions, see [Azure Maps routing coverage](https://learn.microsoft.com/azure/azure-maps/routing-coverage?pivots=route-v2).

>[!Important]
>By using this feature, you agree to the preview legal terms. See the [Preview Supplemental Terms](https://azure.microsoft.com/en-us/support/legal/preview-supplemental-terms/) for additional details.

## Query parameters

- `api-version` string, required

## Parameters

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

## Response `200`

OK

- RouteRangeResponse — This object is returned from a successful call.
  - `type` 'FeatureCollection' — Specifies the `GeoJSON` type. The only supported object type is `FeatureCollection`. For more information, see [RFC 7946](https://www.rfc-editor.org/rfc/rfc7946).
  - `features` RouteRangeFeaturesItem[] — `GeoJSON` feature object that contains Geometry object and additional properties. Refer to [RFC 7946, Section 3.2](https://www.rfc-editor.org/rfc/rfc7946#section-3.2) for details.
    - `type` 'Feature' — Specifies the `GeoJSON` type. The only supported object type is Feature. For more information, see [RFC 7946](https://www.rfc-editor.org/rfc/rfc7946).
    - `geometry` RouteRangeGeometry — A valid `GeoJSON` Geometry object. Please refer to [RFC 7946](https://www.rfc-editor.org/rfc/rfc7946) for details.
      - `type` string, required — Specifies the geometry type for the `GeoJSON` Geometry object. Refer to [RFC 7946](https://www.rfc-editor.org/rfc/rfc7946) for details.
    - `bbox` number[] — A rectangular area on the earth defined as a bounding box object. The sides of the rectangles are defined by latitude and longitude values. For more information, see [RFC 7946, Section 5](https://www.rfc-editor.org/rfc/rfc7946#section-5). Example: "bbox": [-10.0, -10.0, 10.0, 10.0]
    - `properties` RouteRangeFeatureProperties — Route Ranges properties.
      - `type` 'center' | 'boundary' — The feature types for the feature objects returned in the response.

## Other responses

- `default` — An unexpected error occurred.

## Changes

- **2026-07-13** (1.0) `7677b00a7f5a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/maps-route/changes/route/range/post.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/7677b00a7f5a/schema)
