簡介:建立車輛

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

後續步驟