gmapRoutes
Routes between two or more points by car, bike or foot, with GeoJSON geometry and instructions.
DocsGMap Cloud · Routing
Routing, distance matrix and isochrone API
Calculate routes, order delivery stops and estimate travel times for delivery, dispatch and site selection. Times are estimates from the routing model.
Key capabilities
API example
Driving time–distance matrix (Hanoi)
curl 'https://cloud.gmap.vn/api/tsp/route/sources_to_targets' \
--header 'x-api-key: public-gmap-cloud-x-api-key-demo' \
--header 'content-type: application/json' \
--data '{
"sources": [{ "lat": 21.0285, "lon": 105.8542 }],
"targets": [{ "lat": 21.015, "lon": 105.847 }, { "lat": 21.045, "lon": 105.82 }],
"costing": "auto"
}'{
"units": "kilometers",
"sources_to_targets": [[
{ "from_index": 0, "to_index": 0, "distance": 2.733, "time": 302 },
{ "from_index": 0, "to_index": 1, "distance": 6.083, "time": 550 }
]]
}Public demo response on 11 October 2026; time is in seconds, distance in the returned units. Live traffic is not included.
Common uses
Multi-stop delivery
Order drops and estimate completion time for each trip.
Nearest assignment
Use a matrix to choose the warehouse, store or staff member with the shortest travel time.
Service-area analysis
Draw 15–30 minute areas around stores to evaluate new locations.
Related guides
- Pick the nearest warehouse with a time–distance matrixOne API call returns travel time and distance from several warehouses to a delivery point; pick the fastest in a few lines of JavaScript.
- Map a 15-minute delivery area around a storeUse the isochrone API to get the area reachable within 15 or 30 minutes of a store and shade it on a MapLibre map, for delivery pricing and site selection.
Frequently asked questions
Do travel times include live traffic?
Times are estimates from the routing model and travel mode. Live traffic data is not included in results.
Which travel modes are supported?
Basic routing supports car, bike and foot. Advanced APIs (matrix, isochrone, optimisation) take a costing parameter such as auto.
Can I try it first?
Yes. The API documentation has runnable examples for each endpoint using the public demo key.