Fahrzeuge auflisten

Mit der Methode ListVehicles können Sie alle Fahrzeuge ermitteln, die bestimmte Anfrageoptionen erfüllen. Die Methode ListVehicles gibt eine paginierte Liste von Fahrzeugen im Projekt zurück, die mit Abfragen für Fahrzeugfelder übereinstimmt.

Nach Fahrzeugattributen filtern

Sie können diese Methode auch verwenden, um nach Fahrzeugattributen zu filtern, die in Verbindung mit anderen Feldspezifikationen als AND-Operator fungieren. Weitere Informationen zur Filtersyntax finden Sie unter Filtern: AIP-160. Weitere Informationen zum Erstellen von Fahrzeugattributen finden Sie im Leitfaden Fahrzeugfelder aktualisieren im Abschnitt Feld für Fahrzeugattribute.

Beispiel für ein Fahrzeug in einer Liste

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