---
title: "Mapbox-compatible Isochrone (see module docs)."
method: GET
path: "/isochrone/v1/{user}/{profile}/{coordinates}"
tags: ["mapbox-compat"]
---

# Mapbox-compatible Isochrone (see module docs).

`GET /isochrone/v1/{user}/{profile}/{coordinates}`

## Request

- Base URL: `https://api.mapmap.ai`
- URL: `https://api.mapmap.ai/isochrone/v1/{user}/{profile}/{coordinates}`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `api_key`

## Path parameters

- `user` string, required
- `profile` string, required
- `coordinates` string, required

## Query parameters

- `access_token` string
- `contours_minutes` string
- `contours_meters` string
- `contours_colors` string
- `polygons` boolean
- `denoise` number, double
- `generalize` number, double
- `depart_at` string

## Response `200`

GeoJSON FeatureCollection; each feature's properties carry `contour`, `metric` and `color` (and `fill`/`fillColor` on polygons). Car contours are free-flowing times. Metered as `POST /isochrone`: one unit per contour

- object

## Other responses

- `400`: `{code, message}` for a malformed or unsupported option, not billed
- `401`: Missing or invalid key
- `404`: `ProfileNotFound`
- `422`: `{code, message}` when no road the profile can use lies within 5 km of the point (open sea, desert): no roads near this point. Not billed
- `429`: Quota or rate limit exceeded

---

[API](https://skmtc.dev/mapmap/apis/sn-gateway.md) · [All operations](https://skmtc.dev/mapmap/apis/sn-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/mapmap/apis/sn-gateway/revisions/2293be8b4c38?raw)