In diesem Dokument wird beschrieben, wie Sie Lieferfahrzeuge auflisten.
Umgebungen und Einschränkungen
Sie können Lieferfahrzeuge aus einer Server- oder Browserumgebung auflisten. Das Driver SDK unterstützt keine Einträge für Lieferfahrzeuge.
Für die Aufnahme von Lieferfahrzeugen ist umfassender Zugriff auf Lieferfahrzeuge erforderlich. Diese Funktion ist nur für vertrauenswürdige Nutzer vorgesehen. Verwenden Sie die Tokens Leser von Fleet Engine Delivery-Flotten oder Administrator von Fleet Engine Delivery, wenn Sie Anfragen zum Auflisten von Lieferfahrzeugen stellen.
Bei den aufgeführten Übermittlungsmedien werden die folgenden Felder aufgrund ihrer Auswirkungen auf die Antwortgröße entfernt:
CurrentRouteSegment
RemainingVehicleJourneySegments
Nutzung
Sie können Fahrzeuge nach Attributfiltern und Ansichtsgrenzen auflisten. Wenn Sie keinen Filter oder keinen Darstellungsbereich angeben, enthält die Antwort alle Auslieferungsmedien.
Liste mit Attributfiltern
Sie können Lieferfahrzeuge mithilfe der attributes
-Property filtern. Wenn Sie beispielsweise ein Attribut mit dem Schlüssel my_key
und dem Wert my_value
abfragen möchten, verwenden Sie attributes.my_key = my_value
. Wenn Sie nach mehreren Attributen suchen möchten, können Sie Abfragen mit den logischen Operatoren AND
und OR
wie in attributes.key1 = value1 AND
attributes.key2 = value2
verknüpfen. Eine vollständige Beschreibung der Syntax von Filterabfragen finden Sie unter AIP-160. Wenn Sie Filter mit dem Darstellungsbereich kombinieren, fungiert der Filter als AND
-Operator für den Darstellungsbereich. Weitere Informationen finden Sie unter Filterabfragen für Fahrzeugattribute.
Liste mit Darstellungsgrenzen
Sie können aufgelistete Lieferfahrzeuge mithilfe des Anfrageparameters viewport
nach Standort filtern. Der Anfrageparameter viewport
definiert Ansichtsportale mit zwei Begrenzungskoordinaten: ein Breiten- und Längengradpaar von high
(Nordosten) und low
(Südwesten). Anfragen werden abgelehnt, wenn sie einen hohen Breitengrad enthalten, der geografisch niedriger als ein niedriger Breitengrad ist.
Antworten auflisten
Listen mit Lieferfahrzeugen werden standardmäßig mit einer angemessenen Seitengröße paginiert. Wenn Sie eine Seitengröße angeben, gibt die Anfrage nur die im Limit angegebene Anzahl von Fahrzeugen zurück oder weniger. Wenn die angeforderte Seitengröße einen internen Höchstwert überschreitet, wird der interne Höchstwert verwendet. Die Standard- und die maximale Seitengröße sind jeweils 100 Fahrzeuge.
Eine Liste der Lieferfahrzeuge kann ein Token zum Lesen der nächsten Ergebnisseite enthalten. Ein Seitentoken ist nur in einer Antwort vorhanden, wenn weitere Seiten mit Lieferfahrzeugen zum Abrufen verfügbar sind. Wenn Sie die nächste Seite mit Aufgaben abrufen möchten, verwenden Sie das Seitentoken in einer Anfrage, die ansonsten mit der vorherigen Anfrage identisch ist.
Beispiele für Fahrzeuge auflisten
Sie können die Java gRPC-Bibliothek oder REST verwenden, um Lieferfahrzeuge in einer bestimmten Region mit einem bestimmten Attribut aufzulisten. Eine erfolgreiche Antwort kann trotzdem leer sein. In diesem Fall gibt es im angegebenen Ansichtsbereich keine Fahrzeuge mit dem angegebenen Attribut.
Java
static final String PROJECT_ID = "my-delivery-co-gcp-project";
DeliveryServiceBlockingStub deliveryService =
DeliveryServiceGrpc.newBlockingStub(channel);
// Tasks request
String parent = "providers/" + PROJECT_ID;
ListDeliveryVehiclesRequest listDeliveryVehiclesRequest =
ListDeliveryVehiclesRequest.newBuilder() // No need for the header
.setParent(parent)
.setViewport(
Viewport.newBuilder()
.setHigh(LatLng.newBuilder()
.setLatitude(37.45)
.setLongitude(-122.06)
.build())
.setLow(LatLng.newBuilder()
.setLatitude(37.41)
.setLongitude(-122.11)
.build())
.setFilter("attributes.my_key = my_value")
.build();
try {
ListDeliveryVehiclesResponse listDeliveryVehiclesResponse =
deliveryService.listDeliveryVehicles(listDeliveryVehiclesRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND:
break;
case PERMISSION_DENIED:
break;
}
return;
}
REST
# HTTP request
html GET https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles
# Request with a filter
# Request sets JWT, PROJECT_ID, and VEHICLE_ID in the local environment
curl -H "Authorization: Bearer ${JWT}" \
"https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles?filter=attributes.my_key%20%3D%20my_value%20&viewport.high.latitude=37.45&viewport.high.longitude=-122.06&viewport.low.latitude=37.41&viewport.low.longitude=-122.11"
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
// JSON representation
{
"deliveryVehicles": [
{
object (DeliveryVehicle)
}
],
"nextPageToken": string,
"totalSize": integer
}