Atualizar campos de veículos

Campo "Vehicle state"

O sistema pode definir o estado do veículo como OFFLINE ou ONLINE. Por exemplo, você pode definir o estado do veículo como ONLINE todos os dias às 9h e OFFLINE todos os dias às 17h.

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 sua frota em uma variedade maior de critérios de pesquisa. Isso aprimora os recursos dos seus apps para fornecer melhores correspondências de veículo do que você usaria critérios de pesquisa com base exclusivamente em outros campos do veículo. 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 class para diferenciar seus veículos de transporte por aplicativo nos níveis de classe. Você usaria os seguintes valores de string para representar os níveis de classe do veículo: ECONOMY, STANDARD e LUXURY.

No entanto, os valores dos atributos personalizados não precisam ser mutuamente exclusivos. Você pode usar critérios como aceita animais de estimação, não fumantes e capacidade de fazer viagens mais longas. Cada um deles pode ser um atributo personalizado separado que usa valores booleanos. Um veículo pode receber todos esses três atributos personalizados com o atributo personalizado class definido como o valor de string apropriado.

Usar atributos dessa maneira pode fornecer uma ampla variedade de recursos úteis para encontrar veículos para viagens com necessidades específicas. Para instruções sobre como usar atributos personalizados como filtros de consulta, consulte Pesquisar veículos.

Atualizar atributos do veículo

É possível atualizar os atributos do veículo usando UpdateVehicle ou UpdateVehicleAttributes. Cada chave attributes só pode ter um valor por veículo. Você declara atributos personalizados do veículo usando attributes na máscara de campo e, em seguida, fornecendo valores com base no método abaixo.

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

Nesta seção, mostramos como atualizar os campos do veículo usando UpdateVehicleRequest, 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.

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

Exemplo: ativar um novo tipo de viagem e um atributo personalizado

Este exemplo ativa as viagens back_to_back para o veículo e também especifica um novo atributo: class. Como observado em Atualizar atributos do veículo, atualizar o campo attributes usando essa abordagem exige que você indique todos os atributos personalizados que quer manter. Portanto, o exemplo mostra um valor cash_only gravado para preservá-lo de ser substituído durante uma operação de atualização que especifica o campo attributes.

Para atualizar apenas o valor de um par de atributos de chave-valor, use o método UpdateVehicleAttributes e não inclua o campo attribute na máscara de campo da solicitação UpdateVehicle.

Consulte a referência providers.vehicles.update para gRPC e REST (links em inglês).

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

A seguir

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