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 已抵達停靠站。假設車輛在前往下一個停靠站的路線上，已完成所有先前的停靠站。