Fleet Engine 服務快速參考

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-ID HTTP 標頭設為 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 服務:常見錯誤

  • 問題:向 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 API reportBillableEvent。徵兆:合約專屬,而非 API 淘汰。遷移後,呼叫可能會傳回「Invalid Contract: This project [...] is not authorized to use FleetEngine.」(合約無效:這項專案 [...] 未獲授權使用 FleetEngine)。請參閱遷移指南。

Fleet Engine 服務的功能

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