Route

Last updated 18 days ago

Trả về thông tin dẫn đường giữa điểm đi và điểm đến hay theo loại phương tiện. Có thể nhập thêm các điểm dừng, dẫn đường đến các điểm dừng được xử lý theo thứ tự nhập

HTTP Method: POST
Endpoint URL: http://api.goong.io/Route
Header Authorization: Bearer + API Key

Example with "has_steps" = true

Request
Response
{
"positions": [{
"lon": 105.844345, // number
"lat": 21.001919 // number
},{
"lon": 105.856116, // number
"lat": 21.018503 // number
}
],
"vehicle_type": "car", // List available values: "car", "bike", "taxi", "truck"
"routing_type": "fastest", // "fastest", "shortest", "both"
"has_steps": true // List of available values: True -> response trả về các Instructions turn by turn; false-> ko có Instructions
}
{
"code": 200,
"result": {
"waypoints": [{
"lon": 105.844344,
"lat": 21.001888,
"name": "Lê Thanh Nghị"
}, {
"lon": 105.856104,
"lat": 21.018556,
"name": "Hàn Thuyên"
}],
"routes": [{
"geometry": "y|[email protected]|@[email protected]_FgLwKpDRlB",
"distance": 3286.1,
"distance_text": "3.2861 km",
"duration": 629.6,
"duration_text": "10.49333 phút",
"description": "Lê Thanh Nghị, Phố Huế",
"instructions": [{
"distance": 197.7,
"distance_text": "197.7 m",
"duration": 38.6,
"duration_text": "38.6 giây",
"road": "Lê Thanh Nghị",
"lon": 105.843195,
"lat": 21.001896,
"description": "Quay đầu"
}, {
"distance": 681.4,
"distance_text": "681.4 m",
"duration": 130.7,
"duration_text": "2.178333 phút",
"road": "Lê Thanh Nghị",
"lon": 105.844996,
"lat": 21.001787,
"description": "Hướng sang trái để vào Lê Thanh Nghị"
}, {
"distance": 624.9,
"distance_text": "624.9 m",
"duration": 118.6,
"duration_text": "1.976667 phút",
"road": "Bạch Mai",
"lon": 105.850924,
"lat": 21.003203,
"description": "Rẽ trái để vào Bạch Mai"
}, {
"distance": 705.9,
"distance_text": "705.9 m",
"duration": 134.5,
"duration_text": "2.241667 phút",
"road": "Phố Huế",
"lon": 105.851445,
"lat": 21.0088,
"description": ""
}, {
"distance": 517.5,
"distance_text": "517.5 m",
"duration": 98.1,
"duration_text": "1.635 phút",
"road": "Hòa Mã",
"lon": 105.851569,
"lat": 21.015129,
"description": "Rẽ phải để vào Hòa Mã"
}, {
"distance": 137.3,
"distance_text": "137.3 m",
"duration": 27.1,
"duration_text": "27.1 giây",
"road": "Phạm Đình Hổ",
"lon": 105.856393,
"lat": 21.015999,
"description": "Tiếp tục hướng đông bắc trên Phạm Đình Hổ"
}, {
"distance": 244.6,
"distance_text": "244.6 m",
"duration": 47.4,
"duration_text": "47.4 giây",
"road": "Hàng Chuối",
"lon": 105.857535,
"lat": 21.016622,
"description": "Rẽ trái để vào Hàng Chuối"
}, {
"distance": 57.4,
"distance_text": "57.4 m",
"duration": 10.8,
"duration_text": "10.8 giây",
"road": "Hàn Thuyên",
"lon": 105.856646,
"lat": 21.018659,
"description": "Rẽ trái để vào Hàn Thuyên"
}, {
"distance": 0,
"distance_text": "0 m",
"duration": 0,
"duration_text": "0 giây",
"road": "Hàn Thuyên",
"lon": 105.856646,
"lat": 21.018659,
"description": "Đến điểm đích"
}]
}]
}
}

Example with "has_steps" = false

Request
Response
{
"positions": [{
"lon": 105.844345, // number
"lat": 21.001919 // number
},{
"lon": 105.856116, // number
"lat": 21.018503 // number
}
],
"vehicle_type": "car", // List available values: "car", "bike", "taxi", "truck"
"routing_type": "fastest", // "fastest", "shortest", "both"
"has_steps": true // List of available values: True -> response trả về các Instructions turn by turn; false-> ko có Instructions
}
{
"code": 200,
"result": {
"waypoints": [
{
"lon": 105.844345,
"lat": 21.001889,
"name": "Lê Thanh Nghị"
},
{
"lon": 105.856104,
"lat": 21.018557,
"name": "Hàn Thuyên"
}
],
"routes": [
{
"distance": 3162,
"distance_text": "3.162 km",
"duration": 348.3,
"duration_text": "5.805 phút",
"description": "",
"instructions": []
}
]
}
}