Package maps.fleetengine.v1

BatteryStatus

Status des Akkus, z. B. ob er voll oder aufgeladen wird

PowerSource

Status der Akkustromquelle.

float

Aktueller Akkustand in Prozent [0–100].

SpeedReadingInterval

Verkehrsgeschwindigkeit auf dem Weg vom vorherigen bis zum aktuellen Wegpunkt.

string

Die Strecke, die der Fahrer vom vorherigen bis zum aktuellen Wegpunkt zurücklegt. Dieser Pfad enthält Orientierungspunkte, damit Clients Verkehrsmarkierungen entlang des Pfads anzeigen können (siehe speed_reading_interval). Die Decodierung wird noch nicht unterstützt.

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.

string

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

string

Erforderlich. Eindeutige Reise-ID. Es gelten die folgenden Einschränkungen:

• Muss ein gültiger Unicode-String sein.
• Sie ist auf maximal 64 Zeichen beschränkt.
• Nach der Unicode-Normalisierungsform C normalisiert.
• Darf keines der folgenden ASCII-Zeichen enthalten: '/', ':', '?', , oder '#'.

Trip

Erforderlich. Zu erstellende Fahrtentität

Beim Erstellen einer Reise sind folgende Felder erforderlich:

• trip_type
• pickup_point

Die folgenden Felder werden verwendet, wenn Sie sie angeben:

• number_of_passengers
• vehicle_id
• dropoff_point
• intermediate_destinations
• vehicle_waypoints

Alle anderen Trip-Felder werden ignoriert. Beispielsweise beginnen alle Fahrten mit dem trip_status NEW, auch wenn Sie in der Erstellungsanfrage einen trip_status mit CANCELED übergeben.

intermediate_destinations wird nur für Fahrten mit EXCLUSIVE unterstützt.

Wenn vehicle_id für eine gemeinsame Fahrt festgelegt ist, müssen Sie die Liste mit Trip.vehicle_waypoints angeben, um die Reihenfolge der verbleibenden Wegpunkte für das Fahrzeug anzugeben. Andernfalls ist die Wegpunktreihenfolge nicht festgelegt.

Wenn Sie Trip.vehicle_waypoints angeben, muss die Liste alle verbleibenden Wegpunkte der Fahrten des Fahrzeugs ohne zusätzliche Wegpunkte enthalten. Sie müssen diese Wegpunkte so anordnen, dass der Abholpunkt bei einer bestimmten Fahrt vor Zwischenzielen und alle Zwischenziele vor den Ausstiegspunkten liegen. Die Wegpunkte einer EXCLUSIVE-Fahrt dürfen sich nicht mit anderen Fahrten verschränken.

Die Felder trip_id, waypoint_type und location werden verwendet. Alle anderen TripWaypoint-Felder in vehicle_waypoints werden ignoriert.

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.

string

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

string

Erforderlich. Eindeutige Fahrzeug-ID. Es gelten die folgenden Einschränkungen:

• Muss ein gültiger Unicode-String sein.
• Sie ist auf maximal 64 Zeichen beschränkt.
• Nach der Unicode-Normalisierungsform C normalisiert.
• Darf keines der folgenden ASCII-Zeichen enthalten: '/', ':', '?', , oder '#'.

Vehicle

Erforderlich. Die zu erstellende Fahrzeugentität. Beim Erstellen eines Fahrzeugs sind die folgenden Felder erforderlich:

• vehicleState
• supportedTripTypes
• maximumCapacity
• vehicleType

Beim Erstellen eines Fahrzeugs werden die folgenden Felder ignoriert:

• name
• currentTrips
• availableCapacity
• current_route_segment
• current_route_segment_end_point
• current_route_segment_version
• current_route_segment_traffic
• route
• waypoints
• waypoints_version
• remaining_distance_meters
• remaining_time_seconds
• eta_to_next_waypoint
• navigation_status

Alle anderen Felder sind optional und werden verwendet, sofern sie angegeben werden.

LocationPowerSaveMode

Gibt an, wie sich die Standortfunktionen auf dem Gerät verhalten, wenn der Energiesparmodus aktiviert ist.

bool

Gibt an, ob sich das Gerät derzeit im Energiesparmodus befindet.

bool

Gibt an, ob das Gerät interaktiv ist.

BatteryInfo

Informationen zum Akkustatus.

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.

string

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

TripView

Die Teilmenge der Trip-Felder, die zurückgegeben werden sollen, und ihre Interpretation.

Timestamp

Gibt den minimalen Zeitstempel (exklusiv) an, für den Trip.route- oder Trip.current_route_segment-Daten abgerufen werden. Wenn Routendaten seit diesem Zeitstempel unverändert sind, wird das Routingfeld nicht in der Antwort festgelegt. Wenn kein Minimum angegeben ist, werden die Routendaten immer abgerufen.

Timestamp

Gibt den minimalen Zeitstempel (exklusiv) an, für den Trip.remaining_waypoints abgerufen werden. Wenn sie seit diesem Zeitstempel unverändert sind, werden remaining_waypoints nicht in der Antwort festgelegt. Wenn dieses Feld nicht angegeben ist, wird immer remaining_waypoints abgerufen.

PolylineFormatType

Das zurückgegebene aktuelle Routenformat: LAT_LNG_LIST_TYPE (in Trip.route) oder ENCODED_POLYLINE_TYPE (in Trip.current_route_segment). Der Standardwert ist LAT_LNG_LIST_TYPE.

Timestamp

Gibt den minimalen Zeitstempel (exklusiv) an, für den Trip.current_route_segment_traffic abgerufen wird. Wenn die Verkehrsdaten seit diesem Zeitstempel unverändert sind, wird das Feld current_route_segment_traffic in der Antwort nicht festgelegt. Wenn kein Minimum angegeben ist, werden die Verkehrsdaten immer abgerufen. Traffic ist nur für Kunden der On-Demand Rides and Deliveries-Lösung verfügbar.

Timestamp

Gibt den minimalen Zeitstempel (exklusiv) an, für den Trip.remaining_waypoints.traffic_to_waypoint- und Trip.remaining_waypoints.path_to_waypoint-Daten abgerufen werden. Wenn die Daten seit diesem Zeitstempel unverändert sind, werden die Felder oben in der Antwort nicht festgelegt. Wenn remaining_waypoints_route_version nicht angegeben ist, werden Traffic und Pfad immer abgerufen.

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.

string

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

Timestamp

Gibt den minimalen Zeitstempel (exklusiv) an, für den Vehicle.current_route_segment abgerufen wird. Wenn die Route seit diesem Zeitstempel unverändert ist, wird das Feld current_route_segment nicht in der Antwort festgelegt. Wenn kein Minimum angegeben ist, wird current_route_segment immer abgerufen.

Timestamp

Gibt den minimalen Zeitstempel (exklusiv) an, für den Vehicle.waypoints-Daten abgerufen werden. Wenn die Wegpunkte seit diesem Zeitstempel unverändert sind, werden die vehicle.waypoints-Daten nicht in der Antwort festgelegt. Wenn dieses Feld nicht angegeben ist, wird immer vehicle.waypoints abgerufen.

string

Erforderlich. CLDR-Länder-/Regionscode. z. B. US für die USA oder IN für Indien.

string

Die letzte Ziffer des Nummernschilds oder „-1“ an, dass kein numerischer Wert im Kfz-Kennzeichen vorhanden ist.

• „ABC 1234“ -> „4“
• „AB 123 CD“ -> „3“
• „ABCDEF“ -> „-1“

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.

string

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

int32

Die maximale Anzahl von Fahrzeugen, die zurückgegeben werden sollen. Standardwert: 100.

string

Der Wert von next_page_token, der durch einen vorherigen Aufruf von ListVehicles bereitgestellt wurde, damit Sie durch Fahrzeuggruppen paginieren können. Der Wert ist nicht definiert, wenn die Filterkriterien der Anfrage nicht mit den Filterkriterien für den vorherigen Aufruf von ListVehicles übereinstimmen.

Int32Value

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

TripType

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

Duration

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 die Dauer eine gültige positive Dauer sein.

Category

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

string

Aufrufer können mithilfe einer beliebigen Kombination der Felder required_attributes, required_one_of_attributes und required_one_of_attribute_sets komplexe logische Operationen erstellen.

required_attributes ist eine Liste. required_one_of_attributes verwendet eine Nachricht, die eine Liste von Listen zulässt. In Kombination ermöglichen die beiden Felder die Zusammensetzung dieses Ausdrucks:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

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.

string

Beschränkt die Antwort auf Fahrzeuge mit mindestens einem der angegebenen Attribute in jedem VehicleAttributeList. In jeder Liste muss ein Fahrzeug mit mindestens einem der Attribute übereinstimmen. Dieses Feld ist eine inklusive Disjunktion/OR-Operation in jeder VehicleAttributeList und eine Konjunktion/AND-Operation für die Sammlung von VehicleAttributeList. Jeder wiederholte String muss das Format „key1:value1|key2:value2|key3:value3“ haben.

string

required_one_of_attribute_sets bietet zusätzliche Funktionen.

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

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

Beschränkt die Antwort auf Fahrzeuge, die mit allen Attributen in einem VehicleAttributeList übereinstimmen. 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 innerhalb der Sammlung von VehicleAttributeList. Jeder wiederholte String muss das Format „key1:value1|key2:value2|key3:value3“ haben.

VehicleState

Beschränkt die Antwort auf Fahrzeuge mit diesem Fahrzeugstatus.

bool

Geben Sie nur die Fahrzeuge mit der/n aktuellen Fahrt(en) 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 required_attributes, required_one_of_attributes und required_one_of_attributes_sets. Wenn hier ein nicht leerer Wert angegeben wird, müssen die folgenden Felder leer sein: required_attributes, required_one_of_attributes und required_one_of_attributes_sets.

Dieser Filter fungiert als AND-Klausel mit anderen Einschränkungen wie vehicle_state oder on_trip_only.

Beachten Sie, dass nur Anfragen für Fahrzeugattribute unterstützt werden, z. B. attributes.<key> = <value> oder attributes.<key1> = <value1> AND attributes.<key2> = <value2>. In einer Filterabfrage sind maximal 50 Einschränkungen zulässig.

Außerdem werden alle Attribute als Strings gespeichert, sodass nur Stringvergleiche für Attribute unterstützt werden. 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. attributes.<key> = "10" oder attributes.<key> = "true").

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.

Vehicle

Fahrzeuge, die den Kriterien in der Anfrage entsprechen. Die maximale Anzahl der zurückgegebenen Fahrzeuge wird durch das Feld page_size in der Anfrage bestimmt.

string

Token zum Abrufen der nächsten Seite mit Fahrzeugen oder leer, wenn es keine weiteren Fahrzeuge gibt, die die Anfragekriterien erfüllen.

int64

Erforderlich. Gesamtzahl der Fahrzeuge, die den Anfragekriterien auf allen Seiten entsprechen.

string

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

string

Erforderlich. Zweistelliger Ländercode des Landes, in dem die Fahrt stattfindet. Der Preis wird entsprechend dem Ländercode definiert.

BillingPlatformIdentifier

Die Plattform, über die das Ersuchen gesendet wurde.

string

Die Kennungen, die sich direkt auf die gemeldete Fahrt beziehen. Dabei handelt es sich in der Regel um IDs (z. B. Sitzungs-IDs) von Vorabbuchungen, die durchgeführt werden, bevor die Fahrt-ID verfügbar ist. Die Anzahl der related_ids ist auf 50 begrenzt.

SolutionType

Der Typ der GMP-Produktlösung (z. B. ON_DEMAND_RIDESHARING_AND_DELIVERIES), die für die gemeldete Fahrt verwendet wurde.

string

Der BCP-47-Sprachcode, z. B. en-US oder sr-Latn. Weitere Informationen finden Sie unter http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Ist keiner angegeben, kann die Antwort in einer beliebigen Sprache erfolgen. Falls ein solcher Name vorhanden ist, wird Englisch bevorzugt. Beispiel für Feldwert: en-US.

string

Erforderlich. CLDR-Regionscode der Region, aus der die Anfrage stammt. Beispiel für Feldwert: US.

string

Version des aufrufenden SDKs (falls zutreffend). Das Versionsformat ist „major.minor.patch“, z. B. 1.1.2.

string

Version des Betriebssystems, auf dem das aufrufende SDK ausgeführt wird. Beispiele für Feldwerte: 4.4.1, 12.1.

string

Modell des Geräts, auf dem das aufrufende SDK ausgeführt wird. Beispiele für Feldwerte: iPhone12,1, SM-G920F.

SdkType

Der SDK-Typ, der die Anfrage sendet.

string

Version des MapSDK, von dem das aufrufende SDK abhängig ist (falls zutreffend). Das Versionsformat ist „major.minor.patch“, z. B. 5.2.1.

string

Version des NavSDK, von der das aufrufende SDK abhängig ist (falls zutreffend). Das Versionsformat ist „major.minor.patch“, z. B. 2.1.0.

Platform

Plattform des aufrufenden SDKs.

string

Hersteller des Android-Geräts aus dem aufrufenden SDK; gilt nur für die Android SDKs. Beispiel für Feldwert: Samsung.

int32

Android API-Level des aufrufenden SDKs, gilt nur für die Android SDKs. Beispiel für Feldwert: 23.

string

Optionale ID, die zu Protokollierungszwecken angegeben werden kann, um die Anfrage zu identifizieren.

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.

string

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

string

Das Fahrzeug, das den Fahrten in der Anfrage zugeordnet ist. Wenn nicht angegeben, enthalten die zurückgegebenen Fahrten Folgendes nicht:

• current_route_segment
• remaining_waypoints
• remaining_distance_meters
• eta_to_first_waypoint

bool

Wenn dieser Wert auf „true“ gesetzt ist, enthält die Antwort Trips, die die Route eines Fahrers beeinflussen.

int32

Wenn die Richtlinie nicht konfiguriert ist, entscheidet der Server, wie viele Ergebnisse zurückgegeben werden sollen.

string

Legen Sie hier einen Wert fest, der zuvor in SearchTripsResponse zurückgegeben wurde, um gegenüber den vorherigen Ergebnissen fortzufahren.

Duration

Wenn angegeben, werden die Fahrten zurückgegeben, die nach dem Zeitpunkt (current - minimum_staleness) nicht aktualisiert wurden.

Trip

Die Liste der Fahrten für das angeforderte Fahrzeug.

string

Übergeben Sie dieses Token in SearchTripsRequest, um durch die Ergebnislisten zu blättern. Die API gibt bei jedem Aufruf eine Fahrtliste zurück. Wenn keine weiteren Ergebnisse verfügbar sind, ist die Fahrtliste leer.

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.

string

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

TerminalLocation

Erforderlich. Der Abholort, in dessen Nähe gesucht werden soll.

TerminalLocation

Der vom Kunden beabsichtigte Abgabeort. Das Feld ist erforderlich, wenn trip_types TripType.SHARED enthält.

int32

Erforderlich. Definiert den Suchradius des Fahrzeugs um den Abholpunkt. Es werden nur Fahrzeuge innerhalb des Suchradius zurückgegeben. Der Wert muss zwischen 400 und 10.000 Metern (einschließlich) liegen.

int32

Erforderlich. Gibt die maximale Anzahl der zurückzugebenden Fahrzeuge an. Der Wert muss zwischen 1 und 50 (einschließlich) liegen.

int32

Erforderlich. Gibt die Anzahl der Fahrgäste an, die für eine Fahrt in Betracht gezogen werden. Der Wert muss größer oder gleich eins sein. Der Treiber wird im Kapazitätswert nicht berücksichtigt.

TripType

Erforderlich. Der Typ der vorgeschlagenen Fahrt. Muss genau einen Typ enthalten. UNKNOWN_TRIP_TYPE ist nicht zulässig. Beschränkt die Suche auf die Fahrzeuge, die diesen Fahrttyp unterstützen können.

Duration

Beschränkt die Suche auf die Fahrzeuge, die innerhalb des angegebenen Zeitraums Standortupdates an Fleet Engine gesendet haben. Stehende Fahrzeuge, die noch ihren Standort übermitteln, gelten nicht als veraltet. Wenn dieses Feld nicht festgelegt ist, verwendet der Server fünf Minuten als Standardwert.

VehicleType

Erforderlich. Beschränkt die Suche auf Fahrzeuge mit einem der angegebenen Typen. Es muss mindestens ein Fahrzeugtyp angegeben werden. Fahrzeugtypen der Kategorie UNKNOWN sind nicht zulässig.

VehicleAttribute

Aufrufer können mithilfe einer beliebigen Kombination der Felder required_attributes, required_one_of_attributes und required_one_of_attribute_sets komplexe logische Operationen erstellen.

required_attributes ist eine Liste. required_one_of_attributes verwendet eine Nachricht, die eine Liste von Listen zulässt. In Kombination ermöglichen die beiden Felder die Zusammensetzung dieses Ausdrucks:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

Beschränkt die Suche 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.

VehicleAttributeList

Beschränkt die Suche auf die 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 inklusive Disjunktion/OR-Operation in jeder VehicleAttributeList und eine Konjunktion/AND-Operation für die Sammlung von VehicleAttributeList.

VehicleAttributeList

required_one_of_attribute_sets bietet zusätzliche Funktionen.

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

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

Beschränkt die Suche auf die Fahrzeuge mit allen Attributen in einem VehicleAttributeList. 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 innerhalb der Sammlung von VehicleAttributeList.

VehicleMatchOrder

Erforderlich. Gibt das gewünschte Sortierkriterium für Ergebnisse an.

bool

Gibt an, ob Fahrzeuge mit einer einzigen aktiven Fahrt für diese Suche infrage kommen. Dieses Feld wird nur verwendet, wenn current_trips_present nicht angegeben ist. Wenn current_trips_present nicht angegeben und dieses Feld auf false gesetzt ist, werden Fahrzeuge mit zugewiesenen Fahrten aus den Suchergebnissen ausgeschlossen. Wenn current_trips_present nicht angegeben ist und dieses Feld den Wert true hat, können die Suchergebnisse Fahrzeuge mit einer aktiven Fahrt mit dem Status ENROUTE_TO_DROPOFF enthalten. Wenn current_trips_present angegeben ist, kann dieses Feld nicht auf „true“ festgelegt werden.

Der Standardwert ist false.

string

Gibt die Fahrt an, die mit dieser SearchVehicleRequest verknüpft ist.

CurrentTripsPresent

Gibt an, ob Fahrzeuge mit aktiven Fahrten für diese Suche infrage kommen. Wenn trip_type SHARED enthält, muss hier ein anderer Wert als CURRENT_TRIPS_PRESENT_UNSPECIFIED festgelegt werden.

string

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

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

Dieser Filter fungiert als AND-Klausel mit anderen Einschränkungen wie minimum_capacity oder vehicle_types.

Beachten Sie, dass nur Anfragen für Fahrzeugattribute unterstützt werden, z. B. attributes.<key> = <value> oder attributes.<key1> = <value1> AND attributes.<key2> = <value2>. In einer Filterabfrage sind maximal 50 Einschränkungen zulässig.

Außerdem werden alle Attribute als Strings gespeichert, sodass nur Stringvergleiche für Attribute unterstützt werden. 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. attributes.<key> = "10" oder attributes.<key> = "true").

VehicleMatch

Liste der Fahrzeuge, die die SearchVehiclesRequest-Kriterien erfüllen, sortiert nach dem Feld SearchVehiclesRequest.order_by.

int32

Der Startindex dieses Intervalls im Pfad. Wenn der Index in JSON 0 ist, scheint das Feld leer zu sein.

int32

Der Endindex dieses Intervalls im Pfad. Wenn der Index in JSON 0 ist, scheint das Feld leer zu sein.

Speed

Verkehrsgeschwindigkeit in diesem Intervall.

LatLng

Erforderlich. Gibt den tatsächlichen Standort an.

Timestamp

Gibt an, wann die Haltestelle stattgefunden hat.

Timestamp

Nur Eingabe Verworfen. Verwenden Sie das Feld für den Zeitstempel.

LatLng

Erforderlich. Gibt den Standort eines Wegpunkts an.

TerminalPointId

Verworfen: Geben Sie stattdessen das Feld point an.

string

Verworfen: Geben Sie stattdessen das Feld point an.

string

Verworfen.

WaypointType

Eingestellt: Diese Daten sind für Vehicle.waypoint verfügbar.

string

Verworfen.

string

Verworfen.

string

Verworfen.

VisualTrafficReportPolylineRendering

Polylinien-Rendering, der die Geschwindigkeit des Traffics für alle Regionen entlang eines Abschnitts einer Fahrt durch einen Kunden angibt.

string

Nur Ausgabe. Im Format „providers/{provider}/trips/{trip}“

string

ID des Fahrzeugs, das diese Fahrt durchführt.

TripStatus

Aktueller Status der Fahrt.

TripType

Die Art der Fahrt.

TerminalLocation

Ort, an dem der Kunde angibt, dass er abgeholt wird.

StopLocation

Nur Eingabe. Der tatsächliche Ort, an dem und wo der Kunde abgeholt wurde. In diesem Feld kann der Anbieter Feedback zu den tatsächlichen Abholinformationen geben.

StopLocation

Nur Eingabe. Die tatsächliche Zeit und der Standort der Ankunft des Fahrers am Abholpunkt. In diesem Feld können Dienstleister Feedback zur tatsächlichen Ankunft am Abholpunkt geben.

Timestamp

Nur Ausgabe. Entweder die geschätzte zukünftige Abholzeit der Fahrgäste oder die tatsächliche Uhrzeit, zu der die Fahrgäste abgeholt werden.

TerminalLocation

Zwischenstopps, damit die Fahrt angefordert wird (zusätzlich zu Start- und Zielhaltestellen). Für geteilte Fahrten wird dies anfangs nicht unterstützt.

Timestamp

Gibt an, wann das intermediate_destinations zuletzt geändert wurde. Dein Server sollte diesen Wert im Cache speichern und beim Aktualisieren von intermediate_destination_index in UpdateTripRequest übergeben, um sicherzustellen, dass intermediate_destinations nicht geändert wird.

int32

Wenn TripStatus den Wert ENROUTE_TO_INTERMEDIATE_DESTINATION hat, ist eine Zahl zwischen [0–N–1] angegeben, die angibt, welches Zwischenziel das Fahrzeug als Nächstes überquert. Wenn TripStatus ARRIVED_AT_INTERMEDIATE_DESTINATION ist, eine Zahl zwischen [0–N–1], die angibt, an welchem Zwischenziel sich das Fahrzeug befindet. Der Anbieter legt diesen Wert fest. Wenn keine intermediate_destinations vorhanden sind, wird dieses Feld ignoriert.

StopLocation

Nur Eingabe. Tatsächliche Uhrzeit und Ort der Ankunft des Fahrers an einem Zwischenziel. In diesem Feld können Anbieter Feedback zu tatsächlichen Ankunftsinformationen an Zwischenzielen geben.

StopLocation

Nur Eingabe. Die tatsächliche Zeit und der tatsächliche Ort, an dem und wo der Kunde von einem Zwischenziel abgeholt wurde. In diesem Feld kann der Anbieter Feedback zu tatsächlichen Abholinformationen an Zwischenzielen geben.

TerminalLocation

Ort, an dem der Kunde angibt, dass er aussteigt.

StopLocation

Nur Eingabe. Die tatsächliche Zeit und der tatsächliche Ort, an dem und wo der Kunde ausstieg. In diesem Feld können Dienstleister Feedback zu tatsächlichen Abbruchinformationen geben.

Timestamp

Nur Ausgabe. Entweder die geschätzte zukünftige Zeit, zu der die Fahrgäste am endgültigen Ziel aussteigen, oder die tatsächliche Zeit, zu der die Fahrgäste aussteigen werden.

TripWaypoint

Nur Ausgabe. Der vollständige Pfad vom aktuellen Standort bis zum Abgabepunkt (einschließlich). Dieser Pfad könnte Wegpunkte von anderen Fahrten enthalten.

TripWaypoint

Dieses Feld unterstützt die manuelle Sortierung der Wegpunkte für die Fahrt. Sie enthält alle verbleibenden Wegpunkte für das zugewiesene Fahrzeug sowie die Start- und Zielorte für diese Fahrt. Wenn die Fahrt keinem Fahrzeug zugewiesen wurde, ignoriert Fleet Engine dieses Feld. Aus Datenschutzgründen wird dieses Feld nur bei UpdateTrip- und CreateTrip-Aufrufen vom Server ausgefüllt, NICHT bei GetTrip-Aufrufen.

LatLng

Nur Ausgabe. Voraussichtliche Route für diese Fahrt zum ersten Eintrag in noch verbleibende_Wegepunkte. Beachten Sie, dass der erste Wegpunkt möglicherweise zu einer anderen Fahrt gehört.

string

Nur Ausgabe. Ein codierter Pfad zum nächsten Wegpunkt.

Hinweis: Dieses Feld ist nur für die Verwendung vom Driver SDK und Consumer SDK vorgesehen. Die Decodierung wird noch nicht unterstützt.

Timestamp

Nur Ausgabe. Gibt an, wann die Route zuletzt geändert wurde.

Hinweis: Dieses Feld ist nur für die Verwendung vom Driver SDK und Consumer SDK vorgesehen.

ConsumableTrafficPolyline

Nur Ausgabe. Gibt die Verkehrslage entlang der current_route_segment an, sofern verfügbar.

Hinweis: Dieses Feld ist nur für die Verwendung vom Driver SDK und Consumer SDK vorgesehen.

Timestamp

Nur Ausgabe. Gibt an, wann das current_route_segment_traffic zuletzt geändert wurde.

Hinweis: Dieses Feld ist nur für die Verwendung vom Driver SDK und Consumer SDK vorgesehen.

TripWaypoint

Nur Ausgabe. Wegpunkt, an dem current_route_segment endet.

Int32Value

Nur Ausgabe. Die verbleibende Fahrstrecke im Feld current_route_segment. Der Wert ist nicht angegeben, wenn die Fahrt keinem Fahrzeug zugewiesen ist oder die Fahrt beendet oder gestrichen wurde.

Timestamp

Nur Ausgabe. Die voraussichtliche Ankunftszeit zum nächsten Wegpunkt (erster Eintrag im Feld remaining_waypoints). Der Wert ist nicht angegeben, wenn die Fahrt keinem Fahrzeug zugewiesen ist oder die Fahrt inaktiv ist (abgeschlossen oder gestrichen).

Duration

Nur Ausgabe. Die Dauer ab Rückgabe der Fahrtdaten bis zum Zeitpunkt in Trip.eta_to_first_waypoint. Der Wert ist nicht angegeben, wenn die Fahrt keinem Fahrzeug zugewiesen ist oder die Fahrt inaktiv ist (abgeschlossen oder gestrichen).

Timestamp

Nur Ausgabe. Gibt an, wann remaining_waypoints zuletzt geändert wurde (ein Wegpunkt wurde hinzugefügt, entfernt oder geändert).

Timestamp

Nur Ausgabe. Gibt an, wann remaining_waypoints.path_to_waypoint und remaining_waypoints.traffic_to_waypoint zuletzt geändert wurden. Ihre Clientanwendung sollte diesen Wert im Cache speichern und in GetTripRequest übergeben, um sicherzustellen, dass die Pfade und der Traffic für remaining_waypoints nur bei einer Aktualisierung zurückgegeben werden.

int32

Nicht veränderbar. Gibt die Anzahl der Fahrgäste an, ohne den Fahrer. Ein Fahrzeug muss genügend Kapazität haben, damit es in einer SearchVehicles-Antwort zurückgegeben werden kann.

VehicleLocation

Nur Ausgabe. Zeigt den letzten gemeldeten Standort des Fahrzeugs auf der Route an.

bool

Nur Ausgabe. Gibt an, ob die last_location des Fahrzeugs an „current_route_segment“ ausgerichtet werden kann. Falsch, wenn last_location oder current_route_segment nicht vorhanden ist. Er wird von Fleet Engine berechnet. Aktualisierungen von Clients werden ignoriert.

TripView

Die Teilmenge der Trip-Felder, die ausgefüllt werden, und deren Interpretation.

TerminalLocation

Die Position dieses Wegpunkts.

string

Die diesem Wegpunkt zugeordnete Fahrt.

WaypointType

Die Rolle, die dieser Wegpunkt bei dieser Fahrt spielt, z. B. An- oder Absetz.

LatLng

Der Pfad vom vorherigen Wegpunkt zum aktuellen Wegpunkt Nicht definiert für den ersten Wegpunkt in einer Liste. Dieses Feld wird nur auf Anforderung ausgefüllt.

string

Der codierte Pfad vom vorherigen Wegpunkt zum aktuellen Wegpunkt.

Hinweis: Dieses Feld ist nur für die Verwendung vom Driver SDK und Consumer SDK vorgesehen. Die Decodierung wird noch nicht unterstützt.

ConsumableTrafficPolyline

Die Verkehrslage auf dem Weg zu diesem Wegpunkt Traffic ist nur für Kunden der Google Maps Platform Rides and Deliveries-Lösung verfügbar.

Int32Value

Die Pfadentfernung vom vorherigen Wegpunkt zum aktuellen Wegpunkt. Nicht definiert für den ersten Wegpunkt in einer Liste.

Timestamp

Die geschätzte Ankunftszeit an diesem Wegpunkt. Nicht definiert für den ersten Wegpunkt in einer Liste.

Duration

Die Reisezeit vom vorherigen Wegpunkt bis zu diesem Punkt. Nicht definiert für den ersten Wegpunkt in einer Liste.

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.

string

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

Trip

Erforderlich. Die Fahrt, die mit der Aktualisierung verknüpft ist.

Die folgenden Felder werden von der Fleet Engine verwaltet. Aktualisieren Sie sie nicht mit „Trip.update“.

• current_route_segment
• current_route_segment_end_point
• current_route_segment_traffic
• current_route_segment_traffic_version
• current_route_segment_version
• dropoff_time
• eta_to_next_waypoint
• intermediate_destinations_version
• last_location
• name
• number_of_passengers
• pickup_time
• remaining_distance_meters
• remaining_time_to_first_waypoint
• remaining_waypoints
• remaining_waypoints_version
• route

Wenn Sie die Trip.vehicle_id für eine gemeinsame Fahrt aktualisieren, müssen Sie die Liste der Trip.vehicle_waypoints angeben, um die Reihenfolge der verbleibenden Wegpunkte festzulegen. Andernfalls bleibt die Reihenfolge unbestimmt.

Wenn Sie Trip.vehicle_waypoints angeben, muss die Liste alle verbleibenden Wegpunkte der Fahrten des Fahrzeugs ohne zusätzliche Wegpunkte enthalten. Sie müssen diese Wegpunkte so anordnen, dass der Abholpunkt bei einer bestimmten Fahrt vor Zwischenzielen und alle Zwischenziele vor den Ausstiegspunkten liegen. Die Wegpunkte einer EXCLUSIVE-Fahrt dürfen sich nicht mit anderen Fahrten verschränken. Die Felder trip_id, waypoint_type und location werden verwendet. Alle anderen TripWaypoint-Felder in vehicle_waypoints werden ignoriert.

Um eine Rennbedingung für Fahrten mit mehreren Zielen zu vermeiden, sollten Sie Trip.intermediate_destinations_version angeben, wenn Sie den Fahrtstatus auf ENROUTE_TO_INTERMEDIATE_DESTINATION aktualisieren. Die übergebene Trip.intermediate_destinations_version muss mit der Fleet Engine-Version übereinstimmen. Andernfalls schlägt die Anfrage fehl.

FieldMask

Erforderlich. Die Feldmaske, die angibt, welche Felder in Trip aktualisiert werden sollen. update_mask muss mindestens ein Feld enthalten.

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.

string

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

VehicleAttribute

Erforderlich. Die zu aktualisierenden Fahrzeugattribute. Nicht genannte Attribute werden weder geändert noch entfernt.

VehicleAttribute

Erforderlich. Die aktualisierte Liste der Fahrzeugattribute, einschließlich neuer, geänderter und nicht bearbeiteter Attribute.

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.

string

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

Vehicle

Erforderlich. Die anzuwendenden Vehicle-Entitätswerte. Beim Aktualisieren eines Vehicle werden die folgenden Felder möglicherweise nicht aktualisiert, da sie vom Server verwaltet werden.

• available_capacity
• current_route_segment_version
• current_trips
• name
• waypoints_version

Wenn das Feld attributes aktualisiert wird, werden alle Attribute des Fahrzeugs durch die in der Anfrage angegebenen Attribute ersetzt. Wenn Sie nur einige Attribute aktualisieren möchten, verwenden Sie die Methode UpdateVehicleAttributes.

Ebenso kann das Feld waypoints aktualisiert werden, muss aber alle derzeit auf dem Fahrzeug vorhandenen Wegpunkte und keine anderen Wegpunkte enthalten.

FieldMask

Erforderlich. Eine Feldmaske, die angibt, welche Felder der Vehicle aktualisiert werden sollen. Es muss mindestens ein Feldname angegeben werden.

string

Nur Ausgabe. Der eindeutige Name für dieses Fahrzeug. Das Format dafür ist providers/{provider}/vehicles/{vehicle}.

VehicleState

Der Fahrzeugstatus.

TripType

Von diesem Fahrzeug unterstützte Fahrttypen.

string

Nur Ausgabe. Liste von trip_id für Fahrten, die diesem Fahrzeug aktuell zugewiesen sind.

VehicleLocation

Letzter gemeldeter Standort des Fahrzeugs.

int32

Die Gesamtzahl der Fahrgäste, die dieses Fahrzeug befördern kann. Der Treiber wird in diesem Wert nicht berücksichtigt. Dieser Wert muss größer oder gleich eins sein.

VehicleAttribute

Liste der Fahrzeugattribute. Ein Fahrzeug kann maximal 100 Attribute haben und jedes Attribut muss einen eindeutigen Schlüssel haben.

VehicleType

Erforderlich. Der Typ dieses Fahrzeugs. Kann zum Filtern von Fahrzeugen in SearchVehicles-Ergebnissen verwendet werden. Beeinflusst außerdem die voraussichtliche Ankunftszeit und die Routenberechnung.

LicensePlate

Kfz-Kennzeichen des Fahrzeugs.

TerminalLocation

Eingestellt: Verwende stattdessen Vehicle.waypoints.

string

Die Polylinie, die die Route angibt, die die Fahrer-App zum nächsten Wegpunkt nehmen möchte. Diese Liste wird auch in Trip.current_route_segment für alle aktiven Fahrten zurückgegeben, die dem Fahrzeug zugewiesen sind.

Hinweis: Dieses Feld ist nur für die Verwendung vom Treiber-SDK vorgesehen. Die Decodierung wird noch nicht unterstützt.

TrafficPolylineData

Nur Eingabe. Fleet Engine verwendet diese Informationen, um die Weitergabe von Fahrten zu verbessern. Hinweis: Dieses Feld ist nur für die Verwendung vom Treiber-SDK vorgesehen.

Timestamp

Nur Ausgabe. Uhrzeit, zu der current_route_segment festgelegt wurde. Sie kann vom Client gespeichert und in zukünftigen GetVehicle-Anfragen übergeben werden, um zu verhindern, dass Routen zurückgegeben werden, die sich nicht geändert haben.

TripWaypoint

Wegpunkt, an dem current_route_segment endet. Sie kann von Fahrern bei UpdateVehicle-Aufrufen entweder als vollständiger Wegpunkt, als Wegpunkt LatLng oder als letztes LatLng der current_route_segment angegeben werden. Fleet Engine versucht dann, mit einem tatsächlichen Wegpunkt zu interpolieren, wenn dieser nicht vollständig angegeben ist. Dieses Feld wird in UpdateVehicle-Aufrufen ignoriert, sofern nicht auch current_route_segment angegeben ist.

Int32Value

Die verbleibende Fahrstrecke für die current_route_segment. Dieser Wert wird auch in Trip.remaining_distance_meters für alle aktiven Fahrten zurückgegeben, die dem Fahrzeug zugewiesen sind. Der Wert wird nicht angegeben, wenn das Feld current_route_segment leer ist.

Timestamp

Die voraussichtliche Ankunftszeit für den ersten Eintrag im Feld waypoints. Der Wert wird nicht angegeben, wenn das Feld waypoints oder das Feld Vehicle.current_route_segment leer ist.

Beim Aktualisieren eines Fahrzeugs hat remaining_time_seconds in derselben Anfrage Vorrang vor eta_to_first_waypoint.

Int32Value

Nur Eingabe. Die verbleibende Fahrzeit für current_route_segment. Der Wert wird nicht angegeben, wenn das Feld waypoints oder das Feld Vehicle.current_route_segment leer ist. Dieser Wert sollte eta_to_first_waypoint–current_time entsprechen, wenn alle Parteien dieselbe Uhr verwenden.

Beim Aktualisieren eines Fahrzeugs hat remaining_time_seconds in derselben Anfrage Vorrang vor eta_to_first_waypoint.

TripWaypoint

Die verbleibenden Wegpunkte, die diesem Fahrzeug zugewiesen sind.

Timestamp

Nur Ausgabe. Letzte Aktualisierung des Felds waypoints. Clients sollten diesen Wert im Cache speichern und in GetVehicleRequest übergeben, damit das Feld waypoints nur zurückgegeben wird, wenn es aktualisiert wird.

bool

Gibt an, ob der Fahrer aufeinanderfolgende Fahrten akzeptiert. Wenn true, enthält SearchVehicles das Fahrzeug möglicherweise auch dann, wenn es derzeit einer Fahrt zugewiesen ist. Der Standardwert ist false.

NavigationStatus

Der Navigationsstatus des Fahrzeugs.

DeviceSettings

Nur Eingabe. Informationen zu den Einstellungen des Mobilgeräts, das der Fahrer verwendet.

Category

Fahrzeugtypkategorie

string

Der Schlüssel des Attributs. Schlüssel dürfen keinen Doppelpunkt (:) enthalten.

string

Der Wert des Attributs.

string

Als String eingegebener Attributwert.

Hinweis: Dies ist identisch mit dem Feld value, das irgendwann eingestellt wird. Für die Erstellungs- oder Aktualisierungsmethode können beide Felder verwendet werden, die Verwendung von string_value wird jedoch dringend empfohlen. Wenn sowohl string_value als auch value festgelegt sind, müssen sie identisch sein. Andernfalls wird ein Fehler ausgegeben. Beide Felder werden in den Antworten ausgefüllt.

bool

Boolescher Attributwert

double

Doppelter Attributwert.

VehicleAttribute

Eine Liste der Attribute in dieser Sammlung.

LatLng

Der Standort des Fahrzeugs. Bei der Übermittlung an Fleet Engine ist der Standort des Fahrzeugs ein GPS-Standort. Wenn Sie ihn als Antwort erhalten, kann der Standort des Fahrzeugs entweder ein GPS-Standort, ein zusätzlicher Standort oder ein anderer ungefährer Standort sein. Die Quelle wird in location_sensor angegeben.

DoubleValue

Eingestellt: Verwende stattdessen latlng_accuracy.

DoubleValue

Genauigkeit von location in Metern als Radius.

Int32Value

Richtung, in der das Fahrzeug in Grad bewegt wird. 0 steht für Norden. Der gültige Bereich ist [0,360).

DoubleValue

Eingestellt: Verwende stattdessen heading_accuracy.

DoubleValue

Genauigkeit von heading in Grad.

DoubleValue

Höhe in Metern über WGS84.

DoubleValue

Eingestellt: Verwende stattdessen altitude_accuracy.

DoubleValue

Genauigkeit von altitude in Metern.

Int32Value

Geschwindigkeit des Fahrzeugs in Kilometern pro Stunde. Eingestellt: Verwende stattdessen speed.

DoubleValue

Geschwindigkeit des Fahrzeugs in Metern/Sekunde

DoubleValue

Genauigkeit von speed in Metern/Sekunde.

Timestamp

Die Zeit, zu der location vom Sensor gemäß der Uhr des Sensors gemeldet wurde.

Timestamp

Nur Ausgabe. Die Uhrzeit, zu der der Server die Standortinformationen empfangen hat.

LocationSensor

Anbieter von Standortdaten, z. B. GPS.

BoolValue

Gibt an, ob location an eine Straße ausgerichtet ist.

BoolValue

Nur Eingabe. Gibt an, ob der GPS-Sensor auf dem Mobilgerät aktiviert ist.

Int32Value

Nur Eingabe. Zeit in Sekunden, seit dieser Standort zum ersten Mal an den Server gesendet wurde. Bei der ersten Aktualisierung ist dieser Wert null. Ist die Zeit unbekannt, z. B. beim Neustart der App, wird dieser Wert auf null zurückgesetzt.

Int32Value

Nur Eingabe. Eingestellt: Andere Signale werden jetzt verwendet, um festzustellen, ob ein Standort veraltet ist.

LatLng

Standort des unbearbeiteten Fahrzeugs (nicht von Road-Snapper verarbeitet).

Timestamp

Zeitstempel, der dem unformatierten Standort zugeordnet ist.

LocationSensor

Quelle des unformatierten Standorts. Die Standardeinstellung ist GPS.

DoubleValue

Radiusgenauigkeit von raw_location in Metern.

LatLng

Zusätzlicher Standort, der von der integrierenden App bereitgestellt wird.

Timestamp

Zeitstempel, der dem zusätzlichen Standort zugeordnet ist.

LocationSensor

Quelle des zusätzlichen Standorts. Die Standardeinstellung ist CUSTOMER_SUPPLIED_LOCATION.

DoubleValue

Radiusgenauigkeit von supplemental_location in Metern.

bool

Eingestellt: Verwende stattdessen is_road_snapped.

Vehicle

Erforderlich. Ein Fahrzeug, das der Anfrage entspricht.

Timestamp

Das Fahrzeug fährt die voraussichtliche Ankunftszeit zum Abholort, der in der Anfrage angegeben ist. Ein leerer Wert bedeutet, dass bei der Berechnung der voraussichtlichen Ankunftszeit für das Fahrzeug ein Fehler aufgetreten ist. Wenn SearchVehiclesRequest.include_back_to_back true war und dieses Fahrzeug eine aktive Fahrt hat, enthält vehicle_pickup_eta die Zeit, die für die aktuell aktive Fahrt erforderlich ist.

Int32Value

Die Entfernung vom aktuellen Standort des Fahrzeugs bis zum in der Anfrage angegebenen Abholort, einschließlich aller Zwischen- oder Absetzpunkte für bestehende Fahrten. Sie setzt sich aus der berechneten Fahrtstrecke (Routenstrecke) plus der Luftlinienentfernung zwischen dem Navigationsendpunkt und dem angeforderten Startpunkt zusammen. (Der Abstand zwischen dem Navigationsendpunkt und dem angeforderten Abholpunkt ist in der Regel gering.) Ein leerer Wert weist auf einen Fehler bei der Berechnung der Entfernung hin.

Int32Value

Erforderlich. Die Luftlinie zwischen dem Fahrzeug und dem in der Anfrage angegebenen Abholpunkt.

Timestamp

Die voraussichtliche Ankunftszeit des vollständigen Fahrzeugs bis zur in der Anfrage angegebenen Abgabestelle. Die ETA umfasst auch das Anhalten an Wegpunkten vor der in der Anfrage angegebenen dropoff_point. Der Wert wird nur ausgefüllt, wenn in der Anfrage ein Rückgabepunkt angegeben ist. Ein leerer Wert weist auf einen Fehler bei der Berechnung der voraussichtlichen Ankunftszeit hin.

Int32Value

Die Entfernung des Fahrzeugs (in Metern) vom Abholpunkt bis zur Abgabestelle, die in der Anfrage angegeben ist. Die Entfernung bezieht sich nur zwischen den beiden Punkten und umfasst nicht den Fahrzeugstandort oder andere Punkte, die besucht werden müssen, bevor das Fahrzeug den Abhol- oder Abgabeort erreicht. Der Wert wird nur ausgefüllt, wenn in der Anfrage eine dropoff_point angegeben ist. Ein leerer Wert weist auf einen Fehler bei der Berechnung der Entfernung vom Abhol- bis zum Ausstiegspunkt hin, der in der Anfrage angegeben ist.

TripType

Erforderlich. Die Art der Fahrt, die zur Berechnung der voraussichtlichen Ankunftszeit für den Abholpunkt verwendet wurde.

Waypoint

Die sortierte Liste von Wegpunkten, die zur Berechnung der voraussichtlichen Ankunftszeit verwendet werden. Die Liste enthält den Fahrzeugstandort, die Abholpunkte aktiver Fahrten für das Fahrzeug und die in der Anfrage angegebenen Abholpunkte. Eine leere Liste bedeutet, dass bei der Berechnung der voraussichtlichen Ankunftszeit für das Fahrzeug ein Fehler aufgetreten ist.

VehicleMatchType

Der passende Fahrzeugtyp.

VehicleMatchOrder

Die Reihenfolge, in der Fahrzeugübereinstimmungen sortiert werden sollen.

VehicleMatchOrder

Die tatsächliche Bestellung, die für dieses Fahrzeug verwendet wurde. Normalerweise entspricht dies dem Wert aus der Anfrage. Unter bestimmten Umständen, z. B. bei einem internen Serverfehler, kann jedoch eine andere Methode verwendet werden (z. B. PICKUP_POINT_STRAIGHT_DISTANCE).

RoadStretch

Optional. Straßenabschnitte, die entlang der Polylinie gerendert werden sollen. Streckenabschnitte überschneiden sich garantiert nicht und decken nicht unbedingt die gesamte Route ab.

Falls keine Straßenabschnitte vorhanden sind, die angepasst werden sollen, sollte der Client die Standardeinstellung für die Route anwenden.

Style

Erforderlich. Der Stil, der angewendet werden soll.

int32

Erforderlich. Der Stil sollte zwischen [offset_meters, offset_meters + length_meters) angewendet werden.

int32

Erforderlich. Die Länge des Pfads, auf die der Stil angewendet werden soll.

LatLng

Die Position dieses Wegpunkts.

Timestamp

Die geschätzte Ankunftszeit des Fahrzeugs an diesem Wegpunkt.