REST Resource: providers.deliveryVehicles

{
  "name": string,
  "lastLocation": {
    object (DeliveryVehicleLocation)
  },
  "navigationStatus": enum (DeliveryVehicleNavigationStatus),
  "currentRouteSegment": string,
  "currentRouteSegmentEndPoint": {
    object (LatLng)
  },
  "remainingDistanceMeters": integer,
  "remainingDuration": string,
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegment)
    }
  ],
  "attributes": [
    {
      object (DeliveryVehicleAttribute)
    }
  ],
  "type": enum (DeliveryVehicleType)
}

string

這個傳送媒介的不重複名稱。格式為 providers/{provider}/deliveryVehicles/{vehicle}。

object (DeliveryVehicleLocation)

送貨車輛上次回報的位置。

enum (DeliveryVehicleNavigationStatus)

運送車輛的導航狀態。

string (bytes format)

已編碼的折線，指定導航系統建議前往下一個路標的路線。當車輛抵達或通過停靠站，以及導航重新規劃路線時，駕駛員應用程式會更新此值。針對指派給車輛的所有有效工作，這些 LatLng 會以 Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) 或 Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) 傳回。

在某些情況下，這個欄位可能無法用於填入 Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) 或 Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST)：

• currentRouteSegment 的端點不符合 DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) 或 DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST)。

• 駕駛員應用程式最近未更新位置，因此這個欄位上次更新的值可能已過時。

• 駕駛員應用程式最近更新了位置，但 currentRouteSegment 已過時，且指向先前的車輛停靠站。

在這些情況下，Fleet Engine 會在這個欄位填入最近傳遞的 VehicleStop 到即將到來的 VehicleStop 的路線，確保這個欄位的消費者在目前輸送車輛的目前路徑中擁有最準確的資訊。

Base64 編碼字串。

object (LatLng)

currentRouteSegment 的結束位置。目前駕駛員應用程式不會填入這項資訊，但您可以在 deliveryVehicles.patch 呼叫中提供這項資訊。這可能是即將抵達的車輛停靠站的 LatLng，或是 currentRouteSegment 的最後一個 LatLng。接著，Fleet Engine 會盡力對實際的 VehicleStop 進行插補。

如果 currentRouteSegment 欄位空白，系統會在 deliveryVehicles.patch 呼叫中忽略這個欄位。

integer

currentRouteSegment 的剩餘行車距離。駕駛員應用程式通常會提供這個欄位，但在某些情況下，Fleet Engine 會覆寫應用程式傳送的值。詳情請參閱 DeliveryVehicle.current_route_segment。系統會在 Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) 或 Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) 中傳回這個欄位，適用於指派給發布媒介的所有有效 Task。

如果 currentRouteSegment 欄位為空白，Fleet Engine 會忽略 UpdateDeliveryVehicleRequest 中的這個欄位。

string (Duration format)

currentRouteSegment 的剩餘行車時間。駕駛員應用程式通常會提供這個欄位，但在某些情況下，車隊引擎會覆寫應用程式傳送的值。詳情請參閱 DeliveryVehicle.current_route_segment。系統會在 Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) 或 Task.remainingVehicleJourneySegments[0].drivingDuration (REST) 中，為指派給發布車輛的所有有效工作傳回這個欄位。

如果 currentRouteSegment 欄位為空白，Fleet Engine 會忽略 UpdateDeliveryVehicleRequest 中的這個欄位。

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

object (VehicleJourneySegment)

指派給這輛運輸車輛的旅程區隔 (從車輛最近回報的地點開始)。這個欄位不會填入 deliveryVehicles.list 的回應。

object (DeliveryVehicleAttribute)

自訂運送車輛屬性清單。每個交付車輛最多可包含 100 個屬性，且每個屬性都必須有專屬索引鍵。

enum (DeliveryVehicleType)

這個運送車輛的類型。如未設定，這個項目會預設為 AUTO。

{
  "key": string,
  "value": string,

  // Union field delivery_vehicle_attribute_value can be only one of the
  // following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field
  // delivery_vehicle_attribute_value.
}

string

屬性鍵。

string

屬性值。

string

字串型屬性值。

注意：這與 value 欄位相同，最終將會淘汰。如要使用建立或更新方法，可以使用任一欄位，但強烈建議使用 stringValue。如果 stringValue 和 value 皆已設定，兩者必須相同，否則系統會擲回錯誤。回應中會填入這兩個欄位。

boolean

布林型屬性值。

number

雙重輸入的屬性值。