Package maps.fleetengine.v1

BatteryStatus

Akkustatus, z. B. ob er voll oder in der Ladung ist

PowerSource

Status der Akkustromquelle.

float

Aktueller Akkustand in Prozent [0–100]

SpeedReadingInterval

Die Verkehrsgeschwindigkeit auf dem Weg vom vorherigen zum aktuellen Wegpunkt.

string

Der Weg, den der Fahrer vom vorherigen zum aktuellen Wegpunkt zurücklegt. Dieser Weg enthält Markierungen, damit Clients entlang des Pfades Verkehrshinweise anzeigen können (siehe speed_reading_interval). Das Dekodieren wird noch nicht unterstützt.

RequestHeader

Der Standard-Fleet Engine-Anfrageheader.

string

Erforderlich. Muss im Format providers/{provider} vorliegen. Der Anbieter muss die Projekt-ID (z. B. sample-cloud-project) des Google Cloud-Projekts sein, in dem das Dienstkonto, das diesen Aufruf ausführt, Mitglied ist.

string

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

• Muss ein gültiger Unicode-String sein.
• Ist auf eine maximale Länge von 64 Zeichen beschränkt.
• Normalisiert gemäß Unicode-Normalisierungsform C.
• Darf keines der folgenden ASCII-Zeichen enthalten: „/“, „:“, „?“, „,“ oder „#“.

Trip

Erforderlich. Zu erstellende Reiseentität.

Beim Erstellen einer Fahrt sind die folgenden 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. Beispiel: Alle Fahrten beginnen mit einer trip_status von NEW, auch wenn Sie in der Erstellungsanfrage eine trip_status von CANCELED übergeben.

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

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

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

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

RequestHeader

Der Standard-Fleet Engine-Anfrageheader.

string

Erforderlich. Muss im Format providers/{provider} vorliegen. Der Anbieter muss die Projekt-ID (z. B. sample-cloud-project) des Google Cloud-Projekts sein, in dem das Dienstkonto, das diesen Aufruf ausführt, Mitglied ist.

string

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

• Muss ein gültiger Unicode-String sein.
• Ist auf eine maximale Länge von 64 Zeichen beschränkt.
• Normalisiert gemäß Unicode-Normalisierungsform C.
• 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, wenn sie angegeben sind.

LocationPowerSaveMode

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 sich das Gerät in einem interaktiven Zustand befindet.

BatteryInfo

Informationen zum Akkustatus.

RequestHeader

Der Standard-Fleet Engine-Anfrageheader.

string

Erforderlich. Muss im Format providers/{provider}/trips/{trip} vorliegen. Der Anbieter muss die Projekt-ID (z. B. sample-cloud-project) des Google Cloud-Projekts sein, in dem das Dienstkonto, das diesen Aufruf ausführt, Mitglied ist.

TripView

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

Timestamp

Gibt den Mindestzeitstempel (exklusiv) an, für den Trip.route- oder Trip.current_route_segment-Daten abgerufen werden. Wenn sich die Routendaten seit diesem Zeitstempel nicht geändert haben, wird das Feld „route“ in der Antwort nicht festgelegt. Wenn kein Minimum angegeben ist, werden die Routendaten immer abgerufen.

Timestamp

Gibt den Mindestzeitstempel (exklusiv) an, für den Trip.remaining_waypoints abgerufen werden. Wenn sie seit diesem Zeitstempel unverändert sind, werden die remaining_waypoints in der Antwort nicht 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). Standardmäßig ist LAT_LNG_LIST_TYPE festgelegt.

Timestamp

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

Timestamp

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

RequestHeader

Der Standard-Fleet Engine-Anfrageheader.

string

Erforderlich. Muss im Format providers/{provider}/vehicles/{vehicle} vorliegen. Der Anbieter muss die Projekt-ID (z. B. sample-cloud-project) des Google Cloud-Projekts sein, in dem das Dienstkonto, das diesen Aufruf ausführt, Mitglied ist.

Timestamp

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

Timestamp

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

string

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

string

Die letzte Ziffer des Kfz-Kennzeichens oder „-1“, wenn das Kfz-Kennzeichen keinen numerischen Wert enthält.

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

RequestHeader

Der Standard-Fleet Engine-Anfrageheader.

string

Erforderlich. Muss im Format providers/{provider} vorliegen. Der Anbieter muss die Projekt-ID (z. B. sample-cloud-project) des Google Cloud-Projekts sein, in dem das Dienstkonto, das diesen Aufruf ausführt, Mitglied ist.

int32

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

string

Der Wert von next_page_token, der von einem vorherigen Aufruf von ListVehicles bereitgestellt wurde, damit Sie Seiten mit Fahrzeuggruppen aufrufen 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. Bei allen zurückgegebenen Fahrzeugen ist maximum_capacity größer oder gleich diesem Wert. Muss, falls festgelegt, größer oder gleich 0 sein.

TripType

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

Duration

Die Antwort wird auf Fahrzeuge beschränkt, die innerhalb des angegebenen Zeitraums Standortaktualisierungen an die Fleet Engine gesendet haben. Die Standorte von stehenden Fahrzeugen, die ihre Standorte weiterhin senden, gelten nicht als veraltet. Falls vorhanden, muss es sich um eine gültige positive Dauer handeln.

Category

Erforderlich. Die Antwort wird auf Fahrzeuge mit einer der angegebenen Fahrzeugkategorien beschränkt. UNKNOWN ist nicht zulässig.

string

Caller können komplexe logische Vorgänge mit einer beliebigen Kombination der Felder required_attributes, required_one_of_attributes und required_one_of_attribute_sets bilden.

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
...)

Die Antwort wird auf Fahrzeuge mit den angegebenen Attributen beschränkt. Dieses Feld ist ein Konjunktions-/AND-Vorgang. Es sind maximal 50 erforderliche Attribute zulässig. Dies entspricht der maximal zulässigen Anzahl von Attributen für ein Fahrzeug. Jeder wiederholte String sollte das Format „Schlüssel:Wert“ haben.

string

Die Antwort wird auf Fahrzeuge mit mindestens einem der angegebenen Attribute in jedem VehicleAttributeList beschränkt. Innerhalb 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 gesamte Sammlung von VehicleAttributeList. Jeder wiederholte String muss das Format „Schlüssel1:Wert1|Schlüssel2:Wert2|Schlüssel3:Wert3“ haben.

string

required_one_of_attribute_sets bietet zusätzliche Funktionen.

Ähnlich wie bei required_one_of_attributes wird bei required_one_of_attribute_sets eine Nachricht verwendet, die eine Liste von Listen zulässt. So sind Ausdrücke wie dieser möglich:

(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
  ...)
)

Die Antwort wird auf Fahrzeuge beschränkt, die mit allen Attributen in einem VehicleAttributeList übereinstimmen. Innerhalb jeder Liste muss ein Fahrzeug mit allen Attributen übereinstimmen. Dieses Feld ist eine Konjunktion/AND-Operation in jedem VehicleAttributeList und eine inklusive Disjunktion/OR-Operation für die gesamte Sammlung von VehicleAttributeList. Jeder wiederholte String muss das Format „Schlüssel1:Wert1|Schlüssel2:Wert2|Schlüssel3:Wert3“ haben.

VehicleState

Die Antwort wird auf Fahrzeuge mit diesem Fahrzeugstatus beschränkt.

bool

Geben Sie nur die 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 soll die Felder required_attributes, required_one_of_attributes und required_one_of_attributes_sets ersetzen. 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 funktioniert als AND-Klausel mit anderen Einschränkungen wie vehicle_state oder on_trip_only.

Es werden nur Abfragen zu Fahrzeugattributen unterstützt (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. Daher sind nur Stringvergleiche zulässig. Damit ein Vergleich mit numerischen oder booleschen Werten möglich ist, 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 im rechteckigen Bereich befindet, der durch den Darstellungsbereich definiert ist.

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. Leer, wenn keine weiteren Fahrzeuge die Anfragekriterien erfüllen.

int64

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

string

Erforderlich. Muss im Format providers/{provider}/billableTrips/{billable_trip} vorliegen. Der Anbieter muss die Projekt-ID (z. B. sample-cloud-project) des Google Cloud-Projekts sein, in dem das Dienstkonto, das diesen Aufruf ausführt, Mitglied ist.

string

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

BillingPlatformIdentifier

Die Plattform, auf der die Anfrage gestellt wurde.

string

Die IDs, die sich direkt auf die gemeldete Fahrt beziehen. Das sind in der Regel IDs (z. B. Sitzungs-IDs) von Vorabbuchungsvorgängen, die ausgeführt wurden, bevor die Reise-ID verfügbar war. Die Anzahl der related_ids ist auf 50 beschränkt.

SolutionType

Die Art 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. Wenn keine Sprache angegeben ist, kann die Antwort in jeder Sprache erfolgen. Wenn ein Name vorhanden ist, wird Englisch bevorzugt. Beispiel für einen Feldwert: en-US.

string

Erforderlich. CLDR-Regionscode der Region, aus der die Anfrage stammt. Beispiel für einen 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 anrufende 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 Typ des SDKs, über das die Anfrage gesendet wird.

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 dem das aufrufende SDK abhängt (falls zutreffend). Das Versionsformat ist „major.minor.patch“, z. B. 2.1.0.

Platform

Plattform des aufrufenden SDKs.

string

Hersteller des Android-Geräts, von dem das SDK aufgerufen wird. Gilt nur für Android-SDKs. Beispiel für einen Feldwert: Samsung.

int32

Android-API-Level des aufrufenden SDKs, nur für Android-SDKs gültig. Beispiel für einen Feldwert: 23.

string

Optionale ID, die zu Logging-Zwecken zur Identifizierung der Anfrage angegeben werden kann.

RequestHeader

Der Standard-Fleet Engine-Anfrageheader.

string

Erforderlich. Muss im Format providers/{provider} vorliegen. Der Anbieter muss die Projekt-ID (z. B. sample-cloud-project) des Google Cloud-Projekts sein, in dem das Dienstkonto, das diesen Aufruf ausführt, Mitglied ist.

string

Das Fahrzeug, das mit den Fahrten in der Anfrage verknüpft ist. Wenn keine Angabe gemacht wird, enthalten die zurückgegebenen Fahrten Folgendes nicht:

• current_route_segment
• remaining_waypoints
• remaining_distance_meters
• eta_to_first_waypoint

bool

Wenn auf „wahr“ gesetzt, enthält die Antwort Fahrten, die die Route eines Fahrers beeinflussen.

int32

Wenn nicht festgelegt, entscheidet der Server, wie viele Ergebnisse zurückgegeben werden.

string

Legen Sie diesen Wert auf einen Wert fest, der zuvor in SearchTripsResponse zurückgegeben wurde, um mit 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 der SearchTripsRequest, um durch die Ergebnisliste zu blättern. Die API gibt bei jedem Aufruf eine Fahrtenliste zurück. Wenn keine Ergebnisse mehr vorhanden sind, ist die Fahrtenliste leer.

RequestHeader

Der Standard-Fleet Engine-Anfrageheader.

string

Erforderlich. Muss im Format providers/{provider} vorliegen. Der Anbieter muss die Projekt-ID (z. B. sample-cloud-project) des Google Cloud-Projekts sein, in dem das Dienstkonto, das diesen Aufruf ausführt, Mitglied ist.

TerminalLocation

Erforderlich. Die Abholstelle, in deren Nähe gesucht werden soll.

TerminalLocation

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

int32

Erforderlich. Hier wird der Umkreis für die Fahrzeugsuche um den Abholpunkt definiert. Es werden nur Fahrzeuge innerhalb des Suchradius zurückgegeben. Der Wert muss zwischen 400 und 10.000 Metern liegen.

int32

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

int32

Erforderlich. Gibt die Anzahl der Passagiere an, die für eine Fahrt berücksichtigt werden. Der Wert muss größer oder gleich 1 sein. Der Fahrer wird nicht in den Kapazitätswert einbezogen.

TripType

Erforderlich. Stellt die Art der vorgeschlagenen Fahrt dar. Muss genau einen Typ enthalten. UNKNOWN_TRIP_TYPE ist nicht zulässig. Die Suche wird auf Fahrzeuge beschränkt, die diesen Fahrttyp unterstützen.

Duration

Schränkt die Suche auf Fahrzeuge ein, die innerhalb des angegebenen Zeitraums Standortaktualisierungen an Fleet Engine gesendet haben. Die Standorte von stehenden Fahrzeugen, die ihre Standorte weiterhin senden, gelten nicht als veraltet. Wenn dieses Feld nicht festgelegt ist, verwendet der Server fünf Minuten als Standardwert.

VehicleType

Erforderlich. Die Suche wird auf Fahrzeuge mit einem der angegebenen Typen beschränkt. Es muss mindestens ein Fahrzeugtyp angegeben werden. „VehicleTypes“ mit der Kategorie UNKNOWN sind nicht zulässig.

VehicleAttribute

Caller können komplexe logische Vorgänge mit einer beliebigen Kombination der Felder required_attributes, required_one_of_attributes und required_one_of_attribute_sets bilden.

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
...)

Die Suche wird auf Fahrzeuge mit den angegebenen Attributen beschränkt. Dieses Feld ist ein Konjunktions-/AND-Vorgang. Es sind maximal 50 erforderliche Attribute zulässig. Dies entspricht der maximal zulässigen Anzahl von Attributen für ein Fahrzeug.

VehicleAttributeList

Die Suche wird auf Fahrzeuge mit mindestens einem der angegebenen Attribute in jeder VehicleAttributeList beschränkt. Innerhalb 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 gesamte Sammlung von VehicleAttributeList.

VehicleAttributeList

required_one_of_attribute_sets bietet zusätzliche Funktionen.

Ähnlich wie bei required_one_of_attributes wird bei required_one_of_attribute_sets eine Nachricht verwendet, die eine Liste von Listen zulässt. So sind Ausdrücke wie dieser möglich:

(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
  ...)
)

Die Suche wird auf Fahrzeuge mit allen Attributen in einer VehicleAttributeList beschränkt. Innerhalb jeder Liste muss ein Fahrzeug mit allen Attributen übereinstimmen. Dieses Feld ist eine Konjunktion/AND-Operation in jedem VehicleAttributeList und eine inklusive Disjunktion/OR-Operation für die gesamte 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 wurde. Wenn current_trips_present nicht angegeben ist und dieses Feld false ist, werden Fahrzeuge mit zugewiesenen Fahrten aus den Suchergebnissen ausgeschlossen. Wenn current_trips_present nicht angegeben ist und dieses Feld true ist, können Suchergebnisse Fahrzeuge mit einer aktiven Fahrt mit dem Status ENROUTE_TO_DROPOFF enthalten. Wenn current_trips_present angegeben ist, kann dieses Feld nicht auf „wahr“ gesetzt 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. Dieser muss auf einen anderen Wert als CURRENT_TRIPS_PRESENT_UNSPECIFIED festgelegt sein, wenn trip_type SHARED enthält.

string

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

Dieses Feld soll die Felder required_attributes, required_one_of_attributes und required_one_of_attributes_sets ersetzen. 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 funktioniert als AND-Klausel mit anderen Einschränkungen wie minimum_capacity oder vehicle_types.

Es werden nur Abfragen zu Fahrzeugattributen unterstützt (z. B. attributes.<key> = <value> oder attributes.<key1> = <value1> AND attributes.<key2> = <value2>). Die maximale Anzahl von Einschränkungen in einer Filterabfrage beträgt 50.

Außerdem werden alle Attribute als Strings gespeichert. Daher sind nur Stringvergleiche zulässig. Damit ein Vergleich mit numerischen oder booleschen Werten möglich ist, 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 den SearchVehiclesRequest-Kriterien entsprechen, sortiert nach dem Feld SearchVehiclesRequest.order_by.

int32

Der Startindex dieses Intervalls im Pfad. Wenn der Index in JSON 0 ist, wird das Feld als leer angezeigt.

int32

Der Endindex dieses Intervalls im Pfad. Wenn der Index in JSON 0 ist, wird das Feld als leer angezeigt.

Speed

Die Verkehrsgeschwindigkeit in diesem Intervall.

LatLng

Erforderlich. Gibt den tatsächlichen Standort an.

Timestamp

Gibt an, wann die Unterbrechung aufgetreten ist.

Timestamp

Nur Eingabe Verworfen. Verwenden Sie das Feld „Zeitstempel“.

LatLng

Erforderlich. Gibt den Standort eines Wegpunkts einer Fahrt 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 in Vehicle.waypoint verfügbar.

string

Verworfen.

string

Verworfen.

string

Verworfen.

VisualTrafficReportPolylineRendering

Ein Polylinien-Rendering der Verkehrsgeschwindigkeit für alle Regionen entlang eines Streckenabschnitts einer Fahrt.

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

Der Ort, an dem der Kunde angibt, dass er abgeholt werden möchte.

StopLocation

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

StopLocation

Nur Eingabe. Die tatsächliche Ankunftszeit und der tatsächliche Ort des Fahrers am Abholort. In diesem Feld kann der Anbieter Feedback zu den tatsächlichen Ankunftsinformationen an der Abholstelle geben.

Timestamp

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

TerminalLocation

Zwischenhaltestellen, die zusätzlich zu Abhol- und Absetzvorgang für die Fahrtanfragen erforderlich sind. Diese Funktion wird anfangs nicht für Fahrten mit mehreren Personen unterstützt.

Timestamp

Gibt an, wann die intermediate_destinations zuletzt geändert wurde. Dein Server sollte diesen Wert im Cache speichern und bei der Aktualisierung von intermediate_destination_index in UpdateTripRequest übergeben, damit intermediate_destinations nicht geändert wird.

int32

Wenn TripStatus = ENROUTE_TO_INTERMEDIATE_DESTINATION ist, eine Zahl zwischen [0..N-1], die angibt, welches Zwischenziel das Fahrzeug als Nächstes passiert. Wenn TripStatus = ARRIVED_AT_INTERMEDIATE_DESTINATION ist, eine Zahl zwischen [0..N-1], die angibt, an welchem Zwischenziel sich das Fahrzeug befindet. Dieser Wert wird vom Anbieter festgelegt. Wenn keine intermediate_destinations vorhanden sind, wird dieses Feld ignoriert.

StopLocation

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

StopLocation

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

TerminalLocation

Der Ort, an dem der Kunde angibt, dass er abgesetzt werden soll.

StopLocation

Nur Eingabe. Die tatsächliche Uhrzeit und der tatsächliche Ort, an dem der Kunde abgesetzt wurde. In diesem Feld kann der Anbieter Feedback zu den tatsächlichen Informationen zur Absetzung geben.

Timestamp

Nur Ausgabe. Entweder die geschätzte zukünftige Zeit, zu der die Fahrgäste am Zielort abgesetzt werden, oder die tatsächliche Zeit, zu der sie abgesetzt wurden.

TripWaypoint

Nur Ausgabe. Der vollständige Pfad vom aktuellen Standort zum Zielort. Dieser Pfad kann Wegpunkte aus anderen Fahrten enthalten.

TripWaypoint

In diesem Feld können die Wegpunkte für die Fahrt manuell sortiert werden. Sie enthält alle verbleibenden Wegpunkte für das zugewiesene Fahrzeug sowie die Abhol- und Rückgabeorte für diese Fahrt. Wenn der Fahrt kein Fahrzeug zugewiesen wurde, wird dieses Feld von Fleet Engine ignoriert. Aus Datenschutzgründen wird dieses Feld vom Server nur bei UpdateTrip- und CreateTrip-Aufrufen, NICHT bei GetTrip-Aufrufen ausgefüllt.

LatLng

Nur Ausgabe. Voraussichtliche Route für diese Fahrt zum ersten Eintrag in „remaining_waypoints“. Der erste Wegpunkt kann zu einer anderen Fahrt gehören.

string

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

Hinweis: Dieses Feld ist nur für das Driver SDK und das Consumer SDK vorgesehen. Das Dekodieren wird noch nicht unterstützt.

Timestamp

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

Hinweis: Dieses Feld ist nur für das Driver SDK und das 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 das Driver SDK und das Consumer SDK vorgesehen.

Timestamp

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

Hinweis: Dieses Feld ist nur für das Driver SDK und das Consumer SDK vorgesehen.

TripWaypoint

Nur Ausgabe. Der 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 abgeschlossen oder abgebrochen wurde.

Timestamp

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

Duration

Nur Ausgabe. Die Dauer zwischen dem Zeitpunkt, zu dem die Fahrtdaten zurückgegeben werden, und dem Zeitpunkt in Trip.eta_to_first_waypoint. Der Wert ist nicht angegeben, wenn die Fahrt keinem Fahrzeug zugewiesen ist oder inaktiv ist (abgeschlossen oder abgebrochen).

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, damit die Pfade und Zugriffe für remaining_waypoints nur zurückgegeben werden, wenn sie aktualisiert wurden.

int32

Nicht veränderbar. Gibt die Anzahl der Fahrgäste bei dieser Fahrt an, ohne den Fahrer. Ein Fahrzeug muss verfügbare Kapazität haben, um in einer SearchVehicles-Antwort zurückgegeben zu werden.

VehicleLocation

Nur Ausgabe. Der letzte gemeldete Standort des Fahrzeugs entlang der Route.

bool

Nur Ausgabe. Gibt an, ob die last_location des Fahrzeugs an das current_route_segment angedockt werden kann. „False“, wenn last_location oder current_route_segment nicht vorhanden ist. Sie wird von der Fleet Engine berechnet. Alle Aktualisierungen von Kunden werden ignoriert.

TripView

Die Teilmenge der ausgefüllten Trip-Felder und ihre Interpretation.

TerminalLocation

Der Standort dieses Wegpunkts.

string

Die mit diesem Wegpunkt verknüpfte Fahrt.

WaypointType

Die Rolle dieses Wegpunkts bei dieser Fahrt, z. B. Abhol- oder Abgabeort.

LatLng

Der Pfad vom vorherigen zum aktuellen Wegpunkt. Für den ersten Wegpunkt in einer Liste nicht definiert. Dieses Feld wird nur auf Anfrage ausgefüllt.

string

Der codierte Pfad vom vorherigen zum aktuellen Wegpunkt.

Hinweis: Dieses Feld ist nur für das Driver SDK und das Consumer SDK vorgesehen. Das Dekodieren wird noch nicht unterstützt.

ConsumableTrafficPolyline

Die Verkehrslage auf dem Weg zu diesem Wegpunkt. Hinweis: Der Traffic ist nur für Kunden der Google Maps Platform-Lösung für Mobilität und Lieferung verfügbar.

Int32Value

Die Pfaddistanz vom vorherigen zum aktuellen Wegpunkt. Für den ersten Wegpunkt in einer Liste nicht definiert.

Timestamp

Die voraussichtliche Ankunftszeit an diesem Wegpunkt. Für den ersten Wegpunkt in einer Liste nicht definiert.

Duration

Die Fahrtzeit vom vorherigen Wegpunkt zu diesem Punkt. Für den ersten Wegpunkt in einer Liste nicht definiert.

RequestHeader

Der Standard-Fleet Engine-Anfrageheader.

string

Erforderlich. Muss im Format providers/{provider}/trips/{trip} vorliegen. Der Anbieter muss die Projekt-ID (z. B. sample-consumer-project) des Google Cloud-Projekts sein, in dem das Dienstkonto, das diesen Aufruf ausführt, Mitglied ist.

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 geteilte Fahrt aktualisieren, müssen Sie die Liste der Trip.vehicle_waypoints angeben, um die Reihenfolge der verbleibenden Wegpunkte anzugeben. Andernfalls ist die Reihenfolge unbestimmt.

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

Um Wettlaufbedingungen bei 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 Version der Fleet Engine ü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 Standard-Fleet Engine-Anfrageheader.

string

Erforderlich. Muss im Format providers/{provider}/vehicles/{vehicle} vorliegen. Der Anbieter muss die Projekt-ID (z. B. sample-cloud-project) des Google Cloud-Projekts sein, in dem das Dienstkonto, das diesen Aufruf ausführt, Mitglied ist.

VehicleAttribute

Erforderlich. Die zu aktualisierenden Fahrzeugattribute. Nicht erwähnte Attribute werden nicht geändert oder entfernt.

VehicleAttribute

Erforderlich. Die aktualisierte vollständige Liste der Fahrzeugattribute, einschließlich neuer, geänderter und unveränderter Attribute.

RequestHeader

Der Standard-Fleet Engine-Anfrageheader.

string

Erforderlich. Muss im Format providers/{provider}/vehicles/{vehicle} vorliegen. {provider} muss die Projekt-ID (z. B. sample-cloud-project) des Google Cloud-Projekts sein, dessen Mitglied das Dienstkonto ist, das diesen Aufruf ausführt.

Vehicle

Erforderlich. Die anzuwendenden Werte der Entität „Vehicle“. Beim Aktualisieren einer 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, lesen Sie den Hilfeartikel zur Methode UpdateVehicleAttributes.

Das Feld waypoints kann ebenfalls aktualisiert werden, muss aber alle Wegpunkte enthalten, die sich derzeit im Fahrzeug befinden, und keine anderen Wegpunkte.

FieldMask

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

string

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

VehicleState

Der Fahrzeugstatus.

TripType

Fahrttypen, die von diesem Fahrzeug unterstützt werden.

string

Nur Ausgabe. Liste der trip_id für Fahrten, die diesem Fahrzeug derzeit zugewiesen sind.

VehicleLocation

Letzter gemeldeter Standort des Fahrzeugs.

int32

Die Gesamtzahl der Fahrgäste, die dieses Fahrzeug aufnehmen kann. Der Fahrer wird bei diesem Wert nicht berücksichtigt. Dieser Wert muss größer oder gleich 1 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 verwendet werden, um Fahrzeuge in SearchVehicles-Ergebnissen zu filtern. Sie wirkt sich auch auf die geschätzte Ankunftszeit und die Routenberechnung aus.

LicensePlate

Informationen zum Kfz-Kennzeichen des Fahrzeugs.

TerminalLocation

Verworfen. Verwenden Sie stattdessen Vehicle.waypoints.

string

Die Polylinie, die die Route angibt, die die Fahrer App zum nächsten Wegpunkt nehmen soll. 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 das Driver SDK vorgesehen. Das Dekodieren wird noch nicht unterstützt.

TrafficPolylineData

Nur Eingabe. Fleet Engine verwendet diese Informationen, um die Freigabe von Fahrten zu verbessern. Hinweis: Dieses Feld ist nur für das Driver SDK vorgesehen.

Timestamp

Nur Ausgabe. Zeitpunkt, zu dem current_route_segment festgelegt wurde. Sie kann vom Client gespeichert und in zukünftigen GetVehicle-Anfragen übergeben werden, um zu verhindern, dass sich nicht geänderte Routen zurückgeben.

TripWaypoint

Der Wegpunkt, an dem current_route_segment endet. Dieser kann von Fahrern bei UpdateVehicle-Aufrufen entweder als vollständiger Wegpunkt für die Fahrt, als Wegpunkt LatLng oder als letzter LatLng der current_route_segment angegeben werden. Die Fleet Engine versucht dann, einen tatsächlichen Wegpunkt zu interpolieren, wenn dieser nicht vollständig angegeben ist. Dieses Feld wird bei UpdateVehicle-Aufrufen ignoriert, es sei denn, current_route_segment ist ebenfalls angegeben.

Int32Value

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

Timestamp

Die geschätzte Zeit bis zum ersten Eintrag im Feld waypoints. Der Wert ist nicht angegeben, wenn das Feld waypoints oder das Feld Vehicle.current_route_segment leer ist.

Bei der Aktualisierung eines Fahrzeugs hat remaining_time_seconds in derselben Anfrage Vorrang vor eta_to_first_waypoint.

Int32Value

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

Bei der Aktualisierung 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. Zeitpunkt der letzten 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 wurde.

bool

Gibt an, ob der Fahrer Fahrten nacheinander annimmt. Wenn true, SearchVehicles das Fahrzeug auch dann enthalten kann, wenn es derzeit einer Fahrt zugewiesen ist. Der Standardwert ist false.

NavigationStatus

Der Navigationsstatus des Fahrzeugs.

DeviceSettings

Nur Eingabe. Informationen zu den Einstellungen auf dem Mobilgerät, das vom Fahrer verwendet wird.

Category

Kategorie des Fahrzeugtyps

string

Der Schlüssel des Attributs. Schlüssel dürfen das Doppelpunktzeichen (:) nicht enthalten.

string

Der Wert des Attributs.

string

Attributwert vom Typ „String“.

Hinweis: Dieses Feld ist mit dem Feld value identisch, das demnächst eingestellt wird. Für Methoden zum Erstellen oder Aktualisieren kann jedes der beiden Felder verwendet werden. Wir empfehlen jedoch dringend, string_value zu verwenden. Wenn sowohl string_value als auch value festgelegt sind, müssen sie identisch sein, da sonst ein Fehler auftritt. Beide Felder werden in Antworten ausgefüllt.

bool

Boolescher Attributwert.

double

Attributwert mit doppeltem Typ.

VehicleAttribute

Eine Liste der Attribute in dieser Sammlung.

LatLng

Der Standort des Fahrzeugs. Wenn die Daten an Fleet Engine gesendet werden, ist der Standort des Fahrzeugs ein GPS-Standort. Wenn Sie diese Antwort erhalten, kann der Standort des Fahrzeugs entweder ein GPS-Standort, ein ergänzender Standort oder ein anderer geschätzter Standort sein. Die Quelle wird in location_sensor angegeben.

DoubleValue

Verworfen. Verwenden Sie stattdessen latlng_accuracy.

DoubleValue

Genauigkeit von location Metern als Radius.

Int32Value

Die Fahrtrichtung des Fahrzeugs in Grad. „0“ steht für Norden. Der gültige Bereich ist [0,360].

DoubleValue

Verworfen. Verwenden Sie stattdessen heading_accuracy.

DoubleValue

Genauigkeit von heading Grad.

DoubleValue

Höhe in Metern über WGS84.

DoubleValue

Verworfen. Verwenden Sie stattdessen altitude_accuracy.

DoubleValue

Genauigkeit von altitude Metern.

Int32Value

Geschwindigkeit des Fahrzeugs in Kilometern pro Stunde. Verworfen. Verwenden Sie stattdessen speed.

DoubleValue

Geschwindigkeit des Fahrzeugs in Metern pro Sekunde

DoubleValue

Genauigkeit von speed in Metern pro Sekunde.

Timestamp

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

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem der Server die Standortinformationen empfangen hat.

LocationSensor

Anbieter von Standortdaten (z. B. GPS)

BoolValue

Gibt an, ob location an einer Straße angedockt 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 der Wert „0“. Wenn die Uhrzeit nicht bekannt ist (z. B. beim Neustart der App), wird dieser Wert auf null zurückgesetzt.

Int32Value

Nur Eingabe. Eingestellt: Es werden jetzt andere Signale verwendet, um zu ermitteln, ob ein Standort veraltet ist.

LatLng

Roher Fahrzeugstandort (nicht von RoadSnapper verarbeitet).

Timestamp

Zeitstempel, der mit dem Rohstandort verknüpft ist.

LocationSensor

Quelle des Rohstandorts. Die Standardeinstellung ist GPS.

DoubleValue

Genauigkeit von raw_location als Radius in Metern.

LatLng

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

Timestamp

Zeitstempel, der mit dem zusätzlichen Standort verknüpft ist.

LocationSensor

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

DoubleValue

Genauigkeit von supplemental_location als Radius in Metern.

bool

Verworfen. Verwenden Sie stattdessen is_road_snapped.

Vehicle

Erforderlich. Ein Fahrzeug, das der Anfrage entspricht.

Timestamp

Die geschätzte Ankunftszeit des Fahrzeugs am in der Anfrage angegebenen Abholpunkt. Ein leerer Wert weist auf einen Fehler bei der Berechnung der geschätzten Ankunftszeit für das Fahrzeug hin. Wenn SearchVehiclesRequest.include_back_to_back = true war und für dieses Fahrzeug eine Fahrt aktiv ist, enthält vehicle_pickup_eta die Zeit, die für die aktuelle aktive Fahrt erforderlich ist.

Int32Value

Die Entfernung vom aktuellen Standort des Fahrzeugs zum in der Anfrage angegebenen Abholpunkt, einschließlich aller Zwischenabhol- oder -abgabestellen für bestehende Fahrten. Diese Entfernung umfasst die berechnete Fahrstrecke (Route) sowie die Entfernung in gerader Linie zwischen dem Navigationsendpunkt und dem angeforderten Abholort. Die Entfernung zwischen dem Navigationsziel 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 geschätzte Ankunftszeit des gesamten Fahrzeugs am in der Anfrage angegebenen Zielort. Die geschätzte Ankunftszeit berücksichtigt alle Haltestellen vor dem in der Anfrage angegebenen dropoff_point. Der Wert wird nur dann ausgefüllt, wenn in der Anfrage ein Abholpunkt angegeben ist. Ein leerer Wert weist auf einen Fehler bei der Berechnung der geschätzten Ankunftszeit hin.

Int32Value

Die Fahrstrecke des Fahrzeugs (in Metern) vom Abhol- zum in der Anfrage angegebenen Zielort. Die Entfernung bezieht sich nur auf die beiden Punkte und schließt den Standort des Fahrzeugs oder andere Punkte nicht ein, die angefahren werden müssen, bevor das Fahrzeug den Abhol- oder Abgabeort anfährt. Der Wert wird nur ausgefüllt, wenn in der Anfrage ein dropoff_point angegeben ist. Ein leerer Wert weist auf einen Fehler bei der Berechnung der Entfernung vom Abhol- zum Abgabeort hin, der in der Anfrage angegeben ist.

TripType

Erforderlich. Der Fahrttyp der Anfrage, der zur Berechnung der geschätzten Ankunftszeit am Abholpunkt verwendet wurde.

Waypoint

Die sortierte Liste der Wegpunkte, die zur Berechnung der geschätzten Ankunftszeit verwendet wird. Die Liste enthält den Fahrzeugstandort, die Abholorte aktiver Fahrten für das Fahrzeug und die in der Anfrage angegebenen Abholorte. Eine leere Liste weist auf einen Fehler bei der Berechnung der geschätzten Ankunftszeit für das Fahrzeug hin.

VehicleMatchType

Art der Fahrzeugübereinstimmung.

VehicleMatchOrder

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

VehicleMatchOrder

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

RoadStretch

Optional. Straßenabschnitte, die entlang der Polylinie gerendert werden sollen. Abschnitte überschneiden sich nicht und umfassen nicht unbedingt die gesamte Route.

Wenn keine Straßenstrecke zu gestalten ist, sollte der Kunde den Standard für die Route anwenden.

Style

Erforderlich. Der anzuwendende Stil.

int32

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

int32

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

LatLng

Der Standort dieses Wegpunkts.

Timestamp

Die geschätzte Zeit, zu der das Fahrzeug an diesem Wegpunkt ankommt.