Method: providers.vehicles.list

string

Erforderlich. Muss das Format providers/{provider} haben. Der Anbieter muss die Projekt-ID des Google Cloud-Projekts sein, zu dem das Dienstkonto gehört, das diesen Aufruf durchführt, z. B. sample-cloud-project.

object (RequestHeader)

Der standardmäßige Fleet Engine-Anfrageheader.

integer

Die maximale Anzahl der zurückzugebenden Fahrzeuge. Standardwert: 100.

string

Der Wert von nextPageToken, der von einem vorherigen Aufruf von vehicles.list bereitgestellt wurde, sodass Sie durch Fahrzeuggruppen blättern können. Der Wert ist nicht definiert, wenn die Filterkriterien der Anfrage nicht mit den Filterkriterien für den vorherigen Aufruf von vehicles.list übereinstimmen.

integer

Gibt die erforderliche Mindestkapazität des Fahrzeugs an. Der maximumCapacity für alle zurückgegebenen Fahrzeuge ist größer oder gleich diesem Wert. Wenn festgelegt, muss der Wert größer oder gleich 0 sein.

enum (TripType)

Beschränkt die Antwort auf Fahrzeuge, die mindestens einen der angegebenen Fahrttypen unterstützen.

string (Duration format)

Beschränkt die Antwort auf Fahrzeuge, die innerhalb des angegebenen Zeitraums Standortaktualisierungen an Fleet Engine gesendet haben. Stehende Fahrzeuge, deren Standort noch übertragen wird, gelten nicht als veraltet. Muss eine gültige positive Dauer sein, falls vorhanden.

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".

enum (Category)

Erforderlich. Beschränkt die Antwort auf Fahrzeuge mit einer der angegebenen Typkategorien. UNKNOWN ist nicht zulässig.

string

Aufrufer können komplexe logische Operationen mit einer beliebigen Kombination der Felder requiredAttributes, requiredOneOfAttributes und requiredOneOfAttributeSets bilden.

requiredAttributes ist eine Liste; requiredOneOfAttributes verwendet eine Nachricht, die eine Liste von Listen zulässt. In Kombination ermöglichen die beiden Felder die Zusammensetzung des Ausdrucks:

(requiredAttributes[0] AND requiredAttributes[1] AND ...)
AND
(requiredOneOfAttributes[0][0] OR requiredOneOfAttributes[0][1] OR
...)
AND
(requiredOneOfAttributes[1][0] OR requiredOneOfAttributes[1][1] OR
...)

Beschränkt die Antwort auf Fahrzeuge mit den angegebenen Attributen. Dieses Feld ist eine Konjunktion/UND-Operation. Es sind maximal 50 requiredAttributes zulässig. Das entspricht der maximal für ein Fahrzeug zulässigen Anzahl von Attributen. Jeder wiederkehrende String muss das Format „key:value“ haben.

string

Beschränkt die Antwort auf Fahrzeuge mit mindestens einem der angegebenen Attribute in jeder VehicleAttributeList. In jeder Liste muss ein Fahrzeug mit mindestens einem der Attribute übereinstimmen. Dieses Feld ist eine einschließende Disjunktions-/ODER-Operation in jeder VehicleAttributeList und eine Konjunktion/AND-Operation für die Sammlung von VehicleAttributeList. Jeder wiederkehrende String muss das Format „Schlüssel1:Wert1|Schlüssel2:Wert2|Schlüssel3:Wert3“ haben.

string

requiredOneOfAttributeSets bietet zusätzliche Funktionen.

Ähnlich wie bei requiredOneOfAttributes verwendet requiredOneOfAttributeSets eine Nachricht, die eine Liste von Listen und Ausdrücke wie diese zulässt:

(requiredAttributes[0] AND requiredAttributes[1] AND ...)
AND
(
  (requiredOneOfAttributeSets[0][0] AND
  requiredOneOfAttributeSets[0][1] AND
  ...)
  OR
  (requiredOneOfAttributeSets[1][0] AND
  requiredOneOfAttributeSets[1][1] AND
  ...)
)

Beschränkt die Antwort auf Fahrzeuge, die allen Attributen in einem VehicleAttributeList entsprechen. In jeder Liste muss ein Fahrzeug mit allen Attributen übereinstimmen. Dieses Feld ist eine Konjunktion/AND-Operation in jeder VehicleAttributeList- und inklusiven Disjunktions-/ODER-Operation für die Sammlung von VehicleAttributeList. Jeder wiederkehrende String muss das Format „Schlüssel1:Wert1|Schlüssel2:Wert2|Schlüssel3:Wert3“ haben.

enum (VehicleState)

Beschränkt die Antwort auf Fahrzeuge mit diesem Fahrzeugstatus.

boolean

Geben Sie nur Fahrzeuge mit aktuellen Fahrten zurück.

string

Optional. Eine Filterabfrage, die beim Auflisten von Fahrzeugen angewendet werden soll. Beispiele für die Filtersyntax finden Sie unter http://aip.dev/160.

Dieses Feld ersetzt die Felder requiredAttributes, requiredOneOfAttributes und required_one_of_attributes_sets. Wenn hier ein nicht leerer Wert angegeben wird, müssen die folgenden Felder leer sein: requiredAttributes, requiredOneOfAttributes und required_one_of_attributes_sets.

Dieser Filter fungiert als AND-Klausel mit anderen Einschränkungen wie vehicleState oder onTripOnly.

Es werden nur Suchanfragen für Fahrzeugattribute wie attributes.<key> = <value> oder attributes.<key1> = <value1> AND attributes.<key2> = <value2> unterstützt. In einer Filterabfrage sind maximal 50 Einschränkungen zulässig.

Außerdem werden alle Attribute als Strings gespeichert, sodass nur Stringvergleiche unterstützt werden. Für einen Vergleich mit Zahlen- oder booleschen Werten müssen die Werte explizit in Anführungszeichen gesetzt werden, damit sie als Strings behandelt werden (z. B. attributes.<key> = "10" oder attributes.<key> = "true").

object (Viewport)

Optional. Ein Filter, mit dem die zurückgegebenen Fahrzeuge auf diejenigen eingeschränkt werden, deren letzter bekannter Standort sich in dem durch den Darstellungsbereich definierten rechteckigen Bereich befand.

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

Erforderlich. Der Tiefstpunkt des Darstellungsbereichs.

object (LatLng)

Erforderlich. Der höchste Punkt des Darstellungsbereichs.