資源:Task
Delivery API 中的「工作」代表要追蹤的單一動作。一般而言,與出貨相關的「工作」和「中斷工作」之間會有區別。一項貨件可以有多個相關聯的 Tasks。舉例來說,您可以設定一個用於上車的任務,以及下車或轉車。此外,單一運送作業的不同工作也可由不同車輛處理。舉例來說,某輛車可以處理上車作業、將貨運載往中樞,另一輛車則負責將車子從中心到下車地點。
注意:gRPC 和 REST API 使用不同的欄位命名慣例。例如,gRPC API 中的 Task.journey_sharing_info
欄位和 REST API 中的 Task.journeySharingInfo
欄位指的是同一個欄位。
JSON 表示法 |
---|
{ "name": string, "type": enum ( |
欄位 | |
---|---|
name |
格式必須為 |
type |
必要欄位。不可變動。定義任務的類型。例如中斷或運送。 |
state |
必要欄位。Task 目前的執行狀態。 |
taskOutcome |
工作的結果。 |
taskOutcomeTime |
指出提供者設定 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
taskOutcomeLocation |
設定 |
taskOutcomeLocationSource |
指出 |
trackingId |
不可變動。這個欄位可以儲存 ID,避免使用複雜的對應。您無法為
|
deliveryVehicleId |
僅供輸出。執行這項工作的車輛 ID。運送車輛 ID 受到下列限制:
|
plannedLocation |
不可變動。完成任務的位置。對 |
taskDuration |
必要欄位。不可變動。在此位置執行工作所需的時間。 時間長度以秒為單位,最多可有 9 個小數位數,並結尾為「 |
targetTimeWindow |
完成工作的時間範圍。 |
journeySharingInfo |
僅供輸出。歷程共用專屬欄位。如果狀態為 |
taskTrackingViewConfig |
設定工作追蹤,以指定使用者在什麼情況下可以看到哪些資料元素。 |
attributes[] |
自訂任務屬性清單。每個屬性都必須有一個專屬鍵。 |
類型
Task 的類型。
列舉 | |
---|---|
TYPE_UNSPECIFIED |
預設 Task 類型不明。 |
PICKUP |
取貨工作是指客戶取貨時採取的行動。庫房或餵食器上車應使用 SCHEDULED_STOP 類型。 |
DELIVERY |
貨品交付任務是指將貨運給最終客戶採取的行動。庫房或餵食器車輛下車應使用 SCHEDULED_STOP 類型。 |
SCHEDULED_STOP |
排定的停止工作用於規劃用途。舉例來說,它可能代表從餵食器或倉庫到貨的到貨。如為由消費者上下取貨,則請勿使用這個折扣。 |
UNAVAILABLE |
「工作」表示無法提供車輛服務。舉例來說,如果駕駛人休息一下或車輛停車,就可能會發生這種情況。 |
TaskOutcomeLocationSource
填入 taskOutcomeLocation
的來源識別資訊。
列舉 | |
---|---|
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED |
工作在設定之前的結果。 |
PROVIDER |
供應商指定的 taskOutcomeLocation 。 |
LAST_VEHICLE_LOCATION |
供應商未指定 taskOutcomeLocation ,因此 Fleet Engine 是使用最後已知的車輛位置。 |
JourneySharingInfo
分享特定欄位的歷程。
JSON 表示法 |
---|
{ "remainingVehicleJourneySegments": [ { object ( |
欄位 | |
---|---|
remainingVehicleJourneySegments[] |
指定車輛在完成這項任務前會有哪些停靠站追蹤資訊。請注意,這份清單可能包含其他工作的停靠站。 第一個路段 |
lastLocation |
指出車輛上次回報指定車輛的地點。 |
lastLocationSnappable |
指出車輛的 lastLocation 是否可對齊 |
TaskTrackingViewConfig
定義使用者何時應看到 Task 資料元素的設定訊息。
JSON 表示法 |
---|
{ "routePolylinePointsVisibility": { object ( |
欄位 | |
---|---|
routePolylinePointsVisibility |
用於指定何時可顯示路線折線點的欄位。如未指定這個欄位,系統會使用專案層級的預設瀏覽權限設定。 |
estimatedArrivalTimeVisibility |
用於指定預估抵達時間的欄位。如未指定這個欄位,系統會使用專案層級的預設瀏覽權限設定。 |
estimatedTaskCompletionTimeVisibility |
指定顯示預估工作完成時間的欄位。如未指定這個欄位,系統會使用專案層級的預設瀏覽權限設定。 |
remainingDrivingDistanceVisibility |
指定顯示剩餘行車距離的欄位。如未指定這個欄位,系統會使用專案層級的預設瀏覽權限設定。 |
remainingStopCountVisibility |
指定顯示剩餘停靠站次數的欄位。如未指定這個欄位,系統會使用專案層級的預設瀏覽權限設定。 |
vehicleLocationVisibility |
用於指定車輛位置顯示時間的欄位。如未指定這個欄位,系統會使用專案層級的預設瀏覽權限設定。 |
VisibilityOption
用於定義何時應向使用者顯示資料元素的選項訊息。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 visibility_option 。已選擇特定的顯示設定選項。visibility_option 只能是下列其中一項: |
|
remainingStopCountThreshold |
如果剩餘的停靠站計數 <= otherStopCountThreshold ,會向使用者顯示這個資料元素。 |
durationUntilEstimatedArrivalTimeThreshold |
如果抵達停靠站的預計到達時間 <= durationUntil 預估 ArrivalTimeThreshold ,使用者都能看到這個資料元素。 時間長度以秒為單位,最多可有 9 個小數位數,並結尾為「 |
remainingDrivingDistanceMetersThreshold |
如果剩餘的行車距離 (公尺 <= otherDrivingDistanceMetersThreshold) 就會向使用者顯示這個資料元素。 |
always |
如果設為 True,使用者一律會看到沒有閾值的資料元素。這個欄位不得設為 false。 |
never |
如果設為 True,系統就不會對使用者隱藏這個資料元素,且未設定門檻。這個欄位不得設為 false。 |
方法 |
|
---|---|
|
建立並傳回一批新的 Task 物件。 |
|
建立並傳回新的 Task 物件。 |
|
取得 Task 的相關資訊。 |
|
取得符合指定篩選條件的所有 Task 。 |
|
更新「Task 」資料。 |