Eine paginaierte Liste der Fahrzeuge, die mit einem Anbieter verknüpft sind und den Anfrageoptionen entsprechen.
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 Standard-Anfrageheader von Fleet Engine. |
page |
Die maximale Anzahl von Fahrzeugen, die zurückgegeben werden sollen. Standardwert: 100. |
page |
Der Wert von |
minimum |
Gibt die erforderliche Mindestkapazität des Fahrzeugs an. Der Wert für „ |
trip |
Die Antwort wird auf Fahrzeuge beschränkt, die mindestens einen der angegebenen Fahrttypen unterstützen. |
maximum |
Beschränkt die Antwort auf Fahrzeuge, die innerhalb des angegebenen Zeitraums Standortupdates an Fleet Engine gesendet haben. Stehende Fahrzeuge, die noch ihren Standort übermitteln, gelten nicht als veraltet. Falls vorhanden, muss es sich um eine gültige positive Dauer handeln. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
vehicle |
Erforderlich. Beschränkt die Antwort auf Fahrzeuge mit einer der angegebenen Typkategorien. |
required |
Caller können komplexe logische Vorgänge mit einer beliebigen Kombination der Felder
Beschränkt die Antwort auf Fahrzeuge mit den angegebenen Attributen. Dieses Feld ist eine Konjunktion/AND-Operation. Es sind maximal 50 erforderliche Attribute zulässig. Dies entspricht der maximal für ein Fahrzeug zulässigen Anzahl von Attributen. Jeder wiederholte String muss das Format „key:value“ haben. |
required |
Beschränkt die Antwort auf Fahrzeuge mit mindestens einem der angegebenen Attribute in jedem |
required |
Ähnlich wie bei
Die Antwort wird auf Fahrzeuge beschränkt, die mit allen Attributen in einem |
vehicle |
Beschränkt die Antwort auf Fahrzeuge mit diesem Fahrzeugstatus. |
on |
Geben Sie nur die Fahrzeuge mit der/den aktuellen Fahrt(en) 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 soll die Felder Dieser Filter fungiert als AND-Klausel mit anderen Einschränkungen wie Es werden nur Abfragen zu Fahrzeugattributen unterstützt (z. B. Außerdem werden alle Attribute als Strings gespeichert. Daher sind nur Stringvergleiche zulässig. Für den 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, der die zurückgegebenen Fahrzeuge auf diejenigen beschränkt, deren letzter bekannter Standort sich in dem vom 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 |
next |
Token zum Abrufen der nächsten Seite mit Fahrzeugen. Leer, wenn keine weiteren Fahrzeuge die Anfragekriterien erfüllen. |
total |
Erforderlich. Gesamtzahl der Fahrzeuge, die auf allen Seiten den Anfragekriterien entsprechen. |
Darstellungsbereich
Ein Breiten- und Längengrad-Darstellungsbereich, dargestellt als zwei diagonal gegenüberliegende Punkte low
und high
. Ein Darstellungsbereich gilt als geschlossener Bereich, d.h. er enthält seine Begrenzung. Die Breitengradgrenzen müssen zwischen -90 und 90 Grad liegen und die Längengradgrenzen zwischen -180 und 180 Grad. Beispiele für verschiedene Fälle:
Wenn
low
=high
, besteht der Darstellungsbereich aus diesem einzelnen Punkt.Wenn
low.longitude
>high.longitude
ist, wird der Längengradbereich umgekehrt (der Darstellungsbereich kreuzt die 180-Grad-Längenlinie).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 sein und das dargestellte Feld darf nicht leer sein (wie in den Definitionen oben angegeben). Ein leerer Darstellungsbereich führt zu einem Fehler.
Dieser Ansichtsbereich umschließt beispielsweise vollständig 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. |