Route Optimization API chỉ định nhiệm vụ và tuyến đường cho một đội xe, tối ưu hoá theo các mục tiêu và quy tắc ràng buộc mà bạn cung cấp, chẳng hạn như khung thời gian, sức chứa của xe, giờ làm việc của tài xế và chi phí. Bạn gọi API này thông qua REST, gRPC hoặc thư viện ứng dụng và API này sẽ trả về trình tự ghé thăm, chỉ định lô hàng, thời gian ước tính và chỉ số tuyến đường.
Route Optimization API: thông tin chính
- Sản phẩm: Route Optimization API
- Còn gọi là: GMPRO
- Danh mục: Tuyến đường
- Nền tảng: Dịch vụ web (REST)
- Chạy trên: Máy chủ (mã phụ trợ)
- Giai đoạn ra mắt: GA
- Vòng đời: Đang hoạt động
- Tổng quan: Tổng quan về Route Optimization API
Route Optimization API: trường hợp sử dụng
Sử dụng Route Optimization API khi:
- Bạn cần chỉ định lô hàng hoặc nhiệm vụ cho một số xe, đồng thời tuân thủ khung thời gian, sức chứa của xe, giờ làm việc của tài xế và chi phí.
- Bạn cần có trình tự dừng tốt nhất cho một phương tiện có nhiều điểm đến để đón khách, giao hàng hoặc cuộc hẹn.
- Bạn cần tối ưu hoá lại các tuyến đường đang hoạt động cho đơn đặt hàng mới (chẳng hạn như điều phối theo yêu cầu) bằng cách sử dụng
injectedFirstSolutionRouteshoặcinjectedSolutionConstraint. - Bạn cần có mã thông báo tuyến đường cho từng chặng của một kế hoạch tối ưu hoá để truyền đến SDK Điều hướng.
Đừng sử dụng Route Optimization API khi:
- Bạn cần theo dõi trực tiếp cách tài xế thực hiện kế hoạch; API trả về các hình nhiều đường đã lên kế hoạch, chứ không phải tuyến đường của xe theo thời gian thực. Hãy sử dụng Dịch vụ Fleet Engine.
- Bạn cần có tính năng chỉ đường từng chặng trong ứng dụng cho tài xế dọc theo tuyến đường được tối ưu hoá. Hãy sử dụng Navigation SDK cho Android.
- Bạn cần có tính năng chỉ đường từng chặng trong ứng dụng cho tài xế trên iOS dọc theo tuyến đường được tối ưu hoá. Thay vào đó, hãy sử dụng Navigation SDK cho iOS.
Route Optimization API: thiết lập
- Dịch vụ cần bật:
routeoptimization.googleapis.com - Xác thực: OAuth 2.0, Tài khoản dịch vụ
- Bắt đầu: Thiết lập Route Optimization API
- Tài liệu tham khảo: Tài liệu tham khảo về Route Optimization API
- Giá: Mức sử dụng và thanh toán cho Route Optimization API
- Chính sách: Chính sách về Route Optimization API
- Ghi chú phát hành: Ghi chú phát hành về Route Optimization API
Các gói Route Optimization API chính thức:
- npm:
@googlemaps/routeoptimization - pypi:
google-maps-routeoptimization - go:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routeoptimization
Route Optimization API: related products
- Thường dùng với: Navigation SDK cho Android, Navigation SDK cho iOS, Dịch vụ Fleet Engine, Maps JavaScript API
Route Optimization API: các lỗi thường gặp
- Vấn đề: Đối với các lệnh gọi REST đến điểm cuối chặn
OptimizeTours, thời hạn mặc định là 60 giây sẽ ghi đè mọitimeoutcủa nội dung yêu cầu lớn hơn 60 giây. Cách khắc phục: Đặt tiêu đềX-Server-Timeout(giây, không có hậu tố "s") để kéo dài thời hạn. Thư viện ứng dụng và gRPC mặc định là 3.600 giây. Xem /maps/documentation/route-optimization/timeouts. - Vấn đề: Giá trị
timeoutvà thời hạn được giới hạn ở mức 1.800 giây. Cách khắc phục: ĐặtallowLargeDeadlineDespiteInterruptionRiskthànhtrueđể cho phép tối đa 3.600 giây, chấp nhận rủi ro cao hơn về lỗi gián đoạn. Xem /maps/documentation/route-optimization/timeouts. - Vấn đề: Nếu không có tham số chi phí (ví dụ:
costPerHourhoặccostPerKilometer), trình tối ưu hoá sẽ coi tất cả giải pháp là như nhau. Cách khắc phục: Xác định các thông số chi phí cho xe phản ánh chi phí kinh doanh của bạn. Xem /maps/documentation/route-optimization/make-first-request. - Vấn đề: Các yêu cầu được xác thực bằng khoá API đều không thành công; mọi yêu cầu đều cần có mã thông báo OAuth. Cách khắc phục: Sử dụng mã thông báo OAuth có phạm vi
https://www.googleapis.com/auth/cloud-platform, chẳng hạn như thông qua Thông tin xác thực mặc định của ứng dụng hoặc tài khoản dịch vụ. Xem /maps/documentation/route-optimization/cloud-setup#create-an-oauth-token.
Những việc bạn có thể làm với Route Optimization API
Hãy xem hướng dẫn được liên kết bên dưới cho từng nhiệm vụ hoặc so sánh giữa các sản phẩm trong Trình khám phá chức năng.
- Trả về một kế hoạch giao hàng nhiều điểm dừng, được tối ưu hoá dựa trên các quy định ràng buộc về tuyến đường, chi phí, lô hàng và phương tiện.
- Trả về thời gian bắt đầu và kết thúc cho mỗi điểm dừng trong một kế hoạch giao hàng tối ưu hoá.
- Trả về thời gian di chuyển, thời gian trễ, thời gian nghỉ và thời gian chờ giữa mỗi điểm dừng trong một kế hoạch giao hàng tối ưu hoá.
- Trả về thông tin về tải trọng xe tại mỗi điểm dừng trong kế hoạch giao hàng được tối ưu hoá.
- Trả về thông tin chi phí cho mỗi lô hàng trong một kế hoạch giao hàng tối ưu.
- Trả về một hình nhiều đường được mã hoá cho tuyến đường giữa mỗi điểm dừng trong một kế hoạch giao hàng được tối ưu hoá.
- Trả về mã thông báo tuyến đường đi cho tuyến đường giữa mỗi điểm dừng trong kế hoạch giao hàng được tối ưu hoá.
- Trả về các chỉ số tổng hợp về lô hàng, xe và chi phí cho một kế hoạch giao hàng tối ưu.
- Chỉ định khung thời gian bắt đầu và kết thúc cho kế hoạch giao hàng nhiều điểm dừng.
- Chỉ định thời gian bắt đầu và kết thúc cũng như vị trí cho từng xe trong kế hoạch giao hàng nhiều điểm dừng.
- Chỉ định chi phí thời gian của xe cho từng xe trong kế hoạch giao hàng nhiều điểm dừng.
- Chỉ định các tham số mô hình chi phí cho kế hoạch giao hàng nhiều điểm dừng.
- Chỉ định các quy định ràng buộc về thời gian lấy hàng và thời gian giao hàng cho từng lô hàng trong kế hoạch giao hàng nhiều điểm dừng.
- Chỉ định phương tiện cho kế hoạch giao hàng nhiều điểm dừng.
- Chỉ định giới hạn tải trọng cho từng xe trong kế hoạch giao hàng nhiều điểm dừng.
- Chỉ định xem có xem xét thông tin giao thông trực tiếp cho kế hoạch giao hàng nhiều điểm dừng hay không.
- Xử lý hàng loạt yêu cầu tối ưu hoá kế hoạch giao hàng nhiều điểm dừng và ghi phản hồi vào Google Cloud Storage.
- Dành thời gian đỗ xe trước khi giao hàng.
- Ưu tiên các lượt ghé thăm gần nhau để thực hiện liên tiếp.
- Tránh quay đầu xe trên tuyến đường có nhiều điểm dừng. Thử nghiệm Lưu ý: Tính năng thử nghiệm; tuân theo các điều khoản và giới hạn trước khi phát hành rộng rãi.
- Tối ưu hoá để đạt được các mục tiêu đã xác định trước. Thử nghiệm Lưu ý: Tính năng thử nghiệm; tuân theo các điều khoản và giới hạn trước khi phát hành rộng rãi.
- Giao các lô hàng nặng hơn trước. Thử nghiệm Lưu ý: Tính năng thử nghiệm; tuân theo các điều khoản và giới hạn trước khi phát hành rộng rãi.