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.search 呼叫的回應中填入。
tasks[]

object (TaskInfo)

要在這個停靠站執行的 Task 清單。這個欄位不會在 tasks.get 或 tasks.search 呼叫的回應中填入。
state

enum (State)

VehicleStop 的狀態。這個欄位不會在 tasks.get 或 tasks.search 呼叫的回應中填入。

TaskInfo

關於在這個停靠站執行的工作的其他相關資訊。

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

string

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

  • 必須是有效的萬國碼 (Unicode) 字串。
  • 長度上限為 64 個半形字元。
  • 根據 Unicode 正規化表單 C 進行正規化處理。
  • 不得包含下列任一 ASCII 字元：「/」、「:」、「?」、「,」或「#」。
taskDuration

string (Duration format)

僅供輸出。執行任務所需的時間。

持續時間以秒為單位，最多 9 個小數位數，結尾為「s」，例如："3.5s"。
targetTimeWindow

object (TimeWindow)

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

狀態

VehicleStop 的目前狀態。

列舉
STATE_UNSPECIFIED 不明。
NEW 已建立，但未主動轉送。
ENROUTE 已指派及主動轉送。
ARRIVED 已抵達停靠站。假設車輛正規劃前往下一個停靠站時，先前的所有停靠站均已完成。