Lister les véhicules

Utilisez la méthode ListVehicles pour trouver tous les véhicules qui répondent à certaines options de requête spécifiques. La méthode ListVehicles renvoie une liste paginée des véhicules du projet qui correspondent aux requêtes sur les champs des véhicules.

Filtrer par attributs du véhicule

Vous pouvez également utiliser cette méthode pour filtrer les attributs du véhicule, qui agissent comme un opérateur AND lorsqu'ils sont utilisés conjointement avec d'autres spécifications de champ. Pour en savoir plus sur la syntaxe des requêtes de filtre, consultez Filtrage : AIP-160 pour obtenir des exemples. Pour savoir comment créer des attributs de véhicule, consultez Champ "Attributs du véhicule" dans le guide Mettre à jour les champs du véhicule.

Exemple de liste de véhicules

Cet exemple filtre les champs vehicle_type et attributes à l'aide de la chaîne filter. Il n'affiche que les véhicules de type AUTO et obtient la valeur LUXURY pour l'attribut personnalisé class.

Vous pouvez utiliser les bibliothèques clientes gRPC ou REST.

Java

static final String PROJECT_ID = "project-id";

VehicleServiceBlockingStub vehicleService = VehicleService.newBlockingStub(channel);

String parent = "providers/" + PROJECT_ID;
ListVehiclesRequest listVehiclesRequest = ListVehiclesRequest.newBuilder()
    .setParent(parent)
    .addTripTypes(TripType.EXCLUSIVE)
    .addVehicleTypes(VehicleType.newBuilder().setCategory(VehicleType.Category.AUTO))
    .setFilter("attributes.on_trip=\"false\"")
    .setIncludeBackToBack(true) // Fleet Engine includes vehicles that are en route.
    .build();

// Error handling
// If matches are returned and the authentication passed, the request completed
// successfully

try {
  ListVehiclesResponse listVehiclesResponse =
      vehicleService.listVehicles(listVehiclesRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case NOT_FOUND:
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

REST

curl -X POST \
  "https://fleetengine.googleapis.com/v1/providers/project-id/vehicles:list" \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  --data-binary @- << EOM
{
  "vehicleTypes": [{"category": "AUTO"}],
  "filter": "attributes.class=\"LUXURY\"",
}
EOM

Étape suivante