Schemas

A four-digit number starting with 50 that says exactly why the request was refused. It is an addition, so a client that reads only error is unaffected.

Retry on the status; read the code to explain. Several refusals share a status. The status tells your code whether to retry; the code tells you what to tell your user. New codes starting with 50 may be added.

A [longitude, latitude] pair, in that order.

The points the matrix is computed over. At least two.

Indices into locations to use as sources. Leave it out, or send ["all"], to use every location. Cost is |sources| × |destinations|.

Indices into locations to use as destinations. Leave it out, or send ["all"], to use every location. Cost is |sources| × |destinations|.

Which matrices to return. Defaults to durations only.

Return the name of the nearest road for each snapped point.

Units for the distance matrix. Durations are always seconds.

An arbitrary identifier echoed back in the response metadata.

Travel times in seconds, as rows of sources by columns of destinations. A null entry means no route was found between that pair.

Distances, present only when requested via metrics.

Details about the request and the data behind the answer, plus element_count.

A [longitude, latitude] pair, in that order.

Meters from the requested point to the road it was snapped to.

Road name, present only when resolve_locations was set.

The waypoints, in order, starting at the origin.

Language for turn instructions.

Include turn-by-turn instructions. Default true.

Include the route geometry. Default true.

Request alternative routes.

Advanced routing options such as avoid_features or avoid_polygons.

Note: requests with options are much slower to compute, and have a much lower limit on route distance.

Details about the request and the data behind the answer, plus element_count.

The centers of the isochrones.

The ranges to compute, in seconds or meters depending on range_type. There's a maximum; going over it returns 400 (code 3004), and the message names the limit.

Whether range is seconds or meters. Default time.

Produce intermediate bands at this step within each range.

Whether the locations are origins (start, the default) or destinations — the difference matters on one-way roads.

Details about the request and the data behind the answer, plus element_count.

Required by license. The Open Database License requires this credit to stay with the data.

Milliseconds since the Unix epoch.

The request, echoed back.

Added by this service. How many elements this call was charged. Free calls and failed calls are never charged.