簡介：建立車輛

如要瞭解車輛在 Fleet Engine 中的運作方式，請參閱 Fleet Engine 重要資訊部分的以下指南：

本節中的文件說明如何在 Fleet Engine 中建立及管理車輛。您可以在 Fleet Engine 伺服器環境中建立車輛，以便模擬實際運作中的實際車輛。Fleet Engine 車輛也應與後端系統中用於車輛指派和路線規劃的車輛相符。

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

隨選行程

排定的工作

車輛要求

無論是按需還是排程工作功能，您都可以透過發出含有欄位的訊息來建立及更新車輛，如下所示：

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

  2. 車輛 ID：用於填入車輛 name 欄位的不重複字串。

  3. 車輛例項及其必填欄位。這些欄位取決於您使用的車隊引擎功能。

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

驗證和授權權杖

向 Fleet Engine 提出要求時，也必須提供正確的存取憑證。本指南的範例假設如下：

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

詳情請參閱「設定 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 必須是車隊中所有車輛的專屬 ID，且必須是有效的萬國碼字串。這是車輛的資源 ID。無論是隨選行程還是預約停靠站，都會使用這個屬性，將行程或任務與完成行程的車輛建立關聯。

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

專屬實體 ID

Fleet Engine 無法瞭解資源呼叫中使用的不重複實體 ID 格式和值。請確認 ID 不含任何個人識別資訊 (PII)，例如駕駛人的電話號碼。

車輛再利用

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

如要讓車輛持續顯示在車隊引擎中，建議您定期更新車輛位置。只要新欄位值與現有值不同，Vehicle 實體中大多數其他欄位的更新作業也會延長其生命週期。

注意：Vehicle 實體 (例如 device_settings) 中的部分欄位純粹是偵錯資訊，不會由車隊引擎保留。更新這些實體不會延長 Vehicle 實體的生命週期。

為改善系統分析，建議您每天重複使用相同的駕駛人-車輛 ID 配對。方法是使用與先前預約停靠站或隨選行程的駕駛人相關聯的相同車輛 ID。

後續步驟