什麼是 Fleet Engine 服務?

Fleet Engine 是後端服務,可與您用於管理客戶運輸服務的系統整合。它可與各種 API 和 SDK 互通,以改善地圖、路線和位置管理功能。

Fleet Engine 會為以實際車隊為模型的車輛實體提供路線和狀態更新資訊。當系統將車輛進度更新資料傳送至車隊引擎時,車隊引擎會使用 Driver SDK 提供的即時車輛位置和路線資訊,針對車輛行程提供準確的報表,包括預估抵達時間、路況資訊和車輛可用性。

Fleet Engine

Fleet Engine 服務可搭配下列兩項 Mobility Service 服務使用:

  • 隨選行程:在這個服務中,Fleet Engine 會模擬行程的生命週期,從起點、中途停靠站到下車地點。在行程生命週期中,車輛會經過乘客預約行程的上下車地點、中途停靠站和下車地點。如要進一步瞭解預約行程,請參閱預約行程說明文件。
  • 排程工作:在這個服務中,Fleet Engine 會模擬運送或服務工作的生命週期,在行程中的每個停靠站,駕駛員都必須完成一或多項排程工作。工作可能包括提交套件或完成服務呼叫。如要進一步瞭解排程工作,請參閱「排程工作」說明文件。

Fleet Engine 的用途

您可以使用 Fleet Engine 元件執行下列操作:

  • 啟用消費者行程追蹤功能:針對隨選行程,您可以使用 Fleet Engine 的消費者體驗功能,並將消費者 SDK 整合至行動或網頁應用程式。如此一來,消費者就能使用同一個應用程式提出行程要求,並追蹤行程。
  • 為消費者提供即時包裹資訊:針對排程任務,您可以使用 Fleet Engine 的消費者體驗功能,並將 JavaScript 消費者 SDK 整合至網頁應用程式。這樣一來,您就能為消費者提供近乎即時的包裹狀態更新。SDK 提供內建篩選器和資料隱私權,讓消費者只看到與訂單相關的資訊。
  • 設計車隊營運商解決方案:如要安排任務,請使用 JavaScript 車隊追蹤程式庫,讓車隊營運商能更妥善地協調及管理車輛指派作業。
  • 提升駕駛員體驗:Driver SDK 是行動應用程式工具包,也是 Fleet Engine 的基本元件。它會使用車輛的功能。有了這個 SDK,您的駕駛應用程式就能管理工作指派,並啟用駕駛員導航和路線規劃功能。在核心層面,SDK 會在駕駛人開始行駛時,使用事件監聽器將位置更新資料傳送至 Fleet Engine。並傳送車輛狀態信號給 Fleet Engine。有了這個 SDK,駕駛員就能使用單一應用程式管理指派任務,並以與一般消費者版 Google 地圖相同的方式導航,而不必切換至其他應用程式。

具體來說,您可以透過這些解決方案提供下列資訊:

隨選行程

  • 駕駛人車輛的即時路徑修正位置。
  • 實際駕駛路線,含即時路況資訊。
  • 上車和下車地點的預估到達時間。
  • 追蹤單一/多個目的地和接連行程。
  • 透過同一路線為多名乘客提供共乘服務。
  • 列出特定區域內的所有車輛,以便找到最符合要求行程的車輛。

排定的工作

  • 即時位置更新會顯示在地圖上。
  • 自動調整預估抵達時間,反映路況等變化情況。
  • 已完成的工作和待處理的停靠站,以便深入瞭解可能的問題。
  • 停靠站數和距離,讓客戶更放心。

Fleet Engine 的運作方式

本節將概略說明每項 Mobility 服務的 Fleet Engine 系統運作方式。

隨選行程

下圖顯示隨選行程的兩個重點:司機啟用與 Fleet Engine 共用位置資訊的當天開始時間,以及使用 Fleet Engine 元件簡化行程管理的簡易檢視畫面。如要查看行程程序的詳細資料,請參閱「什麼是行程?叫車服務說明文件中。

排定的工作

下圖顯示單一駕駛員的典型出貨工作日矩陣,以及他們如何透過 Fleet Tracking 程式庫在 Fleet Engine 系統中處理工作。

注意:系統可以同時使用貨件追蹤或車隊追蹤功能。透過貨物追蹤功能,Fleet Engine 會篩選貨物和駕駛員資訊,讓客戶只看到與貨物相關的資訊。

Fleet Engine 架構

本節將說明不同 Fleet Engine 服務的系統架構。這兩項服務都會使用以下項目:

  • 車輛:隨選行程和預約任務會使用車輛,模擬你在業務中用來執行作業的實際車輛。在 Fleet Engine 中,車輛實體會透過與 Driver SDK 整合的駕駛員應用程式,接收其相關聯的實際車輛提供的位置資訊。Fleet Engine 車輛在兩項服務中基本上是平行實體,但有些差異。請參閱「車輛簡介」,瞭解 Fleet Engine 中的車輛。
  • Driver SDK:無論是按需任務還是排程任務,Driver SDK 都是基本元件。Driver SDK 會與駕駛員應用程式整合,並為 Fleet Engine 提供位置更新串流,以及 Fleet Engine 用來回報行程即時狀態的路線資訊,以及預估抵達時間和交通資料等其他資訊。
  • 消費者 SDK:消費者 SDK 是隨選和排程任務的重要優點,可用於向消費者回報其乘車、外送餐點或包裹預約送達的狀態。

隨選行程

如要瞭解車輛、行程和 SDK,請參閱隨選行程的相關說明文件:

  1. 車輛簡介
  2. 隨選行程
  3. 供叫車行程使用的 Driver SDK
  4. 隨選行程的消費者 SDK

排定的工作

如要瞭解提交媒介、工作和 SDK,請參閱排定工作相關說明文件:

  1. 車輛簡介
  2. 排定的工作
  3. 用於排程工作 Driver SDK
  4. 用於排程工作任務的消費者 SDK

資源

隨選行程

車輛
服務 RESTv1.providers.vehicles
gRPCmaps.fleetengine.v1.VehicleService
資源名稱 providers/{provider}/vehicles/{vehicle}
行程
服務 RESTv1.providers.trips
gRPCmaps.fleetengine.v1.TripService
資源名稱 providers/{provider}/trips/{trip}

排定的工作

運送車輛
資源 RESTproviders.deliveryVehicles
gRPCmaps.delivery.v1
資源名稱 providers/{provider}/deliveryVehicles/{vehicle}
工作
服務 RESTproviders.tasks
gRPCmaps.fleetengine.delivery.v1.Task
資源名稱 providers/{provider}/tasks/{task}

Fleet Engine 中的資源命名

在 Fleet Engine 中,如同所有以 Google Cloud 為基礎的服務,資源都會有專屬的 names 識別碼,以字串格式提供。資源名稱的一部分是資源 ID,您在發出建立要求時會提供這項資訊。不過,Fleet Engine 資源沒有 ID 欄位,而是有僅輸出名稱欄位,其中包含資源 ID。

Fleet Engine 會使用相對資源名稱。這些 ID 包括集合 ID 和資源 ID,並以表示階層結構的方式進行結構化。

  • 集合 ID:集合會保留資源或其他集合。

隨選行程

三個集合:providersvehiclestrips

排定的工作

三個集合:providersdeliveryVehiclestasks

資源 ID:參考文件中的資源 ID 會在名稱欄位中以大括號表示。這些是您在發出建立要求時提供的 ID 變數。

隨選行程

  • {provider}:您的 Cloud 專案 ID。每個專案只需建立一次。
  • {vehicle}:車輛資源,用於每次建立車輛,通常會重複使用於相同的駕駛人-車輛組合。
  • {trip}:行程資源,用於每趟行程,通常不會重複使用。

排定的工作

  • {provider}:您的 Cloud 專案 ID。每個專案只會建立一次。
  • {vehicle}:用於建立每輛車輛的運送車輛資源,通常會用於相同的駕駛員-車輛組合。
  • {task}:工作資源,用於每項工作,通常不會重複使用。

如需更多詳細資訊,請參閱 Google Cloud API 說明文件中的「資源名稱」。

Fleet Engine 的 Google Cloud 記錄

Fleet Engine 提供基本記錄服務,可讓您儲存 API 要求和回應酬載。您可以利用這些記錄檔偵錯整合作業、建立監控指標,以及分析流量模式。

詳情請參閱 Cloud Logging

如何使用 Fleet Engine

1 設定 Cloud 專案。

除了啟用相關 API 外,您還會在這個步驟中建立各種服務帳戶角色。

Fleet Engine API 和 SDK 必須使用透過 Cloud 控制台建立的服務帳戶簽署的 JSON Web Token (JWT)。請按照建立 Fleet Engine 專案中的操作說明進行。如要進一步瞭解這些角色,請參閱「服務帳戶角色」。

2 確認設定 建立服務帳戶後,請確認設定已完成,並且可以建立車輛。這個步驟可確保您解決了在專案設定期間可能發生的常見授權問題。請按照「驗證設定」下方的指示操作。
3 建立第一個歷程 這包括使用一組座標建立單一車輛,用於代表隨選行程或排程任務沿途的停靠站。如需進一步瞭解,請參閱隨選行程排程任務的總覽內容。
4 測試整合 Fleet Engine 服務和元件需要車隊的即時資料。設計、開發及部署應用程式給車隊駕駛人可能需要一段時間。因此,建議您先使用模擬資料探索整合作業,再進行全面部署。詳情請參閱「設定車隊引擎」。

後續步驟

  1. 瞭解車隊引擎車輛
  2. 瞭解隨選行程排程任務
  3. 設定 Fleet Engine