---
title: "POST /route/range"
method: POST
path: "/route/range"
---

# POST /route/range

`POST /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. 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=latest).

## Query parameters

- `api-version` string, required

## Headers

- `x-ms-client-id` string

## Response `200`

The request has succeeded.

- 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` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon' | 'GeometryCollection' | 'Feature' | 'FeatureCollection', required — Specifies the `GeoJSON` type. Must be one of the nine valid GeoJSON object types - Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature and FeatureCollection.
    - `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 response.

---

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