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) 的值。這會顯示駕駛應用程式最新已知位置的剩餘行車時間,而非上一個停靠站的行車時間。

時間長度以秒為單位,最多可有 9 個小數位數,並應以「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

這個停靠站執行的 Task 的其他資訊。

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

string

工作 ID。這個欄位不會填入 tasks.get 呼叫的回應中。工作 ID 有下列限制:

  • 必須是有效的 Unicode 字串。
  • 長度上限為 64 個半形字元。
  • 根據 Unicode Normalization Form C 進行正規化。
  • 不得包含下列任何 ASCII 字元:'/'、':'、'?'、',' 或 '#'。
taskDuration

string (Duration format)

僅供輸出。執行工作所需的時間。

時間長度以秒為單位,最多可有 9 個小數位數,並應以「s」結尾,例如:"3.5s"

targetTimeWindow

object (TimeWindow)

僅供輸出。完成工作的時間範圍。這只會在對 deliveryVehicles.get 的回應中設定。

VehicleStop 的目前狀態。

列舉
STATE_UNSPECIFIED 未知。
NEW 已建立,但未積極路由。
ENROUTE 已指派並積極轉送。
ARRIVED 已抵達停靠點。假設車輛在前往下一個停靠站的路線上,已完成所有先前的停靠站。