Обновить поля средства доставки

Поле атрибутов транспортного средства

Используйте поле attributes транспортного средства» для создания настраиваемых критериев, которые позволят вашим клиентам или операторам автопарков находить автомобили в вашем автопарке по более широкому спектру критериев поиска. Это расширяет возможности ваших приложений по предоставлению более точных результатов поиска по сравнению с использованием критериев поиска, основанных исключительно на других полях. У каждого транспортного средства может быть не более 100 атрибутов, и каждый должен иметь уникальный ключ. Значения могут быть строковыми, логическими или числовыми.

Например, вы можете объявить настраиваемый атрибут с именем «zone» , чтобы указать, в какой зоне города работают ваши автомобили доставки. Для обозначения различных зон можно использовать строковые значения, например, следующие: 1B , 2C и 3A . Затем можно использовать фильтр в Fleet Tracking, чтобы показывать оператору, ответственному за эту зону, только автомобили, работающие в определённой зоне.

Однако значения настраиваемых атрибутов не обязательно должны быть взаимоисключающими. Вы можете использовать такие критерии, как «доступно ночью» и «есть ли охлаждение» . Каждый из них может быть отдельным настраиваемым атрибутом, использующим логические значения. Транспортному средству можно назначить все три этих настраиваемых атрибута вместе с настраиваемым атрибутом «зона» , которому будет присвоено соответствующее строковое значение.

Обновить атрибуты транспортного средства

Каждый ключ attributes может иметь только одно значение для транспортного средства . Вы можете объявить пользовательские атрибуты транспортного средства, используя attributes в маске поля, а затем указать значения, используя метод, описанный ниже.

API UpdateDeliveryVehicle не позволяет обновлять только один атрибут. При использовании этого метода любое использование поля attributes в маске поля приводит к переопределению всего набора атрибутов транспортного средства. Это приводит к перезаписи любого существующего атрибута, не включённого явно в маску поля. При использовании этого метода для объявления нового настраиваемого атрибута необходимо также переопределить каждый настраиваемый атрибут, который должен быть сохранен в транспортном средстве. Если исключить attributes из маски поля, этот метод оставит существующие настраиваемые атрибуты такими, какими они были ранее определены для транспортного средства. Использование attributes в маске поля без установки значений эквивалентно удалению всех настраиваемых атрибутов транспортного средства.

Пример обновления полей транспортного средства

В этом разделе показано, как обновлять поля транспортного средства с помощью UpdateDeliveryVehicleRequest , который включает update_mask для указания обновляемых полей. Подробнее см. в документации Protocol Buffers о масках полей .

Для обновления полей, отличных от last_location требуются права администратора Fleet Engine Delivery .

Пример: установить пользовательский атрибут

В этом примере задаётся новый атрибут: zone . Как отмечалось ранее в разделе «Обновление атрибутов транспортного средства» , при обновлении поля attributes с использованием этого подхода требуется указать все настраиваемые атрибуты, которые вы хотите сохранить. Поэтому в примере показано значение available-at-night , записанное для защиты от перезаписи во время операции обновления, которая определяет поле attributes .

См. ссылку на 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

Что дальше?

• Обновить местоположение транспортного средства доставки