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

Trường trạng thái xe

Hệ thống của bạn có thể đặt trạng thái xe thành OFFLINE hoặc ONLINE. Ví dụ: bạn có thể đặt trạng thái xe thành ONLINE lúc 9 giờ sáng hằng ngày và OFFLINE lúc 5 giờ chiều hằng ngày.

Trường thuộc tính xe

Sử dụng trường attributes xe để tạo tiêu chí tuỳ chỉnh, giúp người tiêu dùng hoặc đơn vị vận hành đội xe tìm thấy xe trong đội xe của bạn dựa trên nhiều tiêu chí tìm kiếm hơn. Điều này giúp tăng cường khả năng của ứng dụng để cung cấp kết quả khớp xe chính xác 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 khác của xe. Mỗi chiếc xe có thể có tối đa 100 thuộc tính và mỗi thuộc tính phải có một khoá riêng biệ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à class để phân biệt các xe đi chung theo cấp độ lớp. Bạn sẽ sử dụng các giá trị chuỗi sau đây để biểu thị các cấp lớp xe: ECONOMY, STANDARD và LUXURY.

Tuy nhiên, các giá trị thuộc tính tuỳ chỉnh không nhất thiết phải không trùng lặp. Bạn có thể sử dụng các tiêu chí như cho phép mang theo thú cưng, không hút thuốc và có thể đi các chuyến dài hơn. Mỗi thuộc tính này có thể là một thuộc tính tuỳ chỉnh riêng biệt sử dụng các giá trị boolean. Bạn có thể chỉ định cả 3 thuộc tính tuỳ chỉnh này cho một chiếc xe cụ thể, cùng với thuộc tính tuỳ chỉnh class được đặt thành giá trị chuỗi thích hợp.

Khi sử dụng các thuộc tính theo cách này, bạn có thể sử dụng nhiều tính năng hữu ích để tìm xe cho những chuyến đi có nhu cầu cụ thể. Để biết hướng dẫn về cách sử dụng thuộc tính tuỳ chỉnh làm bộ lọc truy vấn, hãy xem bài viết Tìm kiếm xe.

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

Bạn có thể cập nhật các thuộc tính của xe bằng cách sử dụng UpdateVehicle hoặc UpdateVehicleAttributes. Mỗi khoá attributes chỉ có thể có một giá trị cho mỗi chiếc xe. Bạn khai báo các thuộc tính tuỳ chỉnh của xe 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.

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

Phần này cho biết cách cập nhật các trường của xe bằng UpdateVehicleRequest, trong đó có update_mask để cho biết những trường cần cập nhật. Hãy xem tài liệu về Vùng đệm giao thức trong phần mặt nạ trường để biết thông tin chi tiết.

Để cập nhật các trường khác ngoài last_location, bạn cần có đặc quyền Quản trị viên Fleet Engine theo yêu cầu.

Ví dụ: bật loại chuyến đi mới và thuộc tính tuỳ chỉnh

Ví dụ này cho phép back_to_back chuyến đi cho xe và cũng chỉ định một thuộc tính mới: class. 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 cho biết tất cả các thuộc tính tuỳ chỉnh mà bạn muốn giữ lại. Do đó, ví dụ này cho thấy giá trị cash_only được ghi để tránh bị ghi đè trong thao tác cập nhật chỉ định trường attributes.

Để chỉ cập nhật giá trị của một cặp khoá-giá trị thuộc tính, hãy dùng phương thức UpdateVehicleAttributes thay vì thêm trường attribute vào mặt nạ trường cho yêu cầu UpdateVehicle.

Hãy xem tài liệu tham khảo providers.vehicles.update cho gRPC và REST.

static final String PROJECT_ID = "project-id";
static final String VEHICLE_ID = "vid-8241890";

VehicleServiceBlockingStub vehicleService = VehicleService.newBlockingStub(channel);

String vehicleName = "providers/" + PROJECT_ID + "/vehicles/" + VEHICLE_ID;
Vehicle updatedVehicle = Vehicle.newBuilder()
    .setVehicleState(VehicleState.ONLINE)
    .addAllAttributes(ImmutableList.of(
        VehicleAttribute.newBuilder().setKey("class").setValue("ECONOMY").build(),
        VehicleAttribute.newBuilder().setKey("cash_only").setValue("false").build()))
    .setBackToBackEnabled(true)
    .build();

UpdateVehicleRequest updateVehicleRequest = UpdateVehicleRequest.newBuilder()
    .setName(vehicleName)
    .setVehicle(updatedVehicle)
    .setUpdateMask(FieldMask.newBuilder()
        .addPaths("vehicle_state")
        .addPaths("attributes")
        .addPaths("back_to_back_enabled"))
    .build();

try {
  Vehicle updatedVehicle =
      vehicleService.updateVehicle(updateVehicleRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case NOT_FOUND:
      // Most implementations will call CreateVehicle in this case
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}
// If no Exception, Vehicle updated successfully.

curl -X PUT \
  "https://fleetengine.googleapis.com/v1/providers/project-id/vehicles/vid-8241890?updateMask=vehicle_state,attributes,back_to_back_enabled" \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  --data-binary @- << EOM
{
    "vehicleState": "ONLINE",
    "attributes": [
      {"key": "class", "value": "LUXURY"},
      {"key": "cash_only", "value": "false"}
    ],
    "backToBackEnabled": true
}
EOM

Bước tiếp theo

• Cập nhật vị trí của xe