Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 la section Champ "Attributs du véhicule" du guide Mettre à jour les champs du véhicule.
Exemple de fiche de véhicule
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.
Java
staticfinalStringPROJECT_ID="project-id";VehicleServiceBlockingStubvehicleService=VehicleService.newBlockingStub(channel);Stringparent="providers/"+PROJECT_ID;ListVehiclesRequestlistVehiclesRequest=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// successfullytry{ListVehiclesResponselistVehiclesResponse=vehicleService.listVehicles(listVehiclesRequest);}catch(StatusRuntimeExceptione){Statuss=e.getStatus();switch(s.getCode()){caseNOT_FOUND:break;casePERMISSION_DENIED:break;}return;}
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 2025/08/31 (UTC)."],[[["\u003cp\u003eUse the \u003ccode\u003eListVehicles\u003c/code\u003e method to retrieve vehicles matching specific criteria, such as vehicle type and attributes.\u003c/p\u003e\n"],["\u003cp\u003eFilter vehicles based on attributes, applying an AND operator when combining multiple filters.\u003c/p\u003e\n"],["\u003cp\u003eRefer to AIP-160 for filter query syntax and the Vehicle attributes field guide for attribute creation.\u003c/p\u003e\n"],["\u003cp\u003eThe provided Java and REST examples demonstrate filtering by vehicle type and a custom attribute.\u003c/p\u003e\n"]]],[],null,["# List vehicles\n\n| **Note:** **Before constructing a vehicle request** , read the requirements under [Vehicle requests](/maps/documentation/mobility/fleet-engine/essentials/vehicles#vehicle_requests) in the Introduction.\n\nUse the `ListVehicles` method to find all vehicles that satisfy some specific\nrequest options. The `ListVehicles` method returns a paginated list of vehicles\nin the project that matches queries across vehicle fields.\n\nFilter by vehicle attributes\n----------------------------\n\nYou can also use this method to filter on vehicle attributes, which act as AND\noperator when used in conjunction with other field specifications. For details\non filter query syntax, see [Filtering: AIP-160](https://google.aip.dev/160)\nfor examples. For details on creating vehicle attributes, see [Vehicle\nattributes field](/maps/documentation/mobility/fleet-engine/essentials/vehicles/on-demand-vehicle-fields#vehicle_attributes_field) in the **Update vehicle fields** guide.\n\nList vehicle example\n--------------------\n\nThis example filters on both the `vehicle_type` and `attributes` fields using\nthe `filter` string, showing only vehicles of type AUTO and obtaining the LUXURY\nvalue for the custom attribute of `class`. \n\n### Java\n\n static final String PROJECT_ID = \"\u003cvar translate=\"no\"\u003eproject-id\u003c/var\u003e\";\n\n VehicleServiceBlockingStub vehicleService = VehicleService.newBlockingStub(channel);\n\n String parent = \"providers/\" + PROJECT_ID;\n ListVehiclesRequest listVehiclesRequest = ListVehiclesRequest.newBuilder()\n .setParent(parent)\n .addTripTypes(TripType.EXCLUSIVE)\n .addVehicleTypes(VehicleType.newBuilder().setCategory(VehicleType.Category.AUTO))\n .setFilter(\"attributes.on_trip=\\\"false\\\"\")\n .setIncludeBackToBack(true) // Fleet Engine includes vehicles that are en route.\n .build();\n\n // Error handling\n // If matches are returned and the authentication passed, the request completed\n // successfully\n\n try {\n ListVehiclesResponse listVehiclesResponse =\n vehicleService.listVehicles(listVehiclesRequest);\n } catch (StatusRuntimeException e) {\n Status s = e.getStatus();\n switch (s.getCode()) {\n case NOT_FOUND:\n break;\n case PERMISSION_DENIED:\n break;\n }\n return;\n }\n\n### REST\n\n curl -X POST \\\n \"https://fleetengine.googleapis.com/v1/providers/\u003cvar translate=\"no\"\u003eproject-id\u003c/var\u003e/vehicles:list\" \\\n -H \"Authorization: Bearer $JWT\" \\\n -H \"Content-Type: application/json\" \\\n --data-binary @- \u003c\u003c EOM\n {\n \"vehicleTypes\": [{\"category\": \"AUTO\"}],\n \"filter\": \"attributes.class=\\\"LUXURY\\\"\",\n }\n EOM\n\nWhat's next\n-----------\n\n- [Search vehicles](/maps/documentation/mobility/fleet-engine/essentials/vehicles/on-demand-search-vehicle)"]]