建立出貨工作

本文件假設您已閱讀 入門指南 「Fleet Engine 簡介」一節中的排程工作 您會看到「什麼是排程工作？」。

適用於排程工作的 Fleet Engine 提供下列廣泛的工作類別：

  • 運送工作：用於駕駛工作，包括自取和送貨 出貨。
  • 無法使用的工作：適用於駕駛人無法使用的時間，例如 像是需要的休息時間
  • 排定的停止工作：適用於放置於投遞箱或客戶端的非駕駛工作 例如輸入建築物或尋找送貨地點的時間

本文說明如何在伺服器上建立「出貨」工作。如果您不是 工作類型，請參閱「建立其他工作類型」。

運送工作欄位

這個部分記錄了自取和外送服務所需的工作欄位 機器學習程式庫提供一系列預先編寫的程式碼 可用來執行機器學習工作

必填的工作欄位

針對您在 Fleet Engine 中建立的每項工作，都必須提供必要的 欄位，也可能提供任何選填欄位。機群引擎 忽略所有其他欄位；如果建立工作，就會擲回例外狀況 要求會提供指派的 deliveryVehicleId。如要將工作指派給車輛， 使用 UpdateDeliveryVehicleRequest。若需更多資訊，請參閲 更新工作。

欄位值
type

設定為與工作類型相符的類型，可以是下列其中一項：

  • PICKUP
  • DELIVERY
  • SCHEDULED_STOP
  • UNAVAILABLE
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>

&lt;id&gt; 是工作的專屬 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>

&lt;id&gt; 是工作的專屬 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
 ```

後續步驟