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

針對在這個停靠站執行的工作提供額外資訊。

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

string

工作 ID。這個欄位不會在 tasks.get 呼叫的回應中填入。工作 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 已抵達停靠站。假設車輛轉送到下一個停靠站，先前的所有停靠站都已完成。