Schemas

Language for narrative directions.

Machine-readable error code, e.g. quota_exhausted.

Human-readable explanation.

Hex color without leading hash.

GeoJSON geometry — Polygon or LineString depending on the polygons flag.

One contour per reachable-area band. The product len(locations) × len(contours) must not exceed 4.

Routing profile. auto (car), bicycle, or pedestrian (foot).

Return polygons instead of GeoJSON LineStrings.

Distance in the requested units. null if the pair is unreachable.

Travel time in seconds. null if the pair is unreachable.

Routing profile. auto (car), bicycle, or pedestrian (foot).

Geographic metadata for a place. Optional fields are omitted when the underlying record doesn't carry them — e.g. a country-level result has no street.

Fixed string "Feature".

ISO 3166-1 alpha-2 country code.

Display name of the place.

What kind of place this is — street, house, locality, city, district, region, country, etc.

[lon, lat].

Fixed string "Point".

Encoded polyline at 1e-6 precision (the standard Google polyline algorithm with 6 decimals instead of 5). Decoders are available for every major language — in JavaScript, @mapbox/polyline with the precision set to 6 returns [lat, lon] pairs.

Routing profile. auto (car), bicycle, or pedestrian (foot).

Two or more ordered waypoints. The first is the origin, the last is the destination.

Total length in the requested units.

Total travel time in seconds.

Unix timestamp (seconds) when the signature expires.

Signed URL ready to feed to MapLibre's pmtiles:// protocol handler.