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 实例。