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