簡介：建立車輛

如要瞭解車輛在 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 Web Token。

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

車輛資源欄位

車輛資源具有以下幾個欄位：

  • 僅限輸出的欄位。服務將欄位設為 且無法直接設定。在這個重要的欄位中 類型為 name 欄位。Fleet Engine 會忽略為 name Google AIP 根據使用者指定指示的車輛磁場 ID如要為這些欄位提供值，Fleet Engine 傳回錯誤。
  • 必填欄位。在隨選行程服務中建立的車輛需要 建立特定欄位時排定時間中建立的車輛 工作服務沒有必要的車輛資源欄位。
  • 選填欄位。兩項服務都有欄位可在建立時設定 或之後/之後您可以在 您使用的服務。

車輛名稱 (僅限輸出)

如果是以量計價行程和已排定的工作，name 欄位將完全相同 免費 Google Cloud 服務Fleet Engine 會在您建立車輛時定義欄位， 建立車輛時設定的兩個欄位：

  • 父項：與 表單 providers/{provider}，其中 {provider} 是您的 Cloud ID 專案。為特定專案建立的每個車輛都會有相同的 父項路徑。

    您在這裡參照的 Cloud 專案也必須含有 Fleet Engine 所用服務的服務帳戶角色請參閱服務帳戶以瞭解 當中包含這些服務帳戶的清單Fleet Engine 不支援下列來源的存取權： 多項 Google Cloud 專案

  • 車輛的 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 每天配對請使用與 之前排定的停靠站或隨選行程的司機。

後續步驟