TỔNG QUAN
Direction api cung cấp thông tin về định hướng và dẫn đường giữa hai hoặc nhiều địa điểm. Thông tin này thường bao gồm tuyến đường đề xuất, khoảng cách, thời gian dự kiến, hướng dẫn chi tiết về lộ trình, thông tin giao thông và các thông tin khác liên quan đến chuyến đi.
Lý do nên sử dụng Direction
Bạn có thể tính toán đường đi nhiều phương thức di chuyển (đi bộ, xe máy, ô tô…) bằng cách sử dụng API Direction. Đối tượng này sẽ giao tiếp với dịch vụ chỉ đường của API Goong map để nhận diện yêu cầu chỉ đường và trả về một lộ trình tối ưu.
Thời gian di chuyển là yếu tố chính được ưu tiên, ngoài ra bạn cũng có thể tính đến các yếu tố khác như khoảng cách, số ngã rẽ và nhiều yếu tố khác để quyết định tuyến đường nào hiệu quả nhất.
Khi chỉ định điểm xuất phát hoặc điểm đến trong yêu cầu chỉ đường, bạn có thể chỉ định một chuỗi truy vấn
Dịch vụ Chỉ đường có thể trả về thông tin đường đi gồm nhiều phần bằng cách sử dụng một loạt các điểm tham chiếu. Đường đi được hiển thị dưới dạng hình nhiều đường vẽ tuyến đường trên bản đồ, hoặc dưới dạng một loạt nội dung mô tả bằng văn bản trong phần tử
Cách thức tích hợp direction
URL: /Direction
Phương thức: Get
Ví dụ về request
$curl”https://rsapi.goong.io/Direction?origin=21.046623224000029,105.790168203000060&destination=21.046666732000062,105.790169569000060&vehicle=car&api_key={YOUR_API_KEY}”
Direction request chứa các đối tượng sau:
| Tham số | Mô tả | Ví dụ |
| origin | Chuỗi tọa độ điểm xuất phát (bắt buộc) | 20.981971,105.864323 |
| destination | Chuỗi tọa độ điểm đến. Ngăn cách bằng dấu chấm phẩy (;) nếu có nhiều hơn 2 điểm đến (bắt buộc). | 21.03876,105.79810 |
| alternatives | Boolean, Nếu là true, dịch vụ chỉ đường có thể trả về nhiều tuyến đường | true |
| vehicle | Loại phương tiện. Các tùy chọn bao gồm: xe hơi (car), xe đạp (bike), taxi, xe tải (truck), hd (cho các phương tiện thuê xe). | car |
Response (Phản hồi)
application/json
{
“geocoded_waypoints”: [],
“routes”: [
{
“bounds”: {},
“legs”: [
{
“distance”: {
“text”: “5 m”,
“value”: 5
},
“duration”: {
“text”: “1 giây”,
“value”: 1
},
“steps”: []
}
],
“overview_polyline”: {
“points”: “mtm_C{cudSG@”
},
“warnings”: [],
“waypoint_order”: []
}
]
}
| Tham số | Mô tả | Ví dụ |
| geocoded_waypoints | Trả về thông tin về các điểm được mã hóa địa lý trong yêu cầu tìm đường. Bao gồm thông tin về vị trí địa lý của điểm, bao gồm tọa độ vĩ độ và kinh độ, địa chỉ, loại địa điểm…
Có thể được sử dụng để hiển thị các điểm trên bản đồ, hoặc để xác định vị trí cụ thể của các địa điểm trong quá trình tìm đường. |
|
| routes | Các tuyến đường hoặc đường đi được tính toán | |
| Legs | Các phần của tuyến đường hoặc đường đi giữa hai điểm địa lý cụ thể trên một tuyến đường. Bao gồm: khoảng cách, thời gian đi lại, địa chỉ xuất phát và đích, các hướng dẫn chi tiết về cách đi giữa hai điểm và các thông tin khác liên quan. | |
| Overview_polyline | Được sử dụng để trả về một tuyến đường hoặc đường đi dưới dạng một chuỗi đường dẫn đa giác được nén.
Chuỗi đường dẫn đa giác này thường được sử dụng để vẽ một tuyến đường hoặc đường đi trên bản đồ, giúp người dùng hiểu rõ hơn về hành trình hoặc địa điểm cần đến. |
|
| warnings | Thông tin về các cảnh báo thường bao gồm các yếu tố như tình trạng giao thông, công trình xây dựng, địa hình khó khăn, hoặc các yếu tố khác có thể ảnh hưởng đến hành trình | |
| waypoint_order | Thứ tự và vị trí các điểm dừng trung gian trên tuyến đường |