本文件假設您已閱讀 入門指南 「Fleet Engine 簡介」一節中的排程工作 您會看到「什麼是排程工作?」。
適用於排程工作的 Fleet Engine 提供下列廣泛的工作類別:
- 運送工作:用於駕駛工作,包括自取和送貨 出貨。
- 無法使用的工作:適用於駕駛人無法使用的時間,例如 像是需要的休息時間
- 排定的停止工作:適用於放置於投遞箱或客戶端的非駕駛工作 例如輸入建築物或尋找送貨地點的時間
本文說明如何在伺服器上建立「出貨」工作。如果您不是 工作類型,請參閱「建立其他工作類型」。
運送工作欄位
這個部分記錄了自取和外送服務所需的工作欄位 機器學習程式庫提供一系列預先編寫的程式碼 可用來執行機器學習工作
必填的工作欄位
針對您在 Fleet Engine 中建立的每項工作,都必須提供必要的
欄位,也可能提供任何選填欄位。機群引擎
忽略所有其他欄位;如果建立工作,就會擲回例外狀況
要求會提供指派的 deliveryVehicleId
。如要將工作指派給車輛,
使用 UpdateDeliveryVehicleRequest
。若需更多資訊,請參閲
更新工作。
欄位 | 值 |
---|---|
type |
設定為與工作類型相符的類型,可以是下列其中一項:
|
state |
State.OPEN |
task_id |
專屬工作 ID。這不得為貨運項目的追蹤號碼。如果發生以下情況: 系統中沒有工作 ID,您可能會產生通用不重複的 識別碼 (UUID)。如需具體資訊,請參閱 工作 ID: |
tracking_id |
僅限 PICKUP 或 DELIVERY 工作:
您用來追蹤運送狀態的號碼或 ID。禁止事項
為非出貨工作提供這個欄位。 |
plannedLocation |
PICKUP 、DELIVERY 或
僅限 SCHEDULED_STOP 項工作:
工作要完成的位置不需要
UNAVAILABLE 項工作。 |
taskDuration |
完成任務的預計新增時間。比如 ,或走到交接地點。 |
選填的運送工作欄位
欄位 | 值 |
---|---|
targetTimeWindow |
完成工作的時間範圍。這個欄位 不會影響轉送行為。 |
task_tracking_view_config |
僅限 PICKUP 或 DELIVERY 工作:
工作追蹤的設定,會指定哪些資料元素
可在哪些情況下向使用者顯示。 |
attributes |
自訂工作屬性的清單。每個屬性都必須有專屬索引鍵。 |
建立運送自取工作
使用 Fleet Engine 追蹤司機收取貨物的活動,
建立出貨取貨工作。這包括將工作類型屬性設為
PICKUP
。以下範例說明從大貨公司到府取件服務
Indonesia East Mall。
以下範例將說明如何使用
Java gRPC 程式庫,或是如何向 HTTP REST 要求發送 HTTP REST 要求
CreateTask
。
gRPC
static final String PROJECT_ID = "my-delivery-co-gcp-project";
DeliveryServiceBlockingStub deliveryService =
DeliveryServiceGrpc.newBlockingStub(channel);
// Task settings
String parent = "providers/" + PROJECT_ID;
Task task = Task.newBuilder()
.setType(Task.Type.PICKUP)
.setState(Task.State.OPEN)
.setTrackingId("my-tracking-id")
.setPlannedLocation( // Grand Indonesia East Mall
LocationInfo.newBuilder().setPoint(
LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
.setTaskDuration(
Duration.newBuilder().setSeconds(2 * 60))
.setTargetTimeWindow(
TimeWindow.newBuilder()
.setStartTime(Timestamp.newBuilder().setSeconds(1680123600))
.setEndTime(Timestamp.newBuilder().setSeconds(1680130800)))
.addAttributes(TaskAttribute.newBuilder().setKey("foo").setStringValue("value"))
.addAttributes(TaskAttribute.newBuilder().setKey("bar").setNumberValue(10))
.addAttributes(TaskAttribute.newBuilder().setKey("baz").setBoolValue(false))
.build();
// Task request
CreateTaskRequest createTaskRequest =
CreateTaskRequest.newBuilder() // No need for the header
.setParent(parent) // Avoid using auto-incrementing IDs for the taskId
.setTaskId("task-8241890") // Task ID assigned by the Provider
.setTask(task) // Initial state
.build();
// Error handling
// If Fleet Engine does not have a task with that ID and the credentials of the
// requestor pass, the service creates the task successfully.
try {
Task createdTask = deliveryService.createTask(createTaskRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case ALREADY_EXISTS:
break;
case PERMISSION_DENIED:
break;
}
return;
}
REST
如要從伺服器環境建立運送取貨工作,請建立 HTTP REST
呼叫 CreateTask
:
POST https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks?taskId=<id>
<id> 是工作的專屬 ID。
要求標頭必須包含 Authorization 欄位,當中須有相應的值 不記名 <token>,其中 <token> 將根據您的伺服器核發 遵循服務帳戶角色和 JSON Web 符記
要求主體必須包含含有適當欄位的 Task
實體
相關說明請參閱「運送工作欄位」。
curl
指令範例:
# Set $JWT, $PROJECT_ID, $TRACKING_ID, and $TASK_ID in the local
# environment
curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks?taskId=${TASK_ID}" \
-H "Content-type: application/json" \
-H "Authorization: Bearer ${JWT}" \
--data-binary @- << EOM
{
"type": "PICKUP",
"state": "OPEN",
"trackingId": "${TRACKING_ID}",
"plannedLocation": {
"point": {
"latitude": -6.195139,
"longitude": 106.820826
}
},
"taskDuration": "90s",
"targetTimeWindow": {
"startTime": "2023-03-29T21:00:00Z",
"endTime": "2023-03-29T23:00:00Z"
}
}
EOM
建立運送運送工作
使用 Fleet Engine 追蹤司機運送貨物的活動
並建立運送運送工作這包括設定工作類型屬性
至 DELIVERY
。以下範例說明運送至大範圍的貨物
Indonesia East Mall。
以下範例將說明如何使用
Java gRPC 程式庫,或是如何向 HTTP REST 要求發送 HTTP REST 要求
CreateTask
。
gRPC
static final String PROJECT_ID = "my-delivery-co-gcp-project";
DeliveryServiceBlockingStub deliveryService =
DeliveryServiceGrpc.newBlockingStub(channel);
// Task settings
String parent = "providers/" + PROJECT_ID;
Task task = Task.newBuilder()
.setType(Task.Type.DELIVERY)
.setState(Task.State.OPEN)
.setTrackingId("my-tracking-id")
.setPlannedLocation( // Grand Indonesia East Mall
LocationInfo.newBuilder().setPoint(
LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
.setTaskDuration(
Duration.newBuilder().setSeconds(2 * 60))
.setTargetTimeWindow(
TimeWindow.newBuilder()
.setStartTime(Timestamp.newBuilder().setSeconds(1680123600))
.setEndTime(Timestamp.newBuilder().setSeconds(1680130800)))
.addAttributes(TaskAttribute.newBuilder().setKey("foo").setStringValue("value"))
.addAttributes(TaskAttribute.newBuilder().setKey("bar").setNumberValue(10))
.addAttributes(TaskAttribute.newBuilder().setKey("baz").setBoolValue(false))
.build();
// Task request
CreateTaskRequest createTaskRequest =
CreateTaskRequest.newBuilder() // No need for the header
.setParent(parent) // Avoid using auto-incrementing IDs for the taskId
.setTaskId("task-8241890") // Task ID assigned by the Provider
.setTask(task) // Initial state
.build();
// Error handling
// If Fleet Engine does not have task with that ID and the credentials of the
// requestor pass, the service creates the task successfully.
try {
Task createdTask = deliveryService.createTask(createTaskRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case ALREADY_EXISTS:
break;
case PERMISSION_DENIED:
break;
}
return;
}
REST
如要從伺服器環境建立運送取貨工作,請建立 HTTP REST
呼叫 CreateTask
:
POST https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks?taskId=<id>
<id> 是工作的專屬 ID。
要求標頭必須包含 Authorization 欄位,當中須有相應的值 不記名 <token>,其中 <token> 將根據您的伺服器核發 符合服務帳戶角色和 JSON Web 中所述指南 符記
要求主體必須包含 Task
實體:
curl
指令範例:
# Set $JWT, $PROJECT_ID, $TRACKING_ID, and $TASK_ID in the local
# environment
curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks?taskId=${TASK_ID}" \
-H "Content-type: application/json" \
-H "Authorization: Bearer ${JWT}" \
--data-binary @- << EOM
{
"type": "DELIVERY",
"state": "OPEN",
"trackingId": "${TRACKING_ID}",
"plannedLocation": {
"point": {
"latitude": -6.195139,
"longitude": 106.820826
}
},
"taskDuration": "90s",
"targetTimeWindow": {
"startTime": "2023-03-29T21:00:00Z",
"endTime": "2023-03-29T23:00:00Z"
}
}
EOM
```