Single Route

POST/routing/single

Calculate the route geometry, distance, and duration for a sequence of coordinates. This endpoint returns the optimal driving route through the provided stops in order.

Request Body

Field	Type	Required	Description
`stops`	Coordinates[]	Yes	Ordered sequence of stops
`departure`	ISO8601	No	Departure time for traffic calculation

Coordinates

Field	Type	Required	Description
`lat`	number	Yes	Latitude
`lng`	number	Yes	Longitude

{ "lat": 40.7128, "lng": -74.0060 }

Example Response

{
  "geometry": "encoded_polyline_string",
  "distance": 8500,
  "duration": 1200,
  "legs": [
    { "distance": 5000, "duration": 720 },
    { "distance": 3500, "duration": 480 }
  ]
}

Response Fields

Field	Type	Description
`geometry`	string	Encoded polyline of the route
`distance`	number	Total distance in meters
`duration`	number	Total duration in seconds
`legs`	RouteLeg[]	Per-segment details

Route Leg

Each leg represents the segment between consecutive stops:

Field	Type	Description
`distance`	number	Segment distance in meters
`duration`	number	Segment duration in seconds

Use Cases

Route Preview: Show the route before committing to a trip
Manual Route Planning: Calculate routes for custom stop sequences
ETA Calculation: Get accurate travel times between locations
Route Comparison: Compare different stop orderings