Deliveries API 中的工作資源記錄。
JSON 表示法 |
---|
{ "name": string, "type": enum ( |
欄位 | |
---|---|
name |
工作資源名稱,格式為 |
type |
工作類型。 |
state |
表示工作進度的狀態。 |
taskOutcome |
嘗試執行工作的結果。當 TaskState 關閉時,表示工作是否順利完成。 |
taskOutcomeTime |
設定工作結果的時間戳記 (來自提供者)。 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例: |
taskOutcomeLocation |
工作結果的設定位置。 |
taskOutcomeLocationSource |
指出 |
trackingId |
這個欄位可協助儲存客戶 ID,避免進行不必要或複雜的對應。 |
deliveryVehicleId |
執行這項工作的車輛 ID。 |
plannedLocation |
工作完成的位置。 |
taskDuration |
有更多時間可在此位置執行動作。 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
targetTimeWindow |
應完成工作的時間範圍。 |
journeySharingInfo |
共用特定欄位的歷程。 |
taskTrackingViewConfig |
設定工作追蹤功能的工作,用來指定要在什麼情況下向使用者顯示哪些資料元素。 |
attributes[] |
自訂工作屬性的清單。每個屬性都必須具備專屬金鑰。 |
JourneySharingInfoLog
共用特定欄位的歷程。
JSON 表示法 |
---|
{ "remainingVehicleJourneySegments": [ { object ( |
欄位 | |
---|---|
remainingVehicleJourneySegments[] |
指定車輛在完成這項工作前,各停靠站前往的每個停靠站資訊。這份清單可能包含其他工作的停靠站。 |
lastLocation |
車輛上次回報的位置。 |
lastLocationSnappable |
指出車輛的 |
TaskTrackingViewConfigLog
這個設定訊息定義了應向使用者顯示「工作」的資料元素的時機。
JSON 表示法 |
---|
{ "routePolylinePointsVisibility": { object ( |
欄位 | |
---|---|
routePolylinePointsVisibility |
指定路線折線點可顯示的時機欄位。如未指定這個欄位,系統會使用專案層級的預設瀏覽權限設定。 |
estimatedArrivalTimeVisibility |
用來指定顯示預估抵達時間的欄位。如未指定這個欄位,系統會使用專案層級的預設瀏覽權限設定。 |
estimatedTaskCompletionTimeVisibility |
這個欄位可指定顯示預估工作完成時間的顯示時間。如未指定這個欄位,系統會使用專案層級的預設瀏覽權限設定。 |
remainingDrivingDistanceVisibility |
指定可顯示剩餘行車距離的欄位。如未指定這個欄位,系統會使用專案層級的預設瀏覽權限設定。 |
remainingStopCountVisibility |
指定顯示剩餘停靠站何時可顯示的欄位。如未指定這個欄位,系統會使用專案層級的預設瀏覽權限設定。 |
vehicleLocationVisibility |
指定車輛位置可顯示的時間欄位。如未指定這個欄位,系統會使用專案層級的預設瀏覽權限設定。 |
VisibilityOptionLog
選項訊息,定義何時應向使用者顯示資料元素。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位
|
|
remainingStopCountThreshold |
如果剩餘的停靠站計數 <= leftStopCountThreshold,使用者就可以看到此資料元素。 |
durationUntilEstimatedArrivalTimeThreshold |
如果抵達停靠站的預計到達時間 <= durationUntilEstimatedArrivalTimeThreshold,使用者便可看到此資料元素。 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
remainingDrivingDistanceMetersThreshold |
如果剩餘的行車距離 (公尺 <= leftDrivingDistanceMetersThreshold),使用者就可以看到此資料元素。 |
always |
如果設為 True,系統一律會向使用者顯示這個資料元素,不設有門檻。 |
never |
如果設為 True,系統一律會對使用者隱藏這個資料元素,且不會設定閾值。 |
TaskAttributeLog
將工作屬性描述為鍵/值組合。「key:value」字串的長度不得超過 256 個半形字元。
JSON 表示法 |
---|
{ "key": string, // Union field |
欄位 | |
---|---|
key |
屬性的鍵。鍵不得包含冒號字元 (:)。 |
聯集欄位 task_attribute_value 。屬性值可以是字串、布林值或雙精度浮點數類型。如果未設定,系統會將 TaskAttribute string_value 儲存為空白字串「"」。task_attribute_value 只能採用下列其中一種設定: |
|
stringValue |
字串類型的屬性值。 |
boolValue |
布林值的輸入屬性值。 |
numberValue |
雙重輸入屬性值。 |