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