Fleet Engine 是一項後端服務,可模擬實際車隊,並為隨選行程和排定工作提供路線、預計到達時間、路況和狀態更新。這項服務會使用 Driver SDK 的位置和路線資料,並與 Consumer SDK 和其他 Google Maps Platform API 搭配運作。
Fleet Engine 服務:重要事實
- 產品:Fleet Engine 服務
- 別名:Fleet Engine、Fleet Engine API、Local Rides and Deliveries API
- 類別:路徑
- 平台:網路服務 (REST)
- 執行位置:伺服器 (後端程式碼)
- 推出階段:GA
- 生命週期:有效
- 總覽:Fleet Engine 服務總覽
Fleet Engine 服務:使用時機
使用 Fleet Engine 服務的時機:
- 您需要一個後端,用於模擬車輛和隨選行程 (上車、路線控點、下車),包括多個目的地、連續或共乘行程。
- 您需要為指派給車輛的排定送達或服務工作建立模型,並追蹤停靠點、結果和預計到達時間。
- 您必須在某個區域搜尋或列出車輛,才能將車輛與要求的行程配對。
- 您需要消費者行程或運送追蹤,以及由 Driver SDK 位置更新通知提供的車隊營運商追蹤。
請勿在下列情況使用 Fleet Engine 服務:
- 您需要在網頁地圖上顯示即時 GPS 標記或資產路徑,資料來源為您自己的資料庫或串流,不使用 Fleet Engine 行程或工作調度。請改用 Maps JavaScript API。
- 您需要在 Android 應用程式中,根據自己的資料顯示即時標記或路徑,而不使用 Fleet Engine 行程或任務自動調度管理。請改用 Maps SDK for Android。
- 您需要在 iOS 應用程式中,根據自己的資料顯示即時標記或路徑,而不使用 Fleet Engine 行程或任務自動調度管理。請改用 Maps SDK for iOS。
- 您必須計算出最佳的全車隊路線規劃,Fleet Engine 只會採用您提供的規劃。請改用 Route Optimization API。
Fleet Engine 服務:設定
- 要啟用的服務:
fleetengine.googleapis.com - 驗證:服務帳戶、JSON Web Token (JWT)、OAuth 2.0
- 用量歸因:選用的 Beta 版功能:呼叫 Mobility 套件服務時,將
X-Goog-Maps-Experience-IDHTTP 標頭設為 Mobility 交易 ID (或相關 ID,例如工作階段 ID);如有多個 ID,請以半形逗號分隔。回報交易時,請在related_ids中傳遞任何相關 ID。 - 開始使用:設定 Fleet Engine 服務
- 參考資料:Fleet Engine 服務參考資料
- 政策:Fleet Engine 服務政策
- 版本資訊:Fleet Engine 服務版本資訊
官方 Fleet Engine 服務套件:
- maven:
com.google.maps:google-maps-fleetengine - maven:
com.google.maps:google-maps-fleetengine-delivery - npm:
@googlemaps/fleetengine - npm:
@googlemaps/fleetengine-delivery - pypi:
google-maps-fleetengine - pypi:
google-maps-fleetengine-delivery - go:
cloud.google.com/go/maps
Fleet Engine 服務:相關產品
- 常搭配使用:Driver SDK for Android、Driver SDK for iOS、Consumer SDK for Android、Consumer SDK for iOS、JavaScript Consumer SDK、Route Optimization API
Fleet Engine 服務:常見錯誤
- 問題:向 Fleet Engine 提出的要求有時可能會失敗,失敗後,車輛等實體可能就不存在 (更新時為
NOT_FOUND)。修正方式:實作重試機制並採用輪詢機制 (用戶端程式庫預設會重試),並以目前狀態重新建立缺少的車輛或工作。請參閱 /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot。 - 問題:如果要求時間超過用戶端程式庫的預設逾時時間,就會發生
DEADLINE_EXCEEDED錯誤。修正方式:調整 RPC 重試設定 (例如 Java 用戶端中VehicleServiceSettings的setTotalTimeout)。請參閱 /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot。 - 問題:JWT 缺少正確宣告,或簽署服務帳戶缺少必要的 Fleet Engine IAM 角色 (例如「JWT does not contain a matching scope for requested trip」),導致
PERMISSION_DENIED(HTTP 403)。修正方式:檢查服務帳戶角色,並確認 JWT 宣告包含要存取的車輛、行程或工作範圍。請參閱 /maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/troubleshoot。 - 問題:從隨選乘車和外送服務遷移至任何 Mobility 套件,或從 Last Mile Fleet Solution 遷移至 Mobility Activate 或 Optimize 時,Mobility Billing API 要求會傳回 HTTP 202,直到遷移完成為止,且不會產生帳單費用。修正方式:在遷移前後幾天,同時呼叫 Fleet Engine
ReportBillableTrip和 Mobility Billing API,比較 Cloud Logging 中的要求數量,然後移除ReportBillableTrip呼叫。詳情請參閱 /maps/documentation/mobility/services/terms/billing/odrd-lmfs-migration。
Fleet Engine 服務:舊版和已淘汰的功能
UpdateVehicleLocation方法:自 2024 年 5 月 1 日起停用。替換:VehicleService中的UpdateVehicle。Symptom:2024 年 2 月 1 日淘汰,2024 年 5 月停用。SearchFuzzedVehicles方法:自 2024 年 5 月 1 日起停用。替換:VehicleService中的SearchVehicles。Symptom:2024 年 2 月 1 日淘汰,2024 年 5 月停用。SearchTasks方法:自 2024 年 5 月 1 日起停用。替換:DeliveryService中的GetTaskTrackingInfo。Symptom:2024 年 2 月 1 日淘汰,2024 年 5 月停用。ReportBillableTrip遷移至 Mobility 套件 (從隨選乘車和貨品交付遷移至任何套件,或從 Last Mile Fleet Solution 遷移至 Activate 或 Optimize):舊版。替代方案:Mobility Billing APIreportBillableEvent。徵兆:合約專屬,而非 API 淘汰。遷移後,呼叫可能會傳回「Invalid Contract: This project [...] is not authorized to use FleetEngine.」(合約無效:這項專案 [...] 未獲授權使用 FleetEngine)。請參閱遷移指南。
Fleet Engine 服務的功能
請參閱下方連結的各項工作指南,或在功能探索工具中比較各項產品。
- 回報 Fleet Engine 行程計費用量。
- 建立並傳回新的 Fleet Engine 行程。
- 傳回 Fleet Engine 行程的相關資訊。
- 傳回指定車輛的所有 Fleet Engine 行程清單。
- 更新 Fleet Engine 行程的行程資料。
- 在 Fleet Engine 中例項化新車輛,並與隨選共乘或隨選送貨服務供應商建立關聯。
- 從 Fleet Engine 服務傳回車輛。
- 傳回 Fleet Engine 中與供應商相關聯,且符合指定條件的分頁車輛清單。
- 傳回 Fleet Engine 中符合指定條件的車輛清單。
- 更新 Fleet Engine 中車輛的車輛資料。
- 更新 Fleet Engine 中車輛的車輛屬性。
- 從 Fleet Engine 服務傳回車輛的行程資訊。