Fahrzeuge auflisten

Mit der Methode ListVehicles können Sie alle Fahrzeuge finden, die bestimmte Anfrageoptionen erfüllen. Die Methode ListVehicles gibt eine paginierte Liste von Fahrzeugen im Projekt zurück, die mit Abfragen in Fahrzeugfeldern übereinstimmen.

Nach Fahrzeugattributen filtern

Sie können diese Methode auch verwenden, um nach Fahrzeugattributen zu filtern. Diese fungieren als AND-Operator, wenn sie in Verbindung mit anderen Feldspezifikationen verwendet werden. Weitere Informationen zur Syntax von Filterabfragen finden Sie unter Filtern: AIP-160 für Beispiele. Weitere Informationen zum Erstellen von Fahrzeugattributen finden Sie im Feld Fahrzeug attribute im Leitfaden Fahrzeugfelder aktualisieren.

Beispiel für die Auflistung von Fahrzeugen

In diesem Beispiel wird mit dem String filter sowohl nach dem Feld vehicle_type als auch nach dem Feld attributes gefiltert. Es werden nur Fahrzeuge vom Typ AUTO angezeigt und der Wert LUXURY für das benutzerdefinierte Attribut class abgerufen.

Sie können die gRPC-Clientbibliotheken oder REST verwenden.

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

Nächste Schritte