TỔNG QUAN
Định nghĩa
Distance Matrix hay còn gọi là ma trận khoảng cách, là một loại API cho phép người dùng tính toán khoảng cách và thời gian di chuyển giữa nhiều địa điểm khác nhau.
API này cung cấp thông tin về khoảng cách đường đi giữa các điểm, thời gian di chuyển dự kiến và thậm chí cả thông tin về tuyến đường khác nhau. Distance Matrix API có tính năng cung cấp thời gian và khoảng cách cho một ma trận gồm nhiều điểm trên lộ trình.
Distance Matrix của Goong thường được sử dụng trong lập kế hoạch định tuyến, vận chuyển hàng hóa, quản lý đội xe, và trong các ứng dụng liên quan đến di chuyển và định vị. Nó cung cấp thông tin cụ thể để tối ưu hóa hành trình và quản lý tài nguyên di chuyển.
Việc tích hợp API này mang lại nhiều lợi ích cho các ứng dụng và dịch vụ, đặc biệt trong việc quản lý lộ trình giao nhận hàng hóa, đón trả hành, logistics, kế hoạch du lịch và nhiều ứng dụng khác.
Lý do nên sử dụng Distance Matrix API
- Tối ưu hóa lộ trình: Distance Matrix API giúp tính toán khoảng cách và thời gian di chuyển giữa các điểm, hỗ trợ tối ưu hóa lộ trình. Điều này quan trọng trong việc giảm thời gian và chi phí vận chuyển cho các dịch vụ cần phải di chuyển hàng hóa hoặc người.
- Lập kế hoạch chuyến đi: Cung cấp thông tin về khoảng cách và thời gian di chuyển giữa các điểm đến, giúp người dùng lập kế hoạch chuyến đi hiệu quả hơn.
- Tối ưu quản lý logistics: Cung cấp thông tin chi tiết về khoảng cách và thời gian di chuyển, hỗ trợ các doanh nghiệp trong việc quản lý và lập kế hoạch logistics hiệu quả. Các công ty logistics có thể sử dụng API để phân tích và tối ưu hóa các tuyến đường phân phối hàng hóa, giúp giảm chi phí và tăng cường hiệu quả hoạt động.
CÁCH TẠO MỘT YÊU CẦU DISTANCE MATRIX
Đầu tiên, bạn phải đăng ký tài khoản và tạo API key của Goong theo hướng dẫn chi tiết tại đây.
Hãy bắt đầu bằng cách nhập url vào trình duyệt web của bạn – sau đó thay thế YOUR_API_KEY bằng API key mà bạn đã tạo. Phản hồi về sẽ cho biết khoảng cách và thời lượng giữa các điểm gốc và đích đến được chỉ định.
URL: /distancematrix
Phương thức: GET
Ví dụ về request:
curl "https://rsapi.goong.io/distancematrix?origins=20.981971,105.864323&destinations=21.031011,105.783206%7C21.022328,105.790480%7C21.016665, 105.788774&vehicle=car&api_key={YOUR_API_KEY}"
| Tham số | Mô tả | Ví dụ |
| origins | Danh sách (chuỗi) các điểm xuất phát (bắt buộc). | 20.981971,105.864323 |
| destinations | Danh sách (chuỗi) các điểm đến(bắt buộc). | 21.031011,105.783206 | 21.022328,105.790480 | 21.016665,105.788774 |
| vehicle | Loại phương tiện, bao gồm: ô tô (car), xe đạp (bike), taxi, xe tải (truck), hd (cho các phương tiện gọi xe). | car |
Ví dụ về response:
application/json
{
"rows": [
{
"elements": [
{
"status": "OK",
"duration": {
"text": "33 phút",
"value": 1983
},
"distance": {
"text": "16 km",
"value": 15962
}
},
{
"status": "OK",
"duration": {
"text": "32 phút",
"value": 1914
},
"distance": {
"text": "15 km",
"value": 14627
}
},
{
"status": "OK",
"duration": {
"text": "29 phút",
"value": 1749
},
"distance": {
"text": "14 km",
"value": 13556
}
}
]
}
]
}
| Tham số | Mô tả | Ví dụ |
| rows | Là một mảng gồm các đối tượng chứa các quãng đường, mỗi hàng tương ứng với một cặp bắt đầu và kết thúc, quãng đường đi gồm trạng thái, thời gian và khoảng cách. | {
“elements”: [ { “distance”: {}, “duration”: {}, “status”: “OK” } ] } |
| elements | Là phần tử con của rows và tương ứng với một cặp điểm bắt đầu với từng đích đến. Các bảng này chứa thông tin về trạng thái, thời gian (đơn vị: giây) và khoảng cách (đơn vị: mét) cho từng đoạn nhỏ trong cặp bắt đầu và kết thúc. |
{ “distance”: { “text”: “16.60 km”, “value”: 16602 }, “duration”: { “text”: “53 phút”, “value”: 3160 }, “status”: “OK” } |
| status | Mã trạng thái “ok” nghĩa là thành công. | ok |
| duration | Khoảng cách về “thời gian” mỗi địa điểm đi qua (thời gian dưới dạng text, còn value là thời gian khi đi trên đoạn đường đó – đơn vị là phút). | 33 phút |
| distance | Khoảng cách về “km” mỗi địa điểm đi qua (khoảng cách dưới dạng text, còn value là giá trị – đơn vị là km). | 15 km |
