Atualizar campos de veículos de entrega

Campo de atributos do veículo

Use o campo attributes do veículo para criar critérios personalizados e permitir que os consumidores ou operadores de frota encontrem veículos na frota com uma variedade maior de critérios de pesquisa. Isso melhora os recursos dos seus apps para fornecer melhores correspondências de veículos do que você usaria ao usar critérios de pesquisa com base apenas em outros campos de veículos. Cada veículo pode ter no máximo 100 atributos, e cada um precisa ter uma chave exclusiva. Os valores podem ser strings, booleanos ou números.

Por exemplo, você pode declarar um atributo personalizado chamado zone para diferenciar em qual zona da cidade os veículos de entrega operam. Você usaria valores de string como os seguintes para representar zonas diferentes: 1B, 2C e 3A. Assim, é possível usar um filtro no rastreamento de frota para mostrar apenas os veículos trabalhando em uma zona específica para o operador responsável por ela.

No entanto, os valores de atributos personalizados não precisam ser mutuamente exclusivos. Use critérios como available-at-night e has-refrigeration. Cada um deles pode ser um atributo personalizado separado que usa valores booleanos. Um determinado veículo pode receber os três atributos personalizados com o atributo personalizado zona definido para o valor de string adequado.

Atualizar atributos do veículo

Cada chave attributes pode ter apenas um valor por veículo. Você declara atributos personalizados de veículos usando attributes na máscara de campo e, em seguida, fornece valores com base no método abaixo.

Essa API UpdateDeliveryVehicle não permite atualizar apenas um atributo. Ao usar esse método, qualquer uso do campo attributes na máscara de campo faz com que o conjunto completo de atributos do veículo seja declarado novamente para o veículo. Isso resulta na substituição de qualquer atributo preexistente não explicitamente incluído na máscara de campo. Se você usar esse método para declarar um novo atributo personalizado, também precisará declarar novamente todos os atributos personalizados que quiser que o veículo mantenha. Se você excluir o attributes na máscara de campo, esse método vai deixar os atributos personalizados atuais como foram definidos anteriormente para o veículo. Se você usar attributes na máscara de campo, mas sem definir valores, isso será equivalente a remover todos os atributos personalizados do veículo.

Exemplo de atualização dos campos do veículo

Nesta seção, mostramos como atualizar os campos do veículo usando UpdateDeliveryVehicleRequest, que inclui um update_mask para indicar quais campos atualizar. Consulte a documentação dos buffers de protocolo sobre máscaras de campo para saber mais detalhes.

As atualizações em campos diferentes de last_location exigem privilégios de Administrador de entrega do Fleet Engine.

Exemplo: definir atributo personalizado

Este exemplo especifica um novo atributo: zone. Conforme observado em Atualizar atributos do veículo anteriormente, para atualizar o campo attributes usando essa abordagem, é necessário indicar todos os atributos personalizados que você quer manter. Portanto, o exemplo mostra um valor available-at-night gravado para evitar que ele seja substituído durante uma operação de atualização que especifica o campo attributes.

Consulte a referência 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

A seguir

• Atualizar a localização de um veículo de entrega