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) để giúp xác định các tuyến đường di chuyển hiệu quả nhất giữa nhiều nguồn gốc và đích đến có thể có. Ví dụ: trình thực thi nào cần gửi đến trang web công việc hoặc kho hàng nào để gửi gói.
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ố lựa chọn, trong đó có phương thức di chuyển, 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ư 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 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
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à đích đến bất kỳ, đồng thời trả về khoảng cách và thời gian di chuyển giữa từng điểm gốc và tất cả các đích đến được yêu cầu, bắt đầu từ điểm gốc đầu tiên trong yêu cầu và tiến hành từng bước đến điểm gố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, 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 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 điểm xuất phát và điểm đến dưới dạng mã địa điểm, địa chỉ hoặc toạ độ vĩ độ/kinh độ. |
|
|
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 Google Cloud và hoàn thành hướng dẫn thiết lập sau đó. |
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 trong hướng dẫn Bắt đầu để biết thêm 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 nguồn gốc và đích đến. Tìm hiểu về các tham số không bắt buộc dùng để tính toán ràng buộc, chẳng hạn như thời gian khởi hành cụ thể hoặc các quy định hạn chế về tuyến đường. Xem phần Tham số không bắt buộc trong hướng dẫn về 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 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. Xem bài viết Phản hồ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ó
Hãy 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 dành cho Dịch vụ Google Maps
- Ứng dụng Python dành cho Dịch vụ Google Maps
- Ứng dụng Go cho Dịch vụ Google Maps
- Ứng dụng Node.js cho Dịch vụ Google Maps
Ứ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 được cộng đồng hỗ trợ, có nguồn mở theo Giấy phép Apache 2.0. Tải các tệp đó 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
- Bắt đầu sử dụng Ma trận khoảng cách: Chuyển đến phần Bắt đầu.
- Làm quen với các yêu cầu và phản hồi mẫu: Chuyển đến bài viết Yêu cầu và phản hồi của ma trận khoảng cách
- Làm theo các phương pháp hay nhất: Chuyển đến phần Các phương pháp hay nhất về dịch vụ web.