簡介：建立車輛

如要瞭解 Fleet Engine 中的車輛運作方式，請參閱 Fleet Engine 基本概念部分的下列指南：

本節文件說明如何在 Fleet Engine 中建立及管理車輛。您可以在 Fleet Engine 伺服器環境中建立車輛，以反映實際營運中的車輛。Fleet Engine 車輛也應對應至後端系統中用於指派車輛和路線的車輛。

您可以使用 gRPC 或 REST，透過建立方法建立車輛資源。為簡化說明，本指南中的欄位名稱採用 gRPC 標記法。

隨選行程

排定的工作

車輛要求

無論是隨選或排定時間的工作功能，您都可以透過發出含有欄位的要求訊息來建立及更新車輛，摘要如下：

  1. 父項：與 Google Cloud 專案 ID 相關聯的字串，用於填入車輛執行個體的名稱欄位。

  2. 車輛 ID：用於填入車輛 name 欄位的專屬字串。

  3. 車輛執行個體及其必填欄位。這些欄位取決於您使用的 Fleet Engine 功能。

要求主體中的資訊會因要求性質而異。詳情請參閱各指南。

驗證和授權權杖

對 Fleet Engine 發出的要求也必須提供正確的存取憑證。 本指南中的範例具有下列假設：

  • gRPC 範例假設使用 Java 適用的授權程式庫。
  • REST 範例會說明 HTTP 要求標頭，其中必須包含 Authorization 欄位，且值為 Bearer <token>，其中 <token> 是您核發的 JSON 網頁權杖。

詳情請參閱「設定 Fleet Engine」指南。

車輛資源欄位

車輛資源包含下列欄位：

  • 僅供輸出的欄位。服務設定為其他方法輸出內容的欄位，無法直接設定。這類型的其中一個重要欄位是 name 欄位。根據 Google AIP 對使用者指定 ID 的指引，Fleet Engine 會忽略車輛 name 欄位的所有提供值。如果您為這些欄位提供值，Fleet Engine 會傳回錯誤。
  • 必填欄位。在隨選行程服務中建立車輛時，必須在建立時設定特定欄位。在排定工作服務中建立的車輛沒有必要的車輛資源欄位。
  • 選填欄位。這兩項服務都有可在建立時或之後設定的欄位。這些資訊會顯示在您所用服務的參考指南中。

車輛名稱 (僅供輸出)

隨選行程和排定工作服務的 name 欄位完全相同。建立車輛時，Fleet Engine 會根據您在車輛建立時設定的兩個欄位定義該欄位：

  • 父項：與 Google Cloud 專案 ID 相關聯的字串，格式為 providers/{provider}，其中 {provider} 是 Cloud 專案的 ID。為特定專案建立的每部車輛都會有相同的父路徑。

    您在此參照的 Cloud 專案也必須包含所用服務的 Fleet Engine 服務帳戶角色。如需這些服務帳戶的清單，請參閱「服務帳戶」。Fleet Engine 不支援從多個 Google Cloud 專案存取。

  • 車輛 ID，車隊中所有車輛的 ID 必須不重複，且為有效的 Unicode 字串。這是車輛的資源 ID。無論是隨選行程或預定停靠站，都會使用這項資訊將行程或工作與完成行程或工作的車輛建立關聯。

在 Google Cloud 服務中，所有 API 都必須以字串表示資源。詳情請參閱「Fleet Engine 中的資源命名」。

實體的專屬 ID

資源呼叫中使用的實體專屬 ID 格式和值對 Fleet Engine 而言是不透明的。請確認 ID 不含任何個人識別資訊 (PII)，例如駕駛人的電話號碼。

車輛再利用

車輛完成特定行程的所有停靠點後，仍可在 Fleet Engine 中重複使用 7 天，也就是說，你可以在後續工作天重複使用車輛，不必建立新車輛。每次重複使用車輛時，Fleet Engine 都會重設車輛的可用性，並重新開始 7 天倒數。

建議您定期更新車輛位置，確保車輛在 Fleet Engine 中保持可用狀態。只要新欄位值與現有值不同，更新 Vehicle 實體中的大多數其他欄位，也會延長實體的生命週期。

注意：Vehicle 實體上的部分欄位 (例如 device_settings) 純粹是偵錯資訊，Fleet Engine 不會保留這些資訊。更新這些項目不會延長 Vehicle 實體的生命週期。

為提升系統分析成效，建議每天重複使用相同的駕駛人車輛 ID 配對。方法是使用與先前預約停靠或隨選行程的司機相關聯的車輛 ID。

後續步驟