Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Tạo các loại tác vụ khác

Tài liệu này giả định rằng bạn đã đọc hướng dẫn giới thiệu về Nhiệm vụ theo lịch trong phần Giới thiệu về Fleet Engine cũng như Nhiệm vụ theo lịch là gì? trong phần này.

Fleet Engine cho các nhiệm vụ theo lịch cung cấp nhiều danh mục nhiệm vụ:

Nhiệm vụ vận chuyển: Dùng cho các nhiệm vụ lái xe, bao gồm cả việc lấy hàng và giao hàng.
Nhiệm vụ không rảnh: Dùng cho những thời điểm tài xế không rảnh, chẳng hạn như khi nghỉ giải lao bắt buộc.
Tác vụ dừng theo lịch: Dùng cho các tác vụ không liên quan đến việc lái xe tại hộp thư hoặc địa điểm của khách hàng, chẳng hạn như thời gian vào toà nhà hoặc tìm điểm giao hàng.

Tài liệu này trình bày cách tạo nhiệm vụ không vận chuyển trên máy chủ của bạn. Để biết các loại nhiệm vụ vận chuyển, hãy xem phần Tạo nhiệm vụ vận chuyển.

Các trường việc cần làm cho những việc không liên quan đến lái xe

Phần này ghi lại các trường tác vụ cần thiết cho cả tác vụ không có sẵn và tác vụ dừng theo lịch.

Các trường bắt buộc của việc cần làm

Đối với mỗi nhiệm vụ bạn tạo trong Fleet Engine, bạn phải cung cấp các trường bắt buộc và cũng có thể cung cấp bất kỳ trường không bắt buộc nào. Fleet Engine bỏ qua tất cả các trường khác và gửi một ngoại lệ nếu yêu cầu tạo nhiệm vụ cung cấp deliveryVehicleId được chỉ định. Để giao nhiệm vụ cho một xe, hãy sử dụng UpdateDeliveryVehicleRequest. Để biết thêm thông tin, hãy xem phần Cập nhật nhiệm vụ.

Trường	Giá trị
`type`	Đặt thành loại khớp với loại nhiệm vụ, là một trong các loại sau: `PICKUP` `DELIVERY` `SCHEDULED_STOP` `UNAVAILABLE`
`state`	`State.OPEN`
`task_id`	Mã việc cần làm duy nhất. Đây không được là số vận đơn của lô hàng. Nếu không có mã nhận dạng nhiệm vụ trong hệ thống, bạn có thể tạo một giá trị nhận dạng duy nhất chung (UUID). Để biết thông tin cụ thể, hãy xem phần Mã tác vụ.
`tracking_id`	`PICKUP` hoặc `DELIVERY` chỉ dành cho nhiệm vụ: Số hoặc giá trị nhận dạng mà bạn đang dùng để theo dõi một lô hàng. Đừng cung cấp trường này cho các nhiệm vụ không liên quan đến việc vận chuyển.
`planned_location`	Chỉ dành cho các nhiệm vụ `PICKUP`, `DELIVERY` hoặc `SCHEDULED_STOP`: Vị trí cần hoàn thành nhiệm vụ. Không bắt buộc đối với các tác vụ `UNAVAILABLE`.
`task_duration`	Thời gian dự kiến để hoàn thành việc cần làm. Ví dụ: để tìm chỗ đỗ xe hoặc đi bộ đến địa điểm giao hàng.

Các trường không bắt buộc của nhiệm vụ lô hàng

Trường	Giá trị
`target_time_window`	Khoảng thời gian cần hoàn thành việc cần làm. Trường này không ảnh hưởng đến hành vi định tuyến.
`task_tracking_view_config`	Chỉ các nhiệm vụ `PICKUP` hoặc `DELIVERY`: Cấu hình cho tính năng theo dõi nhiệm vụ, trong đó chỉ định những phần tử dữ liệu nào hiển thị cho người dùng cuối trong trường hợp nào.
`attributes`	Danh sách các thuộc tính tuỳ chỉnh của nhiệm vụ. Mỗi thuộc tính phải có một khoá riêng biệt.

Tạo việc cần làm về thời gian không rảnh

Bạn có thể tạo một nhiệm vụ cho biết trạng thái không rảnh, chẳng hạn như khi tài xế nghỉ giải lao. Để tạo một nhiệm vụ không có mặt, hãy làm theo các nguyên tắc sau:

Đặt loại nhiệm vụ thành UNAVAILABLE.
Đừng thêm mã theo dõi.
Mặc dù bạn không cần phải cung cấp vị trí cho một nhiệm vụ không rảnh, nhưng việc này sẽ giúp tính toán thời gian đến dự kiến chính xác hơn trong suốt cả ngày.

Các quy tắc đặc biệt về chế độ hiển thị sẽ áp dụng cho vị trí của xe khi xe đang thực hiện một nhiệm vụ UNAVAILABLE để chia sẻ hành trình.

Ứng dụng dành cho người tiêu dùng được tích hợp với thư viện Theo dõi lô hàng: Khi xe đang thực hiện một nhiệm vụ không có sẵn, người dùng ứng dụng dành cho người tiêu dùng không thể xem vị trí của xe, mặc dù họ vẫn có thể xem thông tin trạng thái của lô hàng.
Ứng dụng theo dõi đội xe được tích hợp với thư viện Theo dõi đội xe: Khi xe đang thực hiện một nhiệm vụ không có sẵn, những người quản lý đội xe sử dụng ứng dụng theo dõi đội xe sẽ có thể xem vị trí của xe cho các nhiệm vụ không có sẵn.

Các ví dụ sau đây cho thấy cách tạo một nhiệm vụ không có sẵn theo lịch bằng cách sử dụng thư viện gRPC Java hoặc cách tạo một yêu cầu HTTP REST đến 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.UNAVAILABLE)
    .setState(Task.State.OPEN)
    .setTaskDuration(
      Duration.newBuilder().setSeconds(60 * 60))  // 1hr break
    .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

Để tạo một nhiệm vụ không có sẵn từ môi trường máy chủ, hãy thực hiện lệnh gọi HTTP REST đến CreateTask:

POST https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks?taskId=<id>

<id> là giá trị nhận dạng riêng biệt của nhiệm vụ.

Tiêu đề của yêu cầu phải chứa trường Authorization có giá trị Bearer <token>, trong đó <token> do máy chủ của bạn cấp theo nguyên tắc được mô tả trong phần Vai trò của tài khoản dịch vụ và Mã thông báo web JSON.

Nội dung yêu cầu phải chứa một thực thể Task có các trường thích hợp được mô tả trong phần Trường nhiệm vụ cho các nhiệm vụ không liên quan đến việc lái xe.

Ví dụ về lệnh curl:

 # Set $JWT, $PROJECT_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": "UNAVAILABLE",
   "state": "OPEN",
   "plannedLocation": {
      "point": {
         "latitude": -6.195139,
         "longitude": 106.820826
      }
   },
   "taskDuration": "300s"
 }
 EOM

Tạo một nhiệm vụ dừng theo lịch

Bạn có thể tạo một nhiệm vụ cho một điểm dừng theo lịch; ví dụ: đối với các nhiệm vụ không liên quan đến việc lái xe tại địa điểm của khách hàng, đối với các điểm dừng để nạp nhiên liệu hoặc khi tài xế nhận hàng từ một xe trung chuyển. Khi bạn tạo một việc cần làm theo lịch, hãy làm theo các nguyên tắc sau:

Đặt loại nhiệm vụ thành
Đừng thêm mã theo dõi.
Bạn có thể cung cấp thông tin vị trí (không bắt buộc).

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.SCHEDULED_STOP)
    .setState(Task.State.OPEN)
    .setPlannedLocation(               // Grand Indonesia East Mall
      LocationInfo.newBuilder().setPoint(
        LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
    .setTaskDuration(
      Duration.newBuilder().setSeconds(2 * 60))
    .build();

  // Task request
  CreateTaskRequest createTaskRequest =
    CreateTaskRequest.newBuilder()  // No need for the header
        .setParent(parent)
        .setTaskId("task-8241890")  // Task ID assigned by the Provider
        .setTrip(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

Để tạo một tác vụ dừng theo lịch từ môi trường máy chủ, hãy thực hiện lệnh gọi HTTP REST đến CreateTask:

POST https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks?taskId=<id>

<id> là giá trị nhận dạng riêng biệt của nhiệm vụ.

Nội dung yêu cầu phải chứa một thực thể Task:

Ví dụ về lệnh curl:

# Set $JWT, $PROJECT_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": "SCHEDULED_STOP",
   "state": "OPEN",
   "plannedLocation": {
      "point": {
         "latitude": -6.195139,
         "longitude": 106.820826
      }
   },
   "taskDuration": "600s"
 }
 EOM

Tạo các loại tác vụ khác Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Các trường việc cần làm cho những việc không liên quan đến lái xe

Các trường bắt buộc của việc cần làm

Các trường không bắt buộc của nhiệm vụ lô hàng

Tạo việc cần làm về thời gian không rảnh

gRPC

REST

Tạo một nhiệm vụ dừng theo lịch

gRPC

REST

Bước tiếp theo

Tạo các loại tác vụ khác