Cập nhật các trường về xe giao hàng

Trường Thuộc tính xe

Sử dụng trường attributes xe để tạo tiêu chí tuỳ chỉnh nhằm cho phép người tiêu dùng hoặc nhà vận hành đội xe để tìm xe trong đội xe của bạn ở phạm vi rộng hơn nhiều tiêu chí tìm kiếm. Điều này giúp nâng cao khả năng của ứng dụng để cung cấp kết quả khớp xe tốt hơn so với khi bạn chỉ sử dụng tiêu chí tìm kiếm dựa trên các trường xe khác. Mỗi chiếc xe có thể có tối đa 100 và mỗi thuộc tính phải có một khoá duy nhất. Giá trị có thể là chuỗi, boolean hoặc số.

Ví dụ: bạn có thể khai báo một thuộc tính tuỳ chỉnh có tên là zone để phân biệt khu vực nào của thành phố mà xe giao hàng của bạn hoạt động. Bạn đã sử dụng các giá trị chuỗi, chẳng hạn như sau để biểu thị các vùng khác nhau: 1B, 2C và 3A. Sau đó, bạn có thể sử dụng bộ lọc trong tính năng Theo dõi đội xe để chỉ hiển thị những xe hoạt động trong một khu vực cụ thể cho người vận hành chịu trách nhiệm về khu vực đó.

Tuy nhiên, các giá trị thuộc tính tuỳ chỉnh không nhất thiết phải loại trừ lẫn nhau. Bạn có thể sử dụng các tiêu chí như available-at-night (có phục vụ vào ban đêm) và has-refrigeration (có tủ lạnh). Mỗi thuộc tính trong số này có thể là một thuộc tính tuỳ chỉnh riêng biệt sử dụng giá trị boolean. Một chiếc xe cụ thể có thể được gán cả ba trong số các thuộc tính tùy chỉnh này cùng với vùng được đặt thành giá trị chuỗi thích hợp.

Cập nhật thuộc tính xe

Mỗi khoá attributes chỉ được có một giá trị cho mỗi xe. Bạn khai báo các thuộc tính xe tuỳ chỉnh bằng cách sử dụng attributes trong mặt nạ trường, sau đó cung cấp các giá trị dựa trên phương thức bên dưới.

API UpdateDeliveryVehicle này không cho phép chỉ cập nhật một . Khi sử dụng phương thức này, bất kỳ việc sử dụng trường attributes nào trong mặt nạ trường dẫn đến toàn bộ tập hợp thuộc tính xe được khai báo lại cho chiếc xe. Điều này dẫn đến việc ghi đè bất kỳ thuộc tính nào có sẵn không có trong mặt nạ trường. Nếu sử dụng phương thức này để khai báo một thuộc tính tuỳ chỉnh mới, bạn cũng phải khai báo lại mọi thuộc tính tuỳ chỉnh mà bạn muốn giữ lại cho xe. Nếu bạn loại trừ attributes trong mặt nạ trường, thì điều này để nguyên các thuộc tính tuỳ chỉnh hiện có như đã xác định trước đó cho xe. Nếu bạn sử dụng attributes trong mặt nạ trường nhưng không đặt giá trị, thì điều đó tương đương với việc xoá tất cả thuộc tính tuỳ chỉnh khỏi xe.

Ví dụ về cách cập nhật các trường xe

Phần này trình bày cách cập nhật các trường về xe bằng UpdateDeliveryVehicleRequest, bao gồm update_mask để cho biết trường nào cần cập nhật. Xem tài liệu về Vùng đệm giao thức trên trường mặt nạ để biết chi tiết.

Cần phải sử dụng Fleet Engine Delivery để cập nhật những trường không phải last_location Đặc quyền của quản trị viên.

Ví dụ: đặt thuộc tính tuỳ chỉnh

Ví dụ này chỉ định một thuộc tính mới: zone. Như đã lưu ý trong phần Cập nhật thuộc tính xe trước đó, việc cập nhật trường attributes bằng phương pháp này yêu cầu bạn phải chỉ định tất cả thuộc tính tuỳ chỉnh mà bạn muốn giữ lại. Do đó, ví dụ này cho thấy một giá trị available-at-night được ghi để lưu giữ giá trị đó khỏi bị ghi đè trong hoạt động cập nhật chỉ định Trường attributes.

Xem tham chiếu providers.deliveryVehicles.patch.

  static final String PROJECT_ID = "my-delivery-co-gcp-project";
  static final String VEHICLE_ID = "vehicle-8241890";

  DeliveryServiceBlockingStub deliveryService =
    DeliveryServiceGrpc.newBlockingStub(channel);

  // Vehicle settings
  String vehicleName = "providers/" + PROJECT_ID + "/deliveryVehicles/" + VEHICLE_ID;
  DeliveryVehicle myDeliveryVehicle = DeliveryVehicle.newBuilder()
      .addAllAttributes(ImmutableList.of(
          DeliveryVehicleAttribute.newBuilder().setKey("zone").setValue("1B").build(),
          DeliveryVehicleAttribute.newBuilder().setKey("available-at-night").setValue("true").build()))
      .build();

  // DeliveryVehicle request
  UpdateDeliveryVehicleRequest updateDeliveryVehicleRequest =
    UpdateDeliveryVehicleRequest.newBuilder()  // No need for the header
        .setName(vehicleName)
        .setDeliveryVehicle(myDeliveryVehicle)
        .setUpdateMask(FieldMask.newBuilder()
            .addPaths("attributes"))
        .build();

  try {
    DeliveryVehicle updatedDeliveryVehicle =
        deliveryService.updateDeliveryVehicle(updateDeliveryVehicleRequest);
  } catch (StatusRuntimeException e) {
    Status s = e.getStatus();
    switch (s.getCode()) {
       case NOT_FOUND:
         break;
       case PERMISSION_DENIED:
         break;
    }
    return;
  }

  # Set JWT, PROJECT_ID, VEHICLE_ID, TASK1_ID, and TASK2_ID in the local
  # environment
  curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles/${VEHICLE_ID}?updateMask=attributes" \
    -H "Content-type: application/json" \
    -H "Authorization: Bearer ${JWT}" \
    --data-binary @- << EOM
  {
      "attributes": [
        {"key": "zone", "value": "1B"},
        {"key": "available-at-night", "value": "true"}
      ]
  }
  EOM

Các bước tiếp theo

• Cập nhật vị trí của xe giao hàng