VehicleJourneySegment

表示车辆的行程路段(从上一个停靠站到当前停靠站)。如果是第一个有效的经停点,则是从车辆的当前位置到此经停点。

JSON 表示法
{
  "stop": {
    object (VehicleStop)
  },
  "drivingDistanceMeters": integer,
  "drivingDuration": string,
  "path": [
    {
      object (LatLng)
    }
  ]
}
字段
stop

object (VehicleStop)

指定停靠站位置,以及与停靠站关联的 Task。如果此行程路段是 JourneySharingInfo 的一部分,则 VehicleStop 的某些字段可能不会显示。

drivingDistanceMeters

integer

仅限输出。从上一个经停点到此经停点的行程距离。如果当前停靠站是行程路段列表中的第一个停靠站,则起点是将此经停点添加到列表中时记录的车辆位置。如果此旅程路段是“JourneySharingInfo”的一部分,则此字段可能不存在。

drivingDuration

string (Duration format)

仅限输出。从上一站到此站的行程时间。如果当前停靠站是行程路段列表中的第一个停靠站,则起点是将此经停点添加到列表中时记录的车辆位置。

如果此字段在路径 Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) 或 Task.remainingVehicleJourneySegments[0].drivingDuration (REST) 中定义,则可以使用 DeliveryVehicle.remaining_duration (gRPC) 或 DeliveryVehicle.remainingDuration (REST) 中的值进行填充。这可提供从驾驶应用的最新已知位置出发的剩余驾驶时长,而不是从上一个经停点开始的驾驶时间。

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

path[]

object (LatLng)

仅限输出。从上一站到此站的路径。如果当前经停点是行程路段列表中的第一个停靠站,则此值为将经停点添加到列表中时从车辆当前位置到此经停点的路径。如果此旅程路段是“JourneySharingInfo”的一部分,则此字段可能不存在。

如果此字段在路径 Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) 或 Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) 中定义,则可以使用从 DeliveryVehicle.current_route_segment (gRPC) 或 DeliveryVehicle.currentRouteSegment (REST) 解码的 LatLng 进行填充。这将提供从驾驶应用的最新已知位置开始的驾车路径,而不是从上一站开始的路径。

VehicleStop

描述车辆停下来执行一个或多个 Task 的点。

JSON 表示法
{
  "plannedLocation": {
    object (LocationInfo)
  },
  "tasks": [
    {
      object (TaskInfo)
    }
  ],
  "state": enum (State)
}
字段
plannedLocation

object (LocationInfo)

必需。相应经停点的位置。请注意,Task 中的位置可能与此位置不完全匹配,但会在此位置附近。tasks.get 调用的响应中不会填充此字段。

tasks[]

object (TaskInfo)

要在此经停点执行的 Task 列表。tasks.get 调用的响应中不会填充此字段。

state

enum (State)

VehicleStop 的状态。tasks.get 调用的响应中不会填充此字段。

TaskInfo

有关在此停靠站执行的任务的其他信息。

JSON 表示法
{
  "taskId": string,
  "taskDuration": string,
  "targetTimeWindow": {
    object (TimeWindow)
  }
}
字段
taskId

string

任务 ID。tasks.get 调用的响应中不会填充此字段。任务 ID 存在以下限制:

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

string (Duration format)

仅限输出。执行任务所需的时间。

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

targetTimeWindow

object (TimeWindow)

仅限输出。应完成任务的时间范围。此字段仅在对 deliveryVehicles.get 的响应中设置。

VehicleStop 的当前状态。

枚举
STATE_UNSPECIFIED 未知。
NEW 已创建,但尚未进行主动路由。
ENROUTE 已分配且正在转送。
ARRIVED 已到达经停点。假设车辆正在前往下一个经停点时,之前的所有停靠站都已完成。