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 已到达经停点。假设当车辆路由到下一个经停点时,之前的所有经停点均已完成。