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:設定
- 要啟用的服務:
routeoptimization.googleapis.com - 驗證:OAuth 2.0、服務帳戶
- 開始使用:設定 Route Optimization API
- 參考資料:Route Optimization API 參考資料
- 定價:Route Optimization API 用量與計費
- 政策:Route Optimization API 政策
- 版本資訊: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:相關產品
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 的用途
請參閱下方連結的各項工作指南,或在功能探索工具中比較各項產品。
- 傳回多點運送計畫,並根據指定的路線、費用、運送和車輛限制進行最佳化。
- 傳回最佳化配送方案中每個停靠點的開始和結束時間。
- 傳回最佳化配送方案中,各停靠點之間的行程、延遲、休息和等待時間長度。
- 傳回最佳化配送方案中每個停靠點的車輛載重資訊。
- 傳回最佳化運送方案中每筆運送訂單的費用資訊。
- 傳回最佳化配送方案中各停靠點之間路線的編碼折線。
- 傳回導航路線權杖,用於最佳化配送計畫中各停靠點之間的路線。
- 傳回匯總的運送、車輛和費用指標,以便制定最佳配送方案。
- 指定多站配送計畫的開始和結束時間範圍。
- 在多停靠站配送計畫中,指定每輛車的開始和結束時間、可用性和位置。
- 在多站配送計畫中,為每輛車指定車輛時間成本。
- 指定多停靠站配送方案的成本模型參數。
- 在多站運送計畫中,為每筆運送訂單指定取貨和運送時間限制。
- 為多點配送計畫指定車輛。
- 為多站配送計畫中的每輛車指定載重限制。
- 指定是否要考量多站配送計畫的即時路況資訊。
- 批次處理多站點配送計畫最佳化要求,並將回應寫入 Google Cloud Storage。
- 預留停車時間,再進行配送。
- 優先安排連續造訪鄰近地點。
- 避免在多停靠站車輛路線中迴轉。實驗功能 注意:實驗功能,須遵守正式發布前條款和限制。
- 根據預先定義的目標進行最佳化。實驗功能 注意:實驗功能,須遵守正式發布前條款和限制。
- 先配送較重的貨物。實驗功能 注意:實驗功能,須遵守正式發布前條款和限制。