Tài liệu tham khảo nhanh về Route Optimization API

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 injectedFirstSolutionRoutes hoặc injectedSolutionConstraint.
  • 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

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: 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ọi timeout củ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ị timeout và thời hạn được giới hạn ở mức 1.800 giây. Cách khắc phục: Đặt allowLargeDeadlineDespiteInterruptionRisk thành true để 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ụ: costPerHour hoặc costPerKilometer), 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.