Gibt eine paginierte Liste von Fahrzeugen zurück, die einem Anbieter zugeordnet sind und mit den Anfrageoptionen übereinstimmen.
HTTP-Anfrage
GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
parent |
Erforderlich. Muss das Format |
Abfrageparameter
Parameter | |
---|---|
header |
Der standardmäßige Fleet Engine-Anfrageheader. |
pageSize |
Die maximale Anzahl der zurückzugebenden Fahrzeuge. Standardwert: 100. |
pageToken |
Der Wert von |
minimumCapacity |
Gibt die erforderliche Mindestkapazität des Fahrzeugs an. Der |
tripTypes[] |
Beschränkt die Antwort auf Fahrzeuge, die mindestens einen der angegebenen Fahrttypen unterstützen. |
maximumStaleness |
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 „ |
vehicleTypeCategories[] |
Erforderlich. Beschränkt die Antwort auf Fahrzeuge mit einer der angegebenen Typkategorien. |
requiredAttributes[] |
Aufrufer können komplexe logische Operationen mit einer beliebigen Kombination der Felder
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. |
requiredOneOfAttributes[] |
Beschränkt die Antwort auf Fahrzeuge mit mindestens einem der angegebenen Attribute in jeder |
requiredOneOfAttributeSets[] |
Ähnlich wie bei
Beschränkt die Antwort auf Fahrzeuge, die allen Attributen in einem |
vehicleState |
Beschränkt die Antwort auf Fahrzeuge mit diesem Fahrzeugstatus. |
onTripOnly |
Geben Sie nur Fahrzeuge mit aktuellen Fahrten zurück. |
filter |
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 Dieser Filter fungiert als AND-Klausel mit anderen Einschränkungen wie Es werden nur Suchanfragen für Fahrzeugattribute wie 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. |
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. |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
vehicles.list
-Antwortnachricht.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"vehicles": [
{
object ( |
Felder | |
---|---|
vehicles[] |
Fahrzeuge, die den Kriterien in der Anfrage entsprechen. Die maximale Anzahl der zurückgegebenen Fahrzeuge wird durch das Feld |
nextPageToken |
Token zum Abrufen der nächsten Seite mit Fahrzeugen. Leer, wenn keine weiteren Fahrzeuge vorhanden sind, die den Anfragekriterien entsprechen. |
totalSize |
Erforderlich. Gesamtzahl der Fahrzeuge, die den Anfragekriterien auf allen Seiten entsprechen. |
Darstellungsbereich
Ein Darstellungsbereich mit Breiten- und Längengrad, der als zwei diagonal gegenüberliegende low
- und high
-Punkte dargestellt wird. Ein Darstellungsbereich wird als geschlossener Bereich betrachtet, d.h. er enthält seine Begrenzung. Die Breitengradgrenzen müssen zwischen -90 und 90 Grad (einschließlich) und die Längengradgrenzen zwischen -180 und 180 Grad liegen. Verschiedene Fälle:
Wenn
low
=high
ist, besteht der Darstellungsbereich aus diesem einzelnen Punkt.Wenn
low.longitude
>high.longitude
ist, ist der Längengradbereich invertiert, d. h., der Darstellungsbereich kreuzt die 180-Grad-Längengradlinie.Wenn
low.longitude
= -180 Grad undhigh.longitude
= 180 Grad ist, enthält der Darstellungsbereich alle Längengrade.Wenn
low.longitude
= 180 Grad undhigh.longitude
= -180 Grad ist, ist der Längengradbereich leer.Wenn
low.latitude
>high.latitude
ist, ist der Breitengradbereich leer.
Sowohl low
als auch high
müssen ausgefüllt werden und das dargestellte Feld darf nicht leer sein (wie in den Definitionen oben angegeben). Ein leerer Darstellungsbereich führt zu einem Fehler.
Dieser Darstellungsbereich umfasst beispielsweise New York City:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
JSON-Darstellung |
---|
{ "low": { object ( |
Felder | |
---|---|
low |
Erforderlich. Der Tiefstpunkt des Darstellungsbereichs. |
high |
Erforderlich. Der höchste Punkt des Darstellungsbereichs. |