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 已到达经停点。假设车辆前往下一个停靠点时，之前的所有停靠站都已完成。