Routing

Generate reachability polygons (isochrones)

Travel-time or travel-distance reachability polygons from an origin. Returns a GeoJSON FeatureCollection of nested Polygon contours — one per requested band. Largest natural latency budget on the API (p95 ≤500ms cache miss).

get/v1/isochrone

Request

  • Base URL: https://geo.thinair.co
  • URL: https://geo.thinair.co/v1/isochrone
  • Auth: HTTP bearer

Query parameters

locationstring

Origin — free-text address or 'lat,lon' string.

Example:Houston, TX
latnumber

Origin latitude (paired with lon; alternative to location).

Example:29.7604
lonnumber

Origin longitude (paired with lat; alternative to location).

Example:-95.3698
contours_minutesnumber[]

Time bands in minutes; repeatable or CSV. Each value 1..120. Max 4 bands per call.

[
  10,
  20,
  30
]
contours_kmnumber[]

Distance bands in km; repeatable or CSV. Each value 1..200. Max 4 bands per call.

[
  5,
  10,
  20
]
costing'auto' | 'truck' | 'bicycle' | 'pedestrian'

Travel mode (default: auto).

presetstring

Route preset name (overrides costing + truck params).

Example:long_haul
truck_heightnumber

Truck height in meters.

Example:4.1
truck_weightnumber

Truck weight in metric tons.

Example:36
hazmatboolean

Hazmat-restricted routing flag.

Response

Isochrone polygons + metadata. Service returns 200 with upstream_error populated on routing-engine failures.

costingstring required
presetstring
preset_notestring
costing_optionsobject
contour_valuesnumber[] required
metricstring required
upstream_errorstring nullable

Example response

{
  "origin": {
    "lat": 29.7604,
    "lon": -95.3698
  },
  "structured_error": {
    "code": "radius_exceeds_max"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.