{"templateId":"markdown","versions":[{"version":"v1.0","label":"v1.0","link":"/guides/route/v1.0/route-navigation","default":false,"active":false,"folderId":"cbfd067c"},{"version":"latest","label":"Latest","link":"/guides/route/route-navigation","default":true,"active":true,"folderId":"cbfd067c"}],"sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Get a route","description":"Digime Map is the groundbreaking API that allows you to search places, navigate between points, highlight street attributes and raster tile.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"get-a-route","__idx":0},"children":["Get a route"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can get a route using the Routes API Compute Routes by sending an HTTP GET request to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["route"]}," method (REST)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example shows the URL of a REST request to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["route"]}," method:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://dplace-api.themap.world/maps/api/directions/json?option=value&option=value"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Include your request options in the query parameters."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-http-route-request","__idx":1},"children":["Example: HTTP route request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following code shows how to construct a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["route"]}," request. In this example, you set the source and destination locations and also specify:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["origin"]}," is place ID, address, or textual latitude/longitude value"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destination"]}," is place ID, address, or textual latitude/longitude value"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["waypoints"]}," is list of point along following leg"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mode"]}," for drive mode: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["driving"]}," (default), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["motorcycling"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bicycling"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["walking"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["alternatives"]}," is boolean or numeric"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \\\n--header 'Content-Type: application/json' \\\n'https://dplace-api.themap.world/maps/api/directions/json?origin=21.02593%2C105.846535&destination=21.021002%2C105.85399&waypoints=21.023544%2C105.848985&alternatives=true&mode=driving&key=YOUR_API_KEY'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-http-route-response-body","__idx":2},"children":["Example: HTTP route response body"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"geocoded_waypoints\": [\n        {\n            \"types\": [\n                \"entertainment_and_recreation\",\n                \"historical_landmark\"\n            ],\n            \"place_id\": \"4:venue:836a3e5047ce446d81cf9a70b4d888a2\",\n            \"partial_match\": false,\n            \"geocoder_status\": \"OK\"\n        },\n        {\n            \"types\": [\n                \"street_address\"\n            ],\n            \"place_id\": \"4:address:1534c20cbc5b427787c7f55987bba58f\",\n            \"partial_match\": false,\n            \"geocoder_status\": \"OK\"\n        },\n        {\n            \"types\": [\n                \"residential\",\n                \"residential\"\n            ],\n            \"place_id\": \"4:venue:20e5f1be670843acacdb50ec7c23bed9\",\n            \"partial_match\": false,\n            \"geocoder_status\": \"OK\"\n        }\n    ],\n    \"status\": \"OK\",\n    \"routes\": [\n        {\n            \"overview_polyline\": {\n                \"points\": \"ahibg@uoj{hEoA~CwCjOeCs@gCu@~Hw_@t@}DvDgVfAsIpAyFbDsOvAmHdAkF\\\\eBzT{fA~CgPrAmH~ItBtM`DdYvGvUvF|HhBzFtA|J`C\\\\Jxh@bN`GbBzD~@r\\\\fHzD~@nAwGhPk}@tBkKxBoKpAoFdAcEjRcaA^wBvIcc@xA}HgCa@k@IkRiCkIgAaLyA_[aEmV}CkGW|AqIhCkMhAyFlQo~@^iBx@gEpEhA|Ct@hOtDbm@fO\"\n            },\n            \"waypoint_order\": [\n                0,\n                1,\n                2\n            ],\n            \"warnings\": [],\n            \"summary\": \"Phố Quang Trung và Phố Ngô Quyền\",\n            \"copyrights\": \"Digime Map Data\",\n            \"legs\": [\n                {\n                    \"steps\": [\n                        {\n                            \"driving_side\": \"right\",\n                            \"transit_details\": null,\n                            \"steps\": null,\n                            \"polyline\": {\n                                \"points\": \"ahibg@uoj{hEoA~CwCjO\"\n                            },\n                            \"maneuver\": \"depart\",\n                            \"html_instruction\": \"Đi về hướng Tây bắc\",\n                            \"start_location\": {\n                                \"lng\": 105.846539,\n                                \"lat\": 21.025937\n                            },\n                            \"travel_mode\": \"DRIVING\",\n                            \"end_location\": {\n                                \"lng\": 105.846539,\n                                \"lat\": 21.025937\n                            },\n                            \"duration\": {\n                                \"value\": 15.4,\n                                \"text\": \"16s\"\n                            },\n                            \"distance\": {\n                                \"value\": 37.9,\n                                \"text\": \"38 m\"\n                            }\n                        },\n                        {\n                            \"driving_side\": \"right\",\n                            \"transit_details\": null,\n                            \"steps\": null,\n                            \"polyline\": {\n                                \"points\": \"ioibg@izi{hEeCs@gCu@\"\n                            },\n                            \"maneuver\": \"turn-right\",\n                            \"html_instruction\": \"Quẹo phải\",\n                            \"start_location\": {\n                                \"lng\": 105.846197,\n                                \"lat\": 21.026053\n                            },\n                            \"travel_mode\": \"DRIVING\",\n                            \"end_location\": {\n                                \"lng\": 105.846197,\n                                \"lat\": 21.026053\n                            },\n                            \"duration\": {\n                                \"value\": 7.3,\n                                \"text\": \"8s\"\n                            },\n                            \"distance\": {\n                                \"value\": 15.9,\n                                \"text\": \"16 m\"\n                            }\n                        },\n                        {\n                            \"driving_side\": \"right\",\n                            \"transit_details\": null,\n                            \"steps\": null,\n                            \"polyline\": {\n                                \"points\": \"wwibg@s}i{hE~Hw_@t@}DvDgVfAsIpAyFbDsOvAmHdAkF\\\\eBzT{fA~CgPrAmH\"\n                            },\n                            \"maneuver\": \"turn-right\",\n                            \"html_instruction\": \"Quẹo phải vào Phố Hai Bà Trưng\",\n                            \"start_location\": {\n                                \"lng\": 105.84625,\n                                \"lat\": 21.026188\n                            },\n                            \"travel_mode\": \"DRIVING\",\n                            \"end_location\": {\n                                \"lng\": 105.847411,\n                                \"lat\": 21.025873\n                            },\n                            \"duration\": {\n                                \"value\": 41.2,\n                                \"text\": \"42s\"\n                            },\n                            \"distance\": {\n                                \"value\": 375.5,\n                                \"text\": \"0.4 km\"\n                            }\n                        },\n                        {\n                            \"driving_side\": \"right\",\n                            \"transit_details\": null,\n                            \"steps\": null,\n                            \"polyline\": {\n                                \"points\": \"_ygbg@eup{hE~ItBtM`DdYvGvUvF|HhBzFtA|J`C\\\\J\"\n                            },\n                            \"maneuver\": \"turn-right\",\n                            \"html_instruction\": \"Quẹo phải vào Phố Quang Trung\",\n                            \"start_location\": {\n                                \"lng\": 105.849699,\n                                \"lat\": 21.025184\n                            },\n                            \"travel_mode\": \"DRIVING\",\n                            \"end_location\": {\n                                \"lng\": 105.849199,\n                                \"lat\": 21.023705\n                            },\n                            \"duration\": {\n                                \"value\": 25.2,\n                                \"text\": \"26s\"\n                            },\n                            \"distance\": {\n                                \"value\": 195.8,\n                                \"text\": \"0.2 km\"\n                            }\n                        },\n                        {\n                            \"driving_side\": \"right\",\n                            \"transit_details\": null,\n                            \"steps\": null,\n                            \"polyline\": {\n                                \"points\": \"uodbg@oqo{hE\"\n                            },\n                            \"maneuver\": \"arrive-right\",\n                            \"html_instruction\": \"Đến nơi ở bên phải\",\n                            \"start_location\": {\n                                \"lng\": 105.849128,\n                                \"lat\": 21.023499\n                            },\n                            \"travel_mode\": \"DRIVING\",\n                            \"end_location\": {\n                                \"lng\": 105.849128,\n                                \"lat\": 21.023499\n                            },\n                            \"duration\": {\n                                \"value\": 0,\n                                \"text\": \"0s\"\n                            },\n                            \"distance\": {\n                                \"value\": 0,\n                                \"text\": \"0 m\"\n                            }\n                        }\n                    ],\n                    \"end_location\": {\n                        \"lng\": 105.849128,\n                        \"lat\": 21.023499\n                    },\n                    \"start_location\": {\n                        \"lng\": 105.846539,\n                        \"lat\": 21.025937\n                    },\n                    \"via_waypoint\": [],\n                    \"departure_time\": null,\n                    \"end_address\": \"Phố Quang Trung\",\n                    \"start_address\": \"\",\n                    \"arrival_time\": null,\n                    \"duration_in_traffic\": {\n                        \"text\": \"\",\n                        \"value\": 0\n                    },\n                    \"duration\": {\n                        \"value\": 89.1,\n                        \"text\": \"1m29s\"\n                    },\n                    \"distance\": {\n                        \"value\": 625.1,\n                        \"text\": \"0.6 km\"\n                    }\n                },\n                {\n                    \"steps\": [\n                        {\n                            \"driving_side\": \"right\",\n                            \"transit_details\": null,\n                            \"steps\": null,\n                            \"polyline\": {\n                                \"points\": \"uodbg@oqo{hExh@bN`GbBzD~@r\\\\fHzD~@\"\n                            },\n                            \"maneuver\": \"depart-right\",\n                            \"html_instruction\": \"Đi về hướng Nam trên Phố Quang Trung\",\n                            \"start_location\": {\n                                \"lng\": 105.849128,\n                                \"lat\": 21.023499\n                            },\n                            \"travel_mode\": \"DRIVING\",\n                            \"end_location\": {\n                                \"lng\": 105.848836,\n                                \"lat\": 21.022701\n                            },\n                            \"duration\": {\n                                \"value\": 27.2,\n                                \"text\": \"28s\"\n                            },\n                            \"distance\": {\n                                \"value\": 170,\n                                \"text\": \"0.2 km\"\n                            }\n                        },\n                        {\n                            \"driving_side\": \"right\",\n                            \"transit_details\": null,\n                            \"steps\": null,\n                            \"polyline\": {\n                                \"points\": \"mtabg@_rn{hEnAwGhPk}@tBkKxBoKpAoFdAcEjRcaA^wBvIcc@xA}H\"\n                            },\n                            \"maneuver\": \"turn-left\",\n                            \"html_instruction\": \"Quẹo trái vào Phố Trần Hưng Đạo\",\n                            \"start_location\": {\n                                \"lng\": 105.848624,\n                                \"lat\": 21.022039\n                            },\n                            \"travel_mode\": \"DRIVING\",\n                            \"end_location\": {\n                                \"lng\": 105.85028,\n                                \"lat\": 21.021561\n                            },\n                            \"duration\": {\n                                \"value\": 46.5,\n                                \"text\": \"47s\"\n                            },\n                            \"distance\": {\n                                \"value\": 393,\n                                \"text\": \"0.4 km\"\n                            }\n                        },\n                        {\n                            \"driving_side\": \"right\",\n                            \"transit_details\": null,\n                            \"steps\": null,\n                            \"polyline\": {\n                                \"points\": \"mr_bg@qsu{hEgCa@k@IkRiCkIgAaLyA_[aEmV}CkGW\"\n                            },\n                            \"maneuver\": \"turn-left\",\n                            \"html_instruction\": \"Quẹo trái vào Phố Hàng Bài\",\n                            \"start_location\": {\n                                \"lng\": 105.852233,\n                                \"lat\": 21.020983\n                            },\n                            \"travel_mode\": \"DRIVING\",\n                            \"end_location\": {\n                                \"lng\": 105.852502,\n                                \"lat\": 21.022206\n                            },\n                            \"duration\": {\n                                \"value\": 23.2,\n                                \"text\": \"24s\"\n                            },\n                            \"distance\": {\n                                \"value\": 195.5,\n                                \"text\": \"0.2 km\"\n                            }\n                        },\n                        {\n                            \"driving_side\": \"right\",\n                            \"transit_details\": null,\n                            \"steps\": null,\n                            \"polyline\": {\n                                \"points\": \"u~bbg@ajv{hE|AqIhCkMhAyFlQo~@^iBx@gE\"\n                            },\n                            \"maneuver\": \"turn-right\",\n                            \"html_instruction\": \"Quẹo phải vào Phố Lý Thường Kiệt\",\n                            \"start_location\": {\n                                \"lng\": 105.852593,\n                                \"lat\": 21.022715\n                            },\n                            \"travel_mode\": \"DRIVING\",\n                            \"end_location\": {\n                                \"lng\": 105.852593,\n                                \"lat\": 21.022715\n                            },\n                            \"duration\": {\n                                \"value\": 27.9,\n                                \"text\": \"28s\"\n                            },\n                            \"distance\": {\n                                \"value\": 184.3,\n                                \"text\": \"0.2 km\"\n                            }\n                        },\n                        {\n                            \"driving_side\": \"right\",\n                            \"transit_details\": null,\n                            \"steps\": null,\n                            \"polyline\": {\n                                \"points\": \"{_bbg@{sy{hEpEhA|Ct@hOtDbm@fO\"\n                            },\n                            \"maneuver\": \"turn-right\",\n                            \"html_instruction\": \"Quẹo phải vào Phố Ngô Quyền\",\n                            \"start_location\": {\n                                \"lng\": 105.854286,\n                                \"lat\": 21.022222\n                            },\n                            \"travel_mode\": \"DRIVING\",\n                            \"end_location\": {\n                                \"lng\": 105.854131,\n                                \"lat\": 21.021777\n                            },\n                            \"duration\": {\n                                \"value\": 17.7,\n                                \"text\": \"18s\"\n                            },\n                            \"distance\": {\n                                \"value\": 137.9,\n                                \"text\": \"0.1 km\"\n                            }\n                        },\n                        {\n                            \"driving_side\": \"right\",\n                            \"transit_details\": null,\n                            \"steps\": null,\n                            \"polyline\": {\n                                \"points\": \"}u_bg@}yx{hE\"\n                            },\n                            \"maneuver\": \"arrive-left\",\n                            \"html_instruction\": \"Đến nơi ở bên trái\",\n                            \"start_location\": {\n                                \"lng\": 105.853871,\n                                \"lat\": 21.021039\n                            },\n                            \"travel_mode\": \"DRIVING\",\n                            \"end_location\": {\n                                \"lng\": 105.853871,\n                                \"lat\": 21.021039\n                            },\n                            \"duration\": {\n                                \"value\": 0,\n                                \"text\": \"0s\"\n                            },\n                            \"distance\": {\n                                \"value\": 0,\n                                \"text\": \"0 m\"\n                            }\n                        }\n                    ],\n                    \"end_location\": {\n                        \"lng\": 105.853871,\n                        \"lat\": 21.021039\n                    },\n                    \"start_location\": {\n                        \"lng\": 105.849128,\n                        \"lat\": 21.023499\n                    },\n                    \"via_waypoint\": [],\n                    \"departure_time\": null,\n                    \"end_address\": \"Phố Ngô Quyền\",\n                    \"start_address\": \"Phố Quang Trung\",\n                    \"arrival_time\": null,\n                    \"duration_in_traffic\": {\n                        \"text\": \"\",\n                        \"value\": 0\n                    },\n                    \"duration\": {\n                        \"value\": 142.5,\n                        \"text\": \"2m22s\"\n                    },\n                    \"distance\": {\n                        \"value\": 1080.6,\n                        \"text\": \"1.1 km\"\n                    }\n                }\n            ],\n            \"bounds\": {\n                \"southwest\": {\n                    \"lng\": 105.8559038,\n                    \"lat\": 21.027229\n                },\n                \"northeast\": {\n                    \"lng\": 105.8445792,\n                    \"lat\": 21.019942\n                }\n            }\n        }\n    ]\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"Get a route","id":"get-a-route","depth":2},{"value":"Example: HTTP route request","id":"example-http-route-request","depth":3},{"value":"Example: HTTP route response body","id":"example-http-route-response-body","depth":3}],"frontmatter":{"seo":{"title":"Get a route"}},"lastModified":"2026-09-14T08:05:52.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/route/route-navigation","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}