POST /geo/isochrone
Compute a reachable area
The areas reachable from a place within 1 to 4 times (minutes) or distances (meters). Served when its price is configured; otherwise 404. Scope `geo:route`. Billed per request from the prepaid balance; the answer carries a `receipt`. Auth: a secret key (`Authorization: Bearer gln_…`) from a server, or a browser key (`gln_pk_…`, in `?key=` or the Bearer header) from a page whose origin is declared on the key. A secret key sent with an `Origin` header, or in the URL, is refused (403 `secret_key_in_browser`, `secret_key_in_url`).
API key (Bearer), on the public API endpoint.
Request body
application/json · schema GeoIsochroneRequest
| Field | Type | Description |
|---|---|---|
profile | "driving" | "walking" | "cycling" | "two_wheeler" | Travel mode (default driving). |
center | GeoPlace · required | A place: [lon, lat] (GeoJSON order), {"lat", "lon"}, or a string. A string that follows the GPS grammar ("5.3364, -4.0267", "5.3364 N, 4.0267 W", degrees-minutes-seconds) is read as coordinates; any other string is an address, geocoded and billed as one geocode. |
minutes | array<integer> | 1 to 4 increasing times, 1 to 60. |
meters | array<integer> | 1 to 4 increasing distances, 100 to 50,000. |
Responses
| Status | Description | Body |
|---|---|---|
200 | FeatureCollection of polygons, smallest first, centre, attribution and receipt | GeoFeatureCollection |
422 | geo_query_invalid, geo_coordinates_out_of_range, geo_address_not_found | Error |
401 | api_key_missing, api_key_invalid, api_key_revoked, api_key_ambiguous | Error |
402 | geo_balance_exhausted: the prepaid balance is used up | Error |
403 | scope_missing, secret_key_in_browser, secret_key_in_url, browser_key_origin_required, browser_key_origin_not_allowed, geo_test_adapter_live_refused | Error |
404 | not_found: Geo, or this operation, is not served to this account | Error |
429 | geo_rate_limited, geo_monthly_cap_reached, browser_key_daily_cap_reached (Retry-After) | Error |
503 | geo_unavailable, geo_operation_unavailable, platform_unavailable | Error |
504 | geo_upstream_timeout: retry | Error |
Examples
curl
curl -X POST "$GALON_API_BASE/geo/isochrone" \
-H "Authorization: Bearer $GALON_API_KEY" \
-H "Content-Type: application/json" \
-d '{"center": [1]}'