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.gettasks.search 调用的响应中,系统不会填充此字段。

tasks[]

object (TaskInfo)

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

state

enum (State)

VehicleStop 的状态。在 tasks.gettasks.search 调用的响应中,系统不会填充此字段。

TaskInfo

有关在此经停点执行的任务的更多信息。

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

string

任务 ID。在 tasks.gettasks.search 调用的响应中,系统不会填充此字段。任务 ID 受到以下限制:

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

string (Duration format)

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

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

targetTimeWindow

object (TimeWindow)

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

状态

VehicleStop 的当前状态。

枚举
STATE_UNSPECIFIED 未知。
NEW 已创建,但未主动转送。
ENROUTE 已分配且主动路由。
ARRIVED 已到达经停点。假设当车辆行驶到下一站时,前面的所有停靠站均已用完。