本文假設您已瞭解如何建立及使用工作。並提供以下具體範例,說明如何透過下列方式設定運送工作:
設定運送工作目標時間範圍:設定工作完成的時間範圍。
自訂工作可見度:自訂工作活動的可見度,以便向客戶或車隊操作員顯示。
如要進一步瞭解出貨工作欄位,請參閱「建立出貨工作」。更新現有工作相關的其他資訊時,除了要更新的工作欄位外,還必須提供工作相關的 ID。
設定目標時間範圍
目標時間範圍是指應完成工作時的 TimeWindow。舉例來說,如果您向運送收件者提供運送時間範圍,可以使用工作目標時間範圍擷取這個時間範圍並產生快訊,也可以用來分析過去行程的表現。
目標時間範圍包含開始時間和結束時間,可用於任何任務類型。目標時間範圍不會影響轉送行為。
以下範例說明如何使用 Java gRPC 程式庫設定時間範圍,或是如何向 UpdateTask
提出 HTTP REST 要求。您也可以在建立工作時設定這個欄位。
gRPC
static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String TASK_ID = "task-8241890";
DeliveryServiceBlockingStub deliveryService =
DeliveryServiceGrpc.newBlockingStub(channel);
// Task settings
String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
Task task = Task.newBuilder()
.setName(taskName)
.setTargetTimeWindow(
TimeWindow.newBuilder()
.setStartTime(Timestamp.newBuilder().setSeconds(1680123600))
.setEndTime(Timestamp.newBuilder().setSeconds(1680130800)))
.build();
// Task request
UpdateTaskRequest updateTaskRequest =
UpdateTaskRequest.newBuilder() // No need for the header
.setTask(task)
.setUpdateMask(FieldMask.newBuilder().addPaths("targetTimeWindow"))
.build();
try {
Task updatedTask = deliveryService.updateTask(updateTaskRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND:
break;
case PERMISSION_DENIED:
break;
}
return;
}
REST
如要使用 HTTP 設定工作時間視窗,請呼叫 PATCH
,並使用 updateMask
更新 targetTimeWindow
參數:
PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks/<id>?updateMask=targetTimeWindow
其中 <id> 是工作的專屬 ID。要求標頭必須包含「Authorization」欄位,其值為「Bearer <token>」,其中 <token> 是由伺服器根據「服務帳戶角色」和「JSON Web 權杖」一文所述的規範所發出。
# Set JWT, PROJECT_ID, and TASK_ID in the local environment
curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks/${TASK_ID}?updateMask=targetTimeWindow" \
-H "Content-type: application/json" \
-H "Authorization: Bearer ${JWT}" \
--data-binary @- << EOM
{
"targetTimeWindow": {
"startTime": "2023-03-29T21:00:00Z",
"endTime": "2023-03-29T23:00:00Z"
}
}
EOM
自訂工作瀏覽權限
根據預設,Fleet Engine 會提供工作活動資訊,以便向接收貨物的客戶和追蹤貨物的車隊運作人員顯示。這些資訊包括在傳送包裹配送狀態通知給客戶前,指出停靠次數。您可以根據每項工作自訂這項資訊,以便更符合您的業務模式。
本節將說明地圖上已追蹤物件的顯示規則。這些規則適用於兩類物件:
- 地點標記可見度
- 針對進行中的車輛任務顯示任務資料,例如多邊形線和預估到達時間
位置標記瀏覽權限規則
無論運送狀態為何,Fleet Engine 都會在地圖上顯示運送地點的標記。
任務資料瀏覽權限規則
本節說明工作資料適用的預設瀏覽權限規則。您只能自訂運行中的車輛任務,也就是說,只有接送和下車任務可以套用自訂的瀏覽權限規則。
您無法自訂下列工作:
- 已排定的停靠點
- 不提供服務的工作
- 無效車輛工作
無法使用的工作瀏覽權限規則
根據預設,如果追蹤任務指派至少一項無法使用任務,車輛就不會顯示在地圖上。例如駕駛人休息,或是車輛在前往追蹤運送追蹤的路徑上司機休息。系統仍會顯示預計到達時間和預估任務完成時間。再次提醒,您可能無法自訂這項規則。
進行中的車輛工作可見度
TaskTrackingInfo
物件提供多個資料元素,方便您使用運送追蹤程式庫顯示這些元素。根據預設,當工作指派給車輛,且車輛位於工作停靠站的 5 個停靠站內時,系統就會顯示這些欄位。工作完成或取消後,就會停止顯示。
您可以在 Fleet Engine 中建立或更新工作時,為工作設定 TaskTrackingViewConfig
,藉此依工作個別自訂瀏覽權限設定。這會為個別資料元素建立可用的規則。
下表列出可套用瀏覽權限規則的欄位。
瀏覽權限規則的車輛工作欄位 |
---|
|
下表列出上述欄位的可見度選項。
瀏覽權限選項 |
---|
|
路線折線和車輛位置顯示規則
對於已追蹤路線,路線折線的顯示與否取決於車輛的顯示狀態。如果有效路線上可見路線折線,且車輛「未顯示」,仍可透過可見折線的結尾處推測車輛位置。因此,路線折線的可見性必須與車輛能見度一樣嚴格或嚴格。
請遵循下列規則,提供有效的路線多邊形 / 車輛位置可見度組合。
路線折線和車輛位置指定的顯示設定選項相同
在此情況下,折線和車輛位置都會設定相同的選項,包括:
- 剩餘停靠站數量
- 到達時間
- 剩餘行駛距離
為遵循規則,路線折線可見性的值必須小於或等於針對車輛顯示設定設定的值。在這個範例中,多邊形的剩餘停靠站門檻設為 3,低於車輛指定的 5 值。也就是說,當追蹤的路線距離任務位置 5 個站時,車輛就會顯示,但該車輛的路線會在路線距離 3 個站時才顯示。
```js
"taskTrackingViewConfig": {
"routePolylinePointsVisibility": {
"remainingStopCountThreshold": 3
},
"vehicleLocationVisibility": {
"remainingStopCountThreshold": 5
},
}
```
路線折線和車輛位置指定不同的顯示選項
如果路線多邊形和車輛位置有不同的顯示選項,只有在兩者的顯示選項都符合時,車輛位置才會顯示。同樣地,多邊形可見度會受到車輛的可見度規則影響:
- 一律可見:如果車輛位置也提供「一律可見」顯示選項,路線多邊形必須使用「一律可見」顯示選項。
- 永不顯示:如果車輛位置使用「永不顯示」顯示選項,路線多邊形必須使用「永不顯示」顯示選項。
範例如下:
"taskTrackingViewConfig": {
"routePolylinePointsVisibility": {
"remainingStopCountThreshold": 3
},
"vehicleLocationVisibility": {
"remainingDrivingDistanceMetersThreshold": 3000
},
}
在這個範例中,只有在剩餘停靠站數至少為 3 個且剩餘行駛距離至少為 3000 公尺時,系統才會顯示車輛位置。
工作瀏覽權限自訂設定範例
以下範例說明如何設定包含下列可見度規則的工作:
- 如果車輛距離 3 個停靠站,請顯示路線折線。
- 如果剩餘行駛距離少於 5000 公尺,就會顯示預估到達時間。
- 一律不顯示剩餘的停靠站計數。
- 其他所有欄位都會保留預設的瀏覽權限,也就是在車輛距離任務 5 個停靠站範圍內時顯示。
如要瞭解 gRPC 或 REST,請參閱 TaskTrackingViewConfig
。
gRPC
static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String TASK_ID = "task-8241890";
DeliveryServiceBlockingStub deliveryService =
DeliveryServiceGrpc.newBlockingStub(channel);
// Task settings
String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
Task task = Task.newBuilder()
.setName(taskName)
.setTaskTrackingViewConfig(
TaskTrackingViewConfig.newBuilder()
.setRoutePolylinePointsVisibility(
VisibilityOption.newBuilder().setRemainingStopCountThreshold(3))
.setEstimatedArrivalTimeVisibility(
VisibilityOption.newBuilder().remainingDrivingDistanceMetersThreshold(5000))
.setRemainingStopCountVisibility(
VisibilityOption.newBuilder().setNever(true)))
.build();
// Task request
UpdateTaskRequest updateTaskRequest =
UpdateTaskRequest.newBuilder() // No need for the header
.setTask(task)
.setUpdateMask(FieldMask.newBuilder().addPaths("taskTrackingViewConfig"))
.build();
try {
Task updatedTask = deliveryService.updateTask(updateTaskRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND:
break;
case PERMISSION_DENIED:
break;
}
return;
}
REST
如要使用 HTTP 設定工作追蹤檢視畫面的設定視窗,請呼叫 PATCH
,然後使用 updateMask
更新 taskTrackingViewConfig
參數:
PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks/<id>?updateMask=taskTrackingViewConfig
例如:
# Set JWT, PROJECT_ID, and TASK_ID in the local environment
curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks/${TASK_ID}?updateMask=taskTrackingViewConfig" \
-H "Content-type: application/json" \
-H "Authorization: Bearer ${JWT}" \
--data-binary @- << EOM
{
"taskTrackingViewConfig": {
"routePolylinePointsVisibility": {
"remainingStopCountThreshold": 3
},
"estimatedArrivalTimeVisibility": {
"remainingDrivingDistanceMetersThreshold": 5000
},
"remainingStopCountVisibility": {
"never": true
}
}
}
EOM