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 dans les champs de véhicule.

Filtrer par attributs de véhicule

Vous pouvez également utiliser cette méthode pour filtrer les attributs de 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 la section Filtrage : AIP-160 pour obtenir des exemples. Pour en savoir plus sur la création d'attributs de véhicule, consultez le champ Attributs de véhicule dans le guide Mettre à jour les champs de véhicule.

Exemple de liste de véhicules

Cet exemple filtre les champs vehicle_type et attributes à l'aide de la chaîne filter, en n'affichant que les véhicules de type AUTO et en obtenant 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