Actualizar campos de vehículos

Campo de estado del vehículo

Tu sistema puede establecer el estado del vehículo en OFFLINE o ONLINE. Por ejemplo, puedes establecer el estado del vehículo en ONLINE todos los días a las 9 a.m. y en OFFLINE todos los días a las 5 p.m.

Campo de atributos del vehículo

Usa el campo attributes del vehículo para crear criterios personalizados que permitan a tus consumidores o operadores de flota encontrar vehículos en tu flota a través de una variedad más amplia de criterios de búsqueda. Esto mejora las capacidades de tus apps para proporcionar mejores coincidencias de vehículos que las que obtendrías si usaras criterios de búsqueda basados únicamente en otros campos de vehículos. Cada vehículo puede tener como máximo 100 atributos, y cada uno debe tener una clave única. Los valores pueden ser cadenas, valores booleanos o números.

Por ejemplo, puedes declarar un atributo personalizado llamado class para diferenciar tus vehículos de viajes compartidos en diferentes niveles de clase. Usarías los siguientes valores de cadena para representar los niveles de clase de los vehículos: ECONOMY, STANDARD y LUXURY.

Sin embargo, los valores de los atributos personalizados no tienen que ser mutuamente excluyentes. Puedes usar criterios como pet-friendly, non-smoking y able to take longer trips. Cada uno de ellos podría ser un atributo personalizado independiente que use valores booleanos. A un vehículo determinado se le podrían asignar los tres atributos personalizados junto con el atributo personalizado class establecido en el valor de cadena adecuado.

Usar los atributos de esta manera puede proporcionarte una amplia variedad de funciones útiles para encontrar vehículos para viajes con necesidades específicas. Para obtener instrucciones sobre cómo usar atributos personalizados como filtros de consulta, consulta Cómo buscar vehículos.

Actualiza los atributos del vehículo

Puedes actualizar los atributos del vehículo con UpdateVehicle o UpdateVehicleAttributes. Cada clave attributes solo puede tener un valor por vehículo. Declaras atributos personalizados del vehículo con attributes en la máscara de campo y, luego, proporcionas valores según el método que se indica a continuación.

Ejemplo de actualización de campos de vehículos

En esta sección, se muestra cómo actualizar los campos de vehículos con UpdateVehicleRequest, que incluye un update_mask para indicar qué campos se deben actualizar. Consulta la documentación de Protocol Buffers sobre máscaras de campo para obtener más detalles.

Las actualizaciones de campos que no sean last_location requieren privilegios de Administrador según demanda de Fleet Engine.

Ejemplo: Habilita un nuevo tipo de viaje y un atributo personalizado

En este ejemplo, se habilitan los viajes back_to_back para el vehículo y también se especifica un atributo nuevo: class. Como se indicó anteriormente en Actualiza los atributos del vehículo, para actualizar el campo attributes con este enfoque, debes indicar todos los atributos personalizados que deseas conservar. Por lo tanto, en el ejemplo, se muestra un valor cash_only escrito para evitar que se reemplace durante una operación de actualización que especifica el campo attributes.

Para actualizar solo el valor de un par clave-valor de atributo, usa el UpdateVehicleAttributes método en su lugar y no incluyas el attribute campo en la máscara de campo para la UpdateVehicle solicitud.

Consulta la referencia de providers.vehicles.update para gRPC y 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

¿Qué sigue?

• Actualiza la ubicación de un vehículo