Tổng quan về Distance Matrix API (Cũ)

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

Giới thiệu

Distance Matrix API (Cũ) là một dịch vụ chấp nhận yêu cầu HTTPS chứa điểm khởi hành và điểm đến cho một phương thức vận chuyển nhất định. Đối với mỗi tổ hợp điểm khởi hành và điểm đến, dịch vụ này sẽ trả về quãng đường và thời gian di chuyển.

Tại sao bạn nên sử dụng Distance Matrix API (Cũ)

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

Các thao tác mà bạn có thể thực hiện với Distance Matrix API (Cũ)

Với Distance Matrix API (Cũ), bạn có thể cung cấp quãng đường và thời gian di chuyển cho ma trận điểm khởi hành và điểm đến. Bạn có thể chỉ định một số lựa chọn, bao gồm cả phương thức vận chuyển (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 chế độ 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 tàu điện).

Distance Matrix API (Cũ) cung cấp thông tin dựa trên tuyến đường được đề xuất giữa điểm bắt đầu 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 thức di chuyển đã chọn
  • Quãng đường tính bằng kilômét hoặc dặm
  • Thời gian di chuyển ước tính trong điều kiện 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 của API

Cách thức hoạt động của Distance Matrix API (Cũ)

Distance Matrix API (Cũ) sử dụng một số điểm khởi hành (điểm bắt đầu) và điểm đến, đồng thời trả về quãng đường và thời gian di chuyển giữa mỗi điểm khởi hành và tất cả điểm đến được yêu cầu, bắt đầu từ điểm khởi hành đầu tiên trong yêu cầu và tiến hành từng bước đến điểm khởi hành tiếp theo.

Ví dụ: nếu yêu cầu của bạn chỉ định A và B là điểm khởi hành, đồng thời C và D là điểm đến, thì API này sẽ trả về quãng đường và thời gian di chuyển theo thứ tự sau:

  • Từ A đến C
  • Từ A đến D
  • Từ B đến C
  • Từ B đến D

Ví dụ sau đây cho thấy yêu cầu đối với 2 điểm khởi hành: Washington, DC và Boston, với một điểm đến là Thành phố New York, NY, ở đị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 Distance Matrix API (Cũ) 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 khởi hành và điểm đến ở dạng mã địa điểm, địa chỉ, hoặc toạ độ vĩ độ/kinh độ.

  • Quãng đường và thời gian di chuyển giữa mỗi điểm khởi hành và mỗi điểm đến
  • Thời gian di chuyển trong điều kiện giao thông nếu bạn đã chỉ định chế độ lái xe và a thời gian khởi hành
  • JSON
  • XML

Cách sử dụng Distance Matrix API (Cũ)

1 Thiết lập Bắt đầu bằng cách Thiết lập dự án trên đám mây của bạn trên Google Cloud và hoàn tất các hướng dẫn 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 kiểm thử Distance Matrix API (Cũ) ngay trên trình duyệt. Hãy xem Yêu cầu mẫu trong hướng dẫn Bắt đầu để biết ví dụ.
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 điểm khởi hành và điểm đến. Tìm hiểu về các tham số không bắt buộc để hạn chế tính toán, chẳng hạn như thời gian khởi hành được chỉ định hoặc các hạn chế về tuyến đường. Hãy xem Tham số không bắt buộc trong hướng dẫn Yêu cầu và phản hồi của Distance Matrix (Cũ).
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 hồi ma trận khoảng cách để biết thông tin chi tiết.
5 Kết 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 quãng đường 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ữ 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ụ Google Maps là các thư viện ứng dụng do cộng đồng hỗ trợ, có nguồn mở theo Giấy phép Apache 2.0. Tải các ứng dụng 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.

Bước tiếp theo