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），进行此调用的服务账号所属的 Google Cloud 项目所属的项目。

查询参数

参数
header

object (RequestHeader)

标准 Fleet Engine 请求标头。
vehicleId

string

必需。唯一车辆 ID。需遵循以下限制：

  • 必须是有效的 Unicode 字符串。
  • 长度上限为 64 个字符。
  • 根据 Unicode 标准化形式 C 进行标准化。
  • 不得包含以下任何 ASCII 字符：“/”“:”“?”“,”或“#”。

请求正文

请求正文包含一个 Vehicle 实例。

响应正文

如果成功，响应正文将包含一个新创建的 Vehicle 实例。