GMap Cloud · Tuyến đường

API tìm đường, ma trận thời gian – quãng đường và vùng phục vụ

Tính đường đi, xếp thứ tự điểm giao và ước tính thời gian di chuyển cho giao hàng, điều phối và chọn địa điểm. Thời gian là ước tính theo mô hình định tuyến.

Xem tài liệu API Trao đổi nhu cầu

Khả năng chính

Tìm đường

Tuyến đường giữa hai hoặc nhiều điểm cho ô tô, xe đạp hoặc đi bộ, kèm GeoJSON và chỉ dẫn.

Tài liệu

Xếp thứ tự điểm

Tìm thứ tự hợp lý cho chuyến đi nhiều điểm để rút ngắn hành trình.

Tài liệu

Ma trận thời gian – quãng đường

Tính thời gian và quãng đường giữa nhiều điểm đi, điểm đến trong một lần gọi.

Tài liệu

Vùng phục vụ (isochrone)

Vẽ vùng có thể đến trong 15, 30 phút… quanh một vị trí.

Tài liệu

Ví dụ API

Ma trận thời gian – quãng đường bằng ô tô (Hà Nội)

Yêu cầu

curl 'https://cloud.gmap.vn/api/tsp/route/sources_to_targets' \
  --header 'x-api-key: public-gmap-cloud-x-api-key-demo' \
  --header 'content-type: application/json' \
  --data '{
    "sources": [{ "lat": 21.0285, "lon": 105.8542 }],
    "targets": [{ "lat": 21.015, "lon": 105.847 }, { "lat": 21.045, "lon": 105.82 }],
    "costing": "auto"
  }'

Phản hồi (trích)

{
  "units": "kilometers",
  "sources_to_targets": [[
    { "from_index": 0, "to_index": 0, "distance": 2.733, "time": 302 },
    { "from_index": 0, "to_index": 1, "distance": 6.083, "time": 550 }
  ]]
}

Phản hồi API demo ngày 11/10/2026; time tính bằng giây, distance theo units. Chưa bao gồm dữ liệu giao thông thời gian thực.

Ứng dụng thường gặp

Giao nhận nhiều điểm

Sắp xếp điểm giao và ước tính thời gian hoàn thành cho từng chuyến.

Phân công gần nhất

Dùng ma trận để chọn kho, cửa hàng hoặc nhân sự có thời gian di chuyển ngắn nhất.

Phân tích vùng phục vụ

Vẽ vùng 15 – 30 phút quanh cửa hàng để chọn địa điểm mới.

Hướng dẫn liên quan

Câu hỏi thường gặp

Thời gian di chuyển có tính giao thông thực tế không?

Thời gian là ước tính theo mô hình định tuyến và loại phương tiện. Dữ liệu giao thông thời gian thực chưa được đưa vào kết quả.

Hỗ trợ những phương tiện nào?

Tìm đường cơ bản hỗ trợ car, bike và foot. Các API nâng cao (ma trận, isochrone, tối ưu lộ trình) nhận tham số costing như auto.

Có thể thử trước không?

Có. Tài liệu API có sẵn ví dụ cho từng endpoint với khóa demo công khai để chạy thử.