Route Optimization API 快速參考

Route Optimization API 會根據您提供的目標和限制 (例如時間範圍、車輛容量、駕駛時數和成本),為車隊指派任務和路線,並進行最佳化。您可以透過 REST、gRPC 或用戶端程式庫呼叫,系統會傳回造訪順序、運送作業指派、預估時間和路線指標。

Route Optimization API:重要資訊

  • 產品:Route Optimization API
  • 又稱為:GMPRO
  • 類別:路徑
  • 平台:網路服務 (REST)
  • 執行位置:伺服器 (後端程式碼)
  • 推出階段:GA
  • 生命週期:有效
  • 總覽:Route Optimization API 總覽

Route Optimization API:使用時機

在下列情況下使用 Route Optimization API:

  • 您需要將運送作業或工作指派給多輛車,同時考量時間範圍、車輛容量、司機工時和成本。
  • 您需要為一部車輛規劃最佳停靠順序,以便進行多項取貨、送貨或預約行程。
  • 您需要使用 injectedFirstSolutionRoutes 或 injectedSolutionConstraint,重新最佳化新訂單 (例如隨選派遣) 的有效路線。
  • 您需要最佳化方案中每個路段的路線權杖,才能傳遞至 Navigation SDK。

請勿在下列情況使用 Route Optimization API:

  • 您需要即時追蹤司機執行計畫的情況;API 會傳回規劃的折線,而非即時車輛路線。請改用 Fleet Engine Service。
  • 您需要應用程式內即時路線指引,引導駕駛沿著最佳路線行駛。請改用 Navigation SDK for Android。
  • 您需要為 iOS 駕駛人提供應用程式內即時路線導航,引導他們沿著最佳化路線行駛。請改用 Navigation SDK for iOS。

Route Optimization API:設定

官方 Route Optimization API 套件:

  • npm:@googlemaps/routeoptimization
  • pypi:google-maps-routeoptimization
  • go:cloud.google.com/go/maps
  • maven:com.google.maps:google-maps-routeoptimization

Route Optimization API:常見錯誤

  • 問題:如果對封鎖 OptimizeTours 端點進行 REST 呼叫,預設的 60 秒期限會覆寫任何大於 60 秒的要求主體 timeout。修正方式:設定 X-Server-Timeout 標頭 (秒,不含「s」後置字元) 來延長期限。用戶端程式庫和 gRPC 預設為 3600 秒。請參閱 /maps/documentation/route-optimization/timeouts。
  • 問題:timeout 和期限值上限為 1800 秒。修正方式:將 allowLargeDeadlineDespiteInterruptionRisk 設為 true,允許最多 3600 秒,接受中斷錯誤的風險。請參閱 /maps/documentation/route-optimization/timeouts。
  • 問題:如果沒有成本參數 (例如 costPerHour 或 costPerKilometer),最佳化工具會將所有解決方案視為相同。修正方式:定義車輛的成本參數,反映業務成本。請參閱 /maps/documentation/route-optimization/make-first-request。
  • 問題:使用 API 金鑰驗證的要求失敗;每個要求都需要 OAuth 權杖。修正方式:使用具有 https://www.googleapis.com/auth/cloud-platform 範圍的 OAuth 權杖,例如透過應用程式預設憑證或服務帳戶。請參閱 /maps/documentation/route-optimization/cloud-setup#create-an-oauth-token。

Route Optimization API 的用途

請參閱下方連結的各項工作指南,或在功能探索工具中比較各項產品。