Method: providers.vehicles.create

將與隨選共乘/外送服務供應商相關聯的新車輛例項化。每個 Vehicle 都必須有專屬的車輛 ID。

建立 Vehicle 時，必須提供下列 Vehicle 欄位：

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

建立 Vehicle 時，系統會忽略下列 Vehicle 欄位：

  • name
  • currentTrips
  • availableCapacity
  • currentRouteSegment
  • currentRouteSegmentEndPoint
  • currentRouteSegmentVersion
  • currentRouteSegmentTraffic
  • route
  • waypoints
  • waypointsVersion
  • remainingDistanceMeters
  • remainingTimeSeconds
  • eta_to_next_waypoint
  • navigationStatus

所有其他欄位皆為選用欄位，如有提供，則會使用。

HTTP 要求

POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

必要欄位。格式須為 providers/{provider}。提供者必須是 Google Cloud 專案的專案 ID (例如 sample-cloud-project)，而此呼叫所屬的服務帳戶必須隸屬於該專案。

查詢參數

參數
header

object (RequestHeader)

標準的 Fleet Engine 要求標頭。
vehicleId

string

必要欄位。專屬車輛 ID。須遵守下列限制：

  • 必須是有效的萬國碼 (Unicode) 字串。
  • 長度上限為 64 個半形字元。
  • 根據 Unicode 正規化表單 C 進行正規化處理。
  • 不得包含下列任一 ASCII 字元：「/」、「:」、「?」、「,」或「#」。

要求主體

要求主體包含 Vehicle 的例項。

回應主體

如果成功，回應主體會包含新建立的 Vehicle 例項。