# Isochrone

Get the areas reachable from a point within 1 to 3 travel times.

`GET /v2/isochrone`. Auth: API key, or a test map trial run.

## Parameters

| Parameter | Required | Description |
|---|---|---|
| `point` | Yes | `lng,lat` |
| `time_s` | Yes | 1 to 3 comma-separated values, each a multiple of 60 from 60 to 1800, strictly ascending |
| `profile` | No | `car` (default) or `car_night` |

This endpoint is expensive to compute, so ask for the fewest values you need.

## Example

```bash
curl -s -H "X-API-Key: $QUADRUPER_KEY" \
  'https://quadruper.com/v2/isochrone?point=122.5621,10.7202&profile=car&time_s=600,1200'
```

This is an example response. Real polygons have many more coordinates.

```json schema=isochrone-response
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": { "time_s": 600 },
      "geometry": { "type": "Polygon", "coordinates": [[[122.55, 10.71], [122.57, 10.71], [122.57, 10.73], [122.55, 10.71]]] }
    },
    {
      "type": "Feature",
      "properties": { "time_s": 1200 },
      "geometry": { "type": "MultiPolygon", "coordinates": [[[[122.54, 10.70], [122.58, 10.70], [122.58, 10.74], [122.54, 10.70]]]] }
    }
  ],
  "conditions": { "assessed": false, "reason": "not_configured" },
  "attribution": [{ "source": "osm", "text": "© OpenStreetMap contributors", "license": "ODbL-1.0" }]
}
```

## Response fields

The response is a GeoJSON `FeatureCollection`, with `conditions` and `attribution` as extra top-level members. It has one feature per `time_s` value, in ascending order. Each has a `Polygon` or `MultiPolygon` geometry and `properties.time_s`.

See [Map reachable areas](../guides/isochrones.md).