Tạo xe giao hàng cho các nhiệm vụ đã lên lịch

Tài liệu này mô tả cách tạo phương tiện từ môi trường máy chủ bằng gRPC hoặc REST. Bạn có thể tạo phương tiện từ Driver SDK (SDK Trình điều khiển) với điều kiện bạn đã cung cấp ứng dụng dưới dạng môi trường đáng tin cậy bằng thông tin đăng nhập thích hợp.

Để hiểu cách sử dụng Driver SDK để tạo phương tiện, hãy xem các phần sau:

Để tạo một phương tiện mới từ môi trường máy chủ, hãy gửi yêu cầu CreateDeliveryVehicle đến Fleet Engine. Sử dụng đối tượng CreateDeliveryVehicleRequest để xác định các thuộc tính của phương tiện giao hàng mới.

Các trường cho phương tiện thực hiện tác vụ theo lịch

Khi tạo DeliveryVehicle, bạn sẽ đặt các trường không bắt buộc sau:

  • attributes
  • last_location
  • type

Để tạo một phương tiện mà không cần đặt bất kỳ trường không bắt buộc nào, bạn có thể để trống trường DeliveryVehicle trong CreateDeliveryVehicleRequest.

Ví dụ về cách tạo phương tiện

Để tạo một phương tiện, bạn có thể sử dụng thư viện gRPC Java hoặc REST. Để xem danh sách đầy đủ các ngôn ngữ được hỗ trợ, hãy xem Thư viện ứng dụng cho các dịch vụ tác vụ theo lịch.

Java

  static final String PROJECT_ID = "my-delivery-co-gcp-project";
  static final String VEHICLE_ID = "vehicle-8241890"; // Avoid auto-incrementing IDs.

  DeliveryServiceBlockingStub deliveryService =
    DeliveryServiceGrpc.newBlockingStub(channel);

  // Vehicle settings
  String parent = "providers/" + PROJECT_ID;
  DeliveryVehicle vehicle = DeliveryVehicle.newBuilder()
    .addAttributes(DeliveryVehicleAttribute.newBuilder()
      .setKey("route_number").setValue("1"))  // Opaque to the Fleet Engine
    .build();

  // Vehicle request
  CreateDeliveryVehicleRequest createVehicleRequest =
    CreateDeliveryVehicleRequest.newBuilder()  // No need for the header
        .setParent(parent)
        .setDeliveryVehicleId(VEHICLE_ID)     // Vehicle ID assigned by the Provider
        .setDeliveryVehicle(vehicle)
        .build();

  // Error handling
  // If Fleet Engine does not have vehicle with that ID and the credentials of the
  // requestor pass, the service creates the vehicle successfully.

  try {
    DeliveryVehicle createdVehicle =
      deliveryService.createDeliveryVehicle(createVehicleRequest);
  } catch (StatusRuntimeException e) {
    Status s = e.getStatus();
    switch (s.getCode()) {
       case ALREADY_EXISTS:
         break;
       case PERMISSION_DENIED:
         break;
    }
    return;
  }

REST

Để tạo một phương tiện từ môi trường máy chủ, hãy thực hiện lệnh gọi HTTP REST đến CreateDeliveryVehicle:

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

Nội dung POST đại diện cho thực thể DeliveryVehicle cần tạo. Bạn có thể chỉ định các trường không bắt buộc sau:

  • attributes
  • lastLocation
  • type
  # Set $JWT, $PROJECT_ID, and $VEHICLE_ID in the local
  # environment
  curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles?deliveryVehicleId=${VEHICLE_ID}" \
    -H "Content-type: application/json" \
    -H "Authorization: Bearer ${JWT}" \
  --data-binary @- << EOM
  {
    "attributes": [{"key": "model", "value": "sedan"}],
    "lastLocation": {"location": {"latitude": 12.1, "longitude": 14.5}}
  }
  EOM

Để tạo một phương tiện mà không cần đặt bất kỳ trường nào, hãy để trống nội dung của yêu cầu POST. Sau đó, phương tiện mới tạo sẽ trích xuất mã phương tiện từ tham số deliveryVehicleId trong URL POST.

Ví dụ:

  # Set $JWT, $PROJECT_ID, and $VEHICLE_ID in the local
  # environment
  curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles?deliveryVehicleId=${VEHICLE_ID}" \
    -H "Content-type: application/json" \
    -H "Authorization: Bearer ${JWT}"

Bước tiếp theo