API Dẫn đường
Cho phép tìm kiếm đường và chỉ dẫn đường đi qua 2 hoặc nhiều điểm dừng
Thông tin về chi phí sử dụng dịch vụ vui lòng xem tại Thông tin bảng giá dịch vụ.
GET https://apis.wemap.asia/route-api/route?point={TOẠ_ĐỘ_ĐỊA_ĐIỂM_MỘT}&point={TOẠ_ĐỘ_ĐỊA_ĐIỂM_HAI}&key={API_KEY_CỦA_BẠN}
Thông số bắt buộc |
Loại dữ liệu |
Miêu tả |
point |
Mảng các chuỗi |
Danh sách các điểm bạn cần dẫn đường. Định dạng dữ liệu: [VĨ_ĐỘ_ĐỊA_ĐIỂM,KINH_ĐỘ_ĐỊA_ĐIỂM ]. Gửi lên ít nhất 2 điểm: Điểm bắt đầu, điểm kết thúc. Thêm các điểm ở giữa tuỳ theo yêu cầu của bạn. Số điểm tối đa phụ thuộc vào gói bạn sử dụng |
key |
Chuỗi |
API key của bạn. Cách khởi tạo một API key xem tại đây. |
Thông số tuỳ chọn |
Loại dữ liệu |
Miêu tả |
vehicle |
Chuỗi |
Loại phương tiện di chuyển. Mặc định là car (ôtô). Các tuỳ chọn khác: bike (xe đạp), foot (đi bộ) |
locale |
Chuỗi |
Ngôn ngữ hướng dẫn chỉ đường. Mặc định vi (tiếng Việt). Các tuỳ chọn khác: en (tiếng Anh) |
details |
Mảng các chuỗi |
Các thông tin chi tiết bạn muốn biết thêm về tuyến đường. Các thông tin bao gồm: street_name (tên đường), max_speed (vận tốc tối đa), toll (phí), lanes (số làn), surface (loại bề mặt đường) |
instructions |
Boolean |
Các chỉ dẫn việc di chuyển trên tuyến đường tìm được. Mặc định là true . Chọn false nếu bạn muốn ẩn các chỉ dẫn này. |
type |
Chuỗi |
Loại dữ liệu bạn muốn trả về. Mặc định là json . Các lựa chọn khác: gpx . |
points_encoded |
Boolean |
Lựa chọn mã hóa thông tin geometry của truy vấn. Mặc định là true . Các lựa chọn khác: false . |
Ví dụ dẫn đường giữa hai điểm
# Tìm kiếm đường đi giữa 2 địa điểm cso tọa độ {21.052403,105.78362} và {20.982317,105.863335}
$ curl "https://apis.wemap.asia/route-api/route?point=21.052403%2C105.78362&point=20.982317%2C105.863335&type=json&locale=en-US&vehicle=car&weighting=fastest&elevation=false&key={API_KEY_CỦA_BẠN}"
Phản hồi
Phản hồi là thông tin về đường đi và chỉ dẫn ở định dạng JSON.
Trường |
Kiểu dữ liệu |
Miêu tả |
paths |
Mảng |
Danh sách các tuyến đường tìm được dưới dạng RouteResponsePath |
info |
Đối tượng |
Thông tin thêm trả về tuỳ theo |
{
"hints":{
"visited_nodes.sum":17834,
"visited_nodes.average":17834.0
},
"info":{
"copyrights":[
"WeMap",
"OpenStreetMap contributors"
],
"took":107
},
"paths":[
{
"distance":15003.441,
"weight":945.677022,
"time":945533,
"transfers":0,
"points_encoded":true,
"bbox":[
105.780307,
20.98231,
105.863291,
21.0524
],
"points":"oxn_CyxsdSpBABgBtDFLcCL@xBCdWJ@bMDzBMbAtL`@bBJ`Pl@`IDfFTnAHtBVn@LtALFkBKk@W}@EWCg@?[VkYPqKReGL}BFe@hAgFLa@Dc@lAaF`@wBtBwI`B{HXy@p@oANQ|FoGhHyHzBiCf@{@JDL?vApAnJzHl@Tz@v@jBbAbDpA`AXdANz@DlAObAg@rKeMzAgAzEsBp@]jMsF|DyBxGcG|FuGfC_D|GmK~GcLtFqKlAiCdAiBV[jB}AbH}EdHqDpAgAp@{@j@_AbCgCZc@Zo@Lq@Z{B^{ArAkGV}AG[N{@z@wCbFuZb@uBRCd@cCTaBlCqM`@_Cd@cEd@_Df@cHLoAzCsR|@oF|@o@dBwA`IHZGbHFdQ@~PFlFDlG@nJDAqFAsg@D_IJ{F@_PImS@}GImXj@?HOjE_@",
"instructions":[
{
"distance":117.681,
"heading":179.42,
"sign":0,
"interval":[
0,
2
],
"text":"Continue",
"time":14121,
"street_name":""
},
{
"distance":169.399,
"sign":2,
"interval":[
2,
4
],
"text":"Turn right",
"time":20326,
"street_name":""
},
{
"distance":506.778,
"sign":2,
"interval":[
4,
7
],
"text":"Turn right onto Ngõ 234 Hoàng Quốc Việt",
"time":60811,
"street_name":"Ngõ 234 Hoàng Quốc Việt"
},
{
"distance":335.658,
"sign":2,
"interval":[
7,
10
],
"text":"Turn right onto Hoàng Quốc Việt",
"time":20135,
"street_name":"Hoàng Quốc Việt"
},
{
"distance":1100.758,
"sign":-2,
"interval":[
10,
19
],
"text":"Turn left onto Đường Phạm Văn Đồng",
"time":56601,
"street_name":"Đường Phạm Văn Đồng"
},
{
"distance":56.363,
"sign":-2,
"interval":[
19,
20
],
"text":"Turn left",
"time":2898,
"street_name":""
},
{
"distance":2360.976,
"sign":-1,
"interval":[
20,
44
],
"text":"Turn slight left onto Xuân Thủy",
"time":130732,
"street_name":"Xuân Thủy"
},
{
"exit_number":1,
"distance":4340.75,
"sign":6,
"exited":true,
"turn_angle":-1.44,
"interval":[
44,
87
],
"text":"At roundabout, take exit 1 onto Đường Láng",
"time":246265,
"street_name":"Đường Láng"
},
{
"distance":660.205,
"sign":1,
"interval":[
87,
91
],
"text":"Turn slight right onto Đường Trường Chinh",
"time":36559,
"street_name":"Đường Trường Chinh"
},
{
"distance":1310.212,
"sign":2,
"interval":[
91,
102
],
"text":"Turn right onto Đường Trường Chinh",
"time":72553,
"street_name":"Đường Trường Chinh"
},
{
"distance":1603.92,
"sign":7,
"interval":[
102,
112
],
"text":"Keep right",
"time":92601,
"street_name":""
},
{
"distance":2290.463,
"sign":-2,
"interval":[
112,
120
],
"text":"Turn left onto Phố Kim Đồng",
"time":164883,
"street_name":"Phố Kim Đồng"
},
{
"distance":25.086,
"sign":2,
"interval":[
120,
121
],
"text":"Turn right",
"time":4515,
"street_name":""
},
{
"distance":125.192,
"sign":-2,
"interval":[
121,
123
],
"text":"Turn left",
"time":22533,
"street_name":""
},
{
"distance":0.0,
"sign":4,
"last_heading":170.4492144734686,
"interval":[
123,
123
],
"text":"Arrive at destination",
"time":0,
"street_name":""
}
],
"legs":[
],
"details":{
},
"ascend":0.0,
"descend":0.0,
"snapped_waypoints":"oxn_CyxsdS`uLwrN"
}
]
}
Các mã lỗi của API Routing
Trường message trong phần thân phản hồi |
Mã lỗi HTTP |
Miêu tả |
Yêu cầu của bạn không đúng |
400 |
Khi bạn gửi lên yêu cầu quá ít hoặc quá nhiều points |
Lỗi xác thực - Thiếu API key |
401 |
Thông số key là bắt buộc |
Lỗi xác thực - Sai API key |
401 |
Kiểm tra lại thông số key |
Lỗi hệ thống |
500 |
Chúng tôi đã nhận được thông tin và sẽ khắc phục trong thời gian sớm nhất. |
Lỗi lựa chọn phương tiện |
501 |
Kiểm tra lại thông số vehicle . Hệ thống chỉ hỗ trợ các loại phương tiện đã liệt kê |