REST Resource: providers.deliveryVehicles

{
  "name": string,
  "lastLocation": {
    object (DeliveryVehicleLocation)
  },
  "navigationStatus": enum (DeliveryVehicleNavigationStatus),
  "currentRouteSegment": string,
  "currentRouteSegmentEndPoint": {
    object (LatLng)
  },
  "remainingDistanceMeters": integer,
  "remainingDuration": string,
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegment)
    }
  ],
  "attributes": [
    {
      object (DeliveryVehicleAttribute)
    }
  ],
  "type": enum (DeliveryVehicleType)
}

string

此配送车辆的唯一名称。格式为 providers/{provider}/deliveryVehicles/{vehicle}。

object (DeliveryVehicleLocation)

配送车辆上次报告的位置。

enum (DeliveryVehicleNavigationStatus)

配送车辆的导航状态。

string (bytes format)

编码后的多段线，用于指定导航系统建议前往下一个航路点的路线。当到达或经过某个经停点以及导航重新路线时，驾驶员应用会更新此值。对于分配给车辆的所有有效任务，系统会以 Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) 或 Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) 的形式返回这些 LatLng。

在某些情况下，此字段可能无法用于填充 Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) 或 Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST)：

• currentRouteSegment 的端点与 DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) 或 DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST) 不匹配。

• 驾驶员应用最近未更新其位置信息，因此此字段的上次更新值可能已过时。

• 驾驶员应用最近更新了其位置，但 currentRouteSegment 已过时，并指向之前的车辆停止点。

在这些情况下，车队引擎会在此字段中填充从最近经过的 VehicleStop 到即将到达的 VehicleStop 的路线，以确保此字段的使用方拥有有关配送车辆当前路线的最佳可用信息。

使用 base64 编码的字符串。

object (LatLng)

currentRouteSegment 结束的位置。此字段目前未由驱动程序应用填充，但您可以在 deliveryVehicles.patch 调用中提供此字段。它是相应车站的 LatLng，或 currentRouteSegment 的最后一个 LatLng。然后，Fleet Engine 会尽力插值到实际的 VehicleStop。

如果 currentRouteSegment 字段为空，则 deliveryVehicles.patch 调用会忽略此字段。

integer

currentRouteSegment 的剩余行驶距离。驾驶员应用通常会提供此字段，但在某些情况下，车队引擎会替换应用发送的值。如需了解详情，请参阅 DeliveryVehicle.current_route_segment。对于分配给传送车辆的所有有效 Task，系统都会在 Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) 或 Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) 中返回此字段。

如果 currentRouteSegment 字段为空，车队引擎会忽略 UpdateDeliveryVehicleRequest 中的此字段。

string (Duration format)

currentRouteSegment的剩余行驶时间。驾驶员应用通常会提供此字段，但在某些情况下，车队引擎会替换应用发送的值。如需了解详情，请参阅 DeliveryVehicle.current_route_segment。对于分配给传送车辆的所有有效任务，系统会在 Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) 或 Task.remainingVehicleJourneySegments[0].drivingDuration (REST) 中返回此字段。

如果 currentRouteSegment 字段为空，Fleet Engine 会忽略 UpdateDeliveryVehicleRequest 中的此字段。

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。

object (VehicleJourneySegment)

分配给此交付车辆的行程细分，以车辆最近报告的位置为起点。系统不会在 deliveryVehicles.list 的响应中填充此字段。

object (DeliveryVehicleAttribute)

自定义配送车辆属性的列表。一个配送车辆最多可以有 100 个属性，并且每个属性都必须具有唯一的键。

enum (DeliveryVehicleType)

此送货车辆的类型。如果未设置，则默认为 AUTO。

{
  "key": string,
  "value": string,

  // Union field delivery_vehicle_attribute_value can be only one of the
  // following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field
  // delivery_vehicle_attribute_value.
}

string

属性的键。

string

属性的值。

string

字符串类型的属性值。

注意：这与最终会被弃用的 value 字段相同。对于创建或更新方法，可以使用任一字段，但强烈建议使用 stringValue。如果同时设置了 stringValue 和 value，它们必须相同，否则系统会抛出错误。响应中会填充这两个字段。

boolean

布尔类型的属性值。

number

双精度属性值。