Tổng quan về API ma trận khoảng cách

API Distance Matrix là một dịch vụ chấp nhận yêu cầu HTTPS chứa điểm xuất phát và điểm đến cho một phương tiện giao thông nhất định. Đối với mỗi tổ hợp điểm xuất phát và điểm đến, hàm này sẽ trả về khoảng cách và thời gian di chuyển.

Lý do sử dụng Distance Matrix API

Bạn có thể sử dụng API Distance Matrix để xác định tuyến đường di chuyển hiệu quả nhất giữa nhiều điểm xuất phát và điểm đến có thể có. Ví dụ: nhân viên nào sẽ được gửi đến công trường hoặc kho nào sẽ gửi gói hàng.

Những việc bạn có thể làm với Distance Matrix API

Với Distance Matrix API, bạn có thể cung cấp khoảng cách và thời gian di chuyển cho một ma trận gồm các điểm xuất phát và điểm đến. Bạn có thể chỉ định một số tuỳ chọn, bao gồm cả phương tiện đi lại, chẳng hạn như lái xe, đi xe đạp, đi phương tiện công cộng hoặc đi bộ, cũng như các phương tiện công cộng, chẳng hạn như xe buýt, tàu điện ngầm, tàu, xe điện hoặc đường sắt.

API Distance Matrix cung cấp thông tin dựa trên tuyến đường đề xuất giữa điểm xuất phát và điểm đến. Bạn có thể yêu cầu các loại dữ liệu khoảng cách sau:

  • Quãng đường cho một phương tiện đi lại đã chọn
  • Khoảng cách tính bằng ki lô mét hoặc dặm
  • Thời gian di chuyển ước tính trong tình trạng giao thông

bản đồ cho thấy điểm xuất phát và điểm đến trên bản đồ và trong phản hồi API

Cách hoạt động của Distance Matrix API

API Distance Matrix sử dụng số lượng điểm xuất phát (điểm bắt đầu) và điểm đến tuỳ ý, đồng thời trả về khoảng cách và thời gian di chuyển giữa mỗi điểm xuất phát và tất cả điểm đến được yêu cầu, bắt đầu từ điểm xuất phát đầu tiên trong yêu cầu và tiếp tục từng bước đến điểm xuất phát tiếp theo.

Ví dụ: nếu yêu cầu của bạn chỉ định A và B là điểm xuất phát, còn C và D là điểm đến, thì yêu cầu đó sẽ trả về khoảng cách và thời gian di chuyển theo thứ tự sau:

  • A đến C
  • A đến D
  • B2C
  • B đến D

Ví dụ sau đây cho thấy một yêu cầu cho hai điểm xuất phát: Washington, DC và Boston, với một điểm đến duy nhất là Thành phố New York, New York, ở định dạng JSON:

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=New%20York%20City%2C%20NY
  &origins=Washington%2C%20DC%7CBoston
  &units=imperial
  &key=YOUR_API_KEY

Tài nguyên

Bảng sau đây tóm tắt các tài nguyên có sẵn thông qua API Distance Matrix cùng với dữ liệu mà API này trả về.

Tài nguyên dữ liệu Dữ liệu được trả về Định dạng trả về
Ma trận khoảng cách

Cung cấp điểm xuất phát và điểm đến ở dạng mã địa điểm, địa chỉ hoặc toạ độ vĩ độ/kinh độ.

  • Khoảng cách và thời gian di chuyển giữa mỗi điểm xuất phát và mỗi điểm đến
  • Thời lượng trong tình trạng giao thông nếu bạn đã chỉ định chế độ lái xe và thời gian khởi hành
  • JSON
  • XML

Cách sử dụng Distance Matrix API

1 Thiết lập. Bắt đầu bằng cách Thiết lập dự án Google Cloud và hoàn tất hướng dẫn thiết lập theo sau.
2 Thử một yêu cầu về ma trận khoảng cách Sau khi có khoá API, bạn có thể bắt đầu kiểm thử API Distance Matrix ngay trên trình duyệt. Hãy xem phần Yêu cầu mẫu trong hướng dẫn Bắt đầu sử dụng để biết ví dụ.
3 Soạn một yêu cầu phức tạp hơn Thử một yêu cầu cung cấp nhiều nguồn gốc và đích đến. Tìm hiểu về các thông số không bắt buộc để ràng buộc các phép tính, chẳng hạn như thời gian khởi hành đã chỉ định hoặc các quy định hạn chế về tuyến đường. Xem Các tham số không bắt buộc trong hướng dẫn về Yêu cầu và phản hồi của Ma trận khoảng cách.
4 Tìm hiểu kiến thức cơ bản về phản hồi Khám phá các phản hồi dữ liệu để chuẩn bị sử dụng dữ liệu ma trận khoảng cách cho ứng dụng của bạn. Hãy xem phần Phản hồi ma trận khoảng cách để biết thông tin chi tiết.
5 Tích hợp dữ liệu ma trận khoảng cách vào ứng dụng của riêng bạn! Bạn có thể sử dụng dữ liệu này để tính toán khoảng cách và thời gian di chuyển.

Các thư viện ứng dụng hiện có

Gọi API này bằng ngôn ngữ bạn chọn thông qua một trong các thư viện ứng dụng sau:

Ứng dụng Java, Ứng dụng Python, Ứng dụng Go và Ứng dụng Node.js cho Dịch vụ Maps của Google là các thư viện ứng dụng do cộng đồng hỗ trợ, nguồn mở theo Giấy phép Apache 2.0. Tải các tệp này xuống từ GitHub. Tại đây, bạn cũng có thể tìm thấy hướng dẫn cài đặt và mã mẫu.

Bước tiếp theo