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

Distance Matrix API (API Ma trận khoảng cách) 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 thức vận tải nhất định. Đối với mỗi kết hợp điểm khởi hành và điểm đến, hàm này sẽ trả về khoảng cách và thời gian di chuyển.

Lý do bạn nên sử dụng API Ma trận khoảng cách

Bạn có thể sử dụng Distance Matrix API (API Ma trận khoảng cách) để xác định biến thể hiệu quả nhất tuyến đường giữa nhiều điểm xuất phát và điểm đến. Cho ví dụ như nhân viên nào cần gửi đến công trường hoặc gửi từ kho hàng nào .

Những việc bạn có thể làm với API Ma trận khoảng cách

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

API Ma trận khoảng cách cung cấp thông tin dựa trên tuyến đường được đề xuất giữa điểm xuất phát và điểm kết thúc. 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 theo ki lô mét hoặc dặm
  • Thời gian di chuyển ước tính khi giao thông

bản đồ hiển thị điểm xuất phát và điểm đến trên bản đồ và trong phản hồi của API

Cách hoạt động của API Ma trận khoảng cách

API Ma trận khoảng cách sử dụng số lượng nguồn gốc (điểm xuất phát) và điểm đến bất kỳ, đồng thời trả về khoảng cách và thời gian di chuyển giữa mỗi điểm điểm khởi hành và tất cả các đích đến được yêu cầu, bắt đầu với điểm khởi hành đầu tiên trong yêu cầu và tiến hành từng bước sang bước 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
  • B đến C
  • B đến D

Ví dụ sau đây cho thấy một yêu cầu đối với 2 nguồn gốc: Washington, DC và Boston cùng 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 Ma trận khoảng cách cùng với dữ liệu mà API 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 nguồn gốc và điểm đến dưới dạng mã địa điểm, địa chỉ, hoặc vĩ độ/kinh độ.

  • Khoảng cách và thời gian đi lại giữa mỗi điểm khởi hành và mỗi điểm khởi hành điểm đến
  • Thời lượng tham gia 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 API Ma trận khoảng cách

1 Thiết lập. Hãy bắt đầu bằng việc Thiết lập Dự án trên Google Cloud và hoàn tất quá trình thiết lập tiếp theo.
2 Thử yêu cầu ma trận khoảng cách Sau khi có khoá API, bạn có thể bắt đầu thử nghiệm Distance Matrix API ngay trong trình duyệt. Hãy xem phần Yêu cầu mẫu hãy xem ví dụ trong hướng dẫn Bắt đầu.
3 Soạn một yêu cầu phức tạp hơn Hãy thử một yêu cầu cung cấp nhiều nguồn gốc và đích đến. Học hỏi về các tham 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 hoặc quy định hạn chế về tuyến đường. Xem phần Các thông số không bắt buộc trong hướng dẫn Yêu cầu và phản hồi ma trận khoảng cách.
4 Tìm hiểu thông tin cơ bản về câu trả lời Khám phá các câu trả lời về 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. Xem Câu trả lời của 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 bạn! Bạn có thể sử dụng dữ liệu này để tính khoảng cách và thời gian di chuyển.

Thư viện ứng dụng hiện có

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

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

Các bước tiếp theo