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