REST Resource: providers.taskTrackingInfo

資源：TaskTrackingInfo

TaskTrackingInfo 訊息。這則訊息包含任務追蹤資訊，系統會用來顯示這項資訊。如果追蹤 ID 與多個工作相關聯，Fleet Engine 會使用啟發法決定要選取哪個工作 TaskTrackingInfo。

JSON 表示法 
{
  "name": string,
  "trackingId": string,
  "vehicleLocation": {
    object (DeliveryVehicleLocation)
  },
  "routePolylinePoints": [
    {
      object (LatLng)
    }
  ],
  "remainingStopCount": integer,
  "remainingDrivingDistanceMeters": integer,
  "estimatedArrivalTime": string,
  "estimatedTaskCompletionTime": string,
  "state": enum (State),
  "taskOutcome": enum (TaskOutcome),
  "taskOutcomeTime": string,
  "plannedLocation": {
    object (LocationInfo)
  },
  "targetTimeWindow": {
    object (TimeWindow)
  },
  "attributes": [
    {
      object (TaskAttribute)
    }
  ]
}
欄位
name

string

格式必須為 providers/{provider}/taskTrackingInfo/{tracking}，其中 tracking 代表追蹤 ID。
trackingId

string

不可變動。工作單的追蹤 ID。* 必須是有效的 Unicode 字串。* 長度上限為 64 個半形字元。* 根據 Unicode Normalization Form C 進行正規化。* 不得包含下列任何 ASCII 字元：'/'、':'、'?'、',' 或 '#'。
vehicleLocation

object (DeliveryVehicleLocation)

車輛最後的位置。
routePolylinePoints[]

object (LatLng)

點的清單，連接後會形成車輛前往此任務位置的預期路線折線。
remainingStopCount

integer

指車輛在抵達工作停靠站前剩餘的停靠站數量，包括工作停靠站。舉例來說，如果車輛的下一個停靠站是任務停靠站，這個值就會是 1。
remainingDrivingDistanceMeters

integer

到目標 VehicleStop 的總剩餘距離，以公尺為單位。
estimatedArrivalTime

string (Timestamp format)

表示停靠地點預估抵達時間的時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 規格化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
estimatedTaskCompletionTime

string (Timestamp format)

指示工作預估完成時間的時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 規格化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
state

enum (State)

工作目前的執行狀態。
taskOutcome

enum (TaskOutcome)

嘗試執行工作時的結果。
taskOutcomeTime

string (Timestamp format)

指示提供者設定工作結果的時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 規格化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
plannedLocation

object (LocationInfo)

不可變動。工作完成的地點。
targetTimeWindow

object (TimeWindow)

應完成工作時段。
attributes[]

object (TaskAttribute)

在工作上設定的自訂屬性。

方法

get

 傳回指定的 TaskTrackingInfo 例項。