Package maps.fleetengine.v1

BatteryStatus

Akkustatus, z. B. „Voll“ oder „Wird geladen“

PowerSource

Status der Stromquelle (Akku).

float

Aktueller Akkustand in Prozent [0–100].

SpeedReadingInterval

Verkehrsgeschwindigkeit auf dem Weg vom vorherigen zum aktuellen Wegpunkt.

string

Der Weg, den der Fahrer vom vorherigen zum aktuellen Wegpunkt nimmt. Dieser Pfad enthält Orientierungspunkte, sodass Clients Verkehrsmarkierungen entlang des Pfads anzeigen können (siehe speed_reading_interval). Die Dekodierung 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, zu dem das Dienstkonto gehört, das diesen Aufruf ausführt.

string

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

• Muss ein gültiger Unicode-String sein.
• Die maximale Länge beträgt 64 Zeichen.
• Normalisiert gemäß Unicode Normalization Form C.
• Darf keines der folgenden ASCII-Zeichen enthalten: „/“, „:“, „?“, „,“ oder „#“.

Trip

Erforderlich. Die zu erstellende Reiseentität.

Beim Erstellen einer Reise 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 Felder für Fahrten werden ignoriert. Alle Fahrten beginnen beispielsweise mit einem trip_status von NEW, auch wenn Sie in der Erstellungsanfrage ein trip_status von CANCELED übergeben.

Nur EXCLUSIVE-Fahrten unterstützen intermediate_destinations.

Wenn vehicle_id für eine gemeinsame Fahrt festgelegt ist, müssen Sie die Liste der Trip.vehicle_waypoints angeben, um die Reihenfolge der verbleibenden Wegpunkte für das Fahrzeug festzulegen. Andernfalls ist die Reihenfolge der Wegpunkte 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 für eine bestimmte Fahrt der Abholort vor den Zwischenzielen und alle Zwischenziele vor dem Zielort liegen. Die Wegpunkte einer EXCLUSIVE-Fahrt dürfen sich nicht mit anderen 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, zu dem das Dienstkonto gehört, das diesen Aufruf ausführt.

string

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

• Muss ein gültiger Unicode-String sein.
• Die maximale Länge beträgt 64 Zeichen.
• Normalisiert gemäß Unicode Normalization Form C.
• Darf keines der folgenden ASCII-Zeichen enthalten: „/“, „:“, „?“, „,“ oder „#“.

Vehicle

Erforderlich. Die zu erstellende Vehicle-Entitä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 sind.

RequestHeader

Optional. 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, zu dem das Dienstkonto gehört, das diesen Aufruf ausführt.

RequestHeader

Optional. 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, zu dem das Dienstkonto gehört, das diesen Aufruf ausführt.

LocationPowerSaveMode

Wie sich 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 Akkustand.

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, zu dem das Dienstkonto gehört, das diesen Aufruf ausführt.

TripView

Die Teilmenge der Felder für Fahrten, 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 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

Eingestellt: Trip.remaining_waypoints werden immer abgerufen. Mit remaining_waypoints_route_version können Sie steuern, wann Trip.remaining_waypoints.traffic_to_waypoint- und Trip.remaining_waypoints.path_to_waypoint-Daten abgerufen werden.

PolylineFormatType

Das zurückgegebene Format der aktuellen Route: 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 sich die Traffic-Daten seit diesem Zeitstempel nicht geändert haben, wird das Feld current_route_segment_traffic in der Antwort nicht festgelegt. Wenn kein Mindestwert angegeben ist, werden die Traffic-Daten immer abgerufen. Hinweis: Zugriffe sind nur für Kunden der On-demand Rides & 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 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, zu dem das Dienstkonto gehört, das diesen Aufruf ausführt.

Timestamp

Gibt den minimalen Zeitstempel (exklusiv) an, für den Vehicle.current_route_segment abgerufen wird. Wenn sich die Route seit diesem Zeitstempel nicht geändert hat, wird das Feld current_route_segment nicht in der Antwort 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 Nummernschilds oder „-1“, wenn keine numerischen Werte im Nummernschild vorhanden sind.

• „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, zu dem das Dienstkonto gehört, das diesen Aufruf ausführt.

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 durch Gruppen von Fahrzeugen 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. Alle zurückgegebenen Fahrzeuge haben einen maximum_capacity, der größer oder gleich diesem Wert ist. Falls festgelegt, muss der Wert größer oder gleich 0 sein.

TripType

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

Duration

Beschränkt die Antwort auf Fahrzeuge, die innerhalb des angegebenen Zeitraums Standortaktualisierungen an Fleet Engine gesendet haben. Fahrzeuge, die ihre Positionen weiterhin übertragen, werden nicht als veraltet betrachtet. Falls vorhanden, muss es sich um eine gültige positive Dauer handeln.

Category

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

string

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

required_attributes ist eine Liste, required_one_of_attributes verwendet eine Nachricht, die eine Liste von Listen ermöglicht. 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 zulässigen Anzahl von Attributen für ein Fahrzeug. Jeder wiederholte String sollte das Format „Schlüssel:Wert“ haben.

string

Beschränkt die Antwort auf Fahrzeuge mit mindestens einem der angegebenen Attribute in jedem VehicleAttributeList. Innerhalb jeder Liste muss ein Fahrzeug mindestens einem der Attribute entsprechen. Dieses Feld ist eine inklusive Disjunktion/ODER-Operation in jedem VehicleAttributeList und eine Konjunktion/UND-Operation für die Sammlung von VehicleAttributeList. Jeder wiederholte String sollte 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 wird bei required_one_of_attribute_sets eine Nachricht verwendet, die eine Liste von Listen zulässt, sodass Ausdrücke wie dieser möglich sind:

(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 allen Attributen in einem VehicleAttributeList entsprechen. Innerhalb jeder Liste muss ein Fahrzeug allen Attributen entsprechen. Dieses Feld ist eine Konjunktion/AND-Operation in jedem VehicleAttributeList und eine inklusive Disjunktion/OR-Operation für die Sammlung von VehicleAttributeList. Jeder wiederholte String sollte das Format „key1:value1|key2:value2|key3:value3“ haben.

VehicleState

Beschränkt die Antwort auf Fahrzeuge mit diesem Fahrzeugstatus.

bool

Gibt 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>). Die maximale Anzahl von Einschränkungen, die in einer Filterabfrage zulässig sind, beträgt 50.

Außerdem werden alle Attribute als Strings gespeichert. Daher sind nur Stringvergleiche für Attribute möglich. Wenn Sie Zahlen oder boolesche Werte vergleichen möchten, 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 des Viewports 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. Leer, wenn keine weiteren Fahrzeuge vorhanden sind, die den Anfragekriterien entsprechen.

int64

Erforderlich. Gesamtzahl der Fahrzeuge, die den Anfragekriterien auf allen Seiten 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, zu dem das Dienstkonto gehört, das diesen Aufruf ausführt.

string

Erforderlich. Der aus zwei Buchstaben bestehende Ländercode des Landes, in dem die Reise stattfindet. Der Preis wird anhand des Ländercodes festgelegt.

BillingPlatformIdentifier

Die Plattform, auf der die Anfrage gestellt wurde.

string

Die Kennungen, die sich direkt auf die gemeldete Fahrt beziehen. Das sind in der Regel IDs (z. B. Sitzungs-IDs) von Vorgängen, die vor der Buchung und vor der Verfügbarkeit der Reise-ID ausgeführt wurden. 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 wird.

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 einer beliebigen Sprache erfolgen. Englisch wird bevorzugt, wenn ein solcher Name vorhanden ist. 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 Anruf-SDK, 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 Anruf-SDK ausgeführt wird. Beispiele für Feldwerte: iPhone12,1, SM-G920F.

SdkType

Der Typ des SDK, das die Anfrage sendet.

string

Version des MapSDK, von dem das aufrufende SDK abhängt (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 SDK.

string

Hersteller des Android-Geräts, von dem das aufrufende SDK stammt. Gilt nur für die Android-SDKs. Beispiel für Feldwert: Samsung.

int32

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

string

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

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, zu dem das Dienstkonto gehört, das diesen Aufruf ausführt.

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 auf „true“ gesetzt, enthält die Antwort Fahrten, die die Route eines Fahrers beeinflussen.

int32

Wenn nicht festgelegt, bestimmt der Server die Anzahl der zurückzugebenden Ergebnisse.

string

Legen Sie diesen Wert auf einen Wert fest, der zuvor in SearchTripsResponse zurückgegeben wurde, um mit den vorherigen Ergebnissen fortzufahren.

Duration

Falls 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 im SearchTripsRequest, um die Ergebnisliste zu durchblättern. Die API gibt bei jedem Aufruf eine Liste von Fahrten zurück. Wenn keine Ergebnisse mehr vorhanden sind, ist die Liste 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, zu dem das Dienstkonto gehört, das diesen Aufruf ausführt.

TerminalLocation

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

TerminalLocation

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

int32

Erforderlich. Definiert den Suchradius für Fahrzeuge um den Abholort. 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 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 im Kapazitätswert nicht berücksichtigt.

TripType

Erforderlich. Gibt den Typ der vorgeschlagenen Fahrt an. Muss genau einen Typ enthalten. UNKNOWN_TRIP_TYPE ist nicht zulässig. Die Suche wird auf Fahrzeuge beschränkt, die für diesen Reisetyp geeignet sind.

Duration

Schränkt die Suche auf Fahrzeuge ein, die innerhalb des angegebenen Zeitraums Standortaktualisierungen an Fleet Engine gesendet haben. Fahrzeuge, die ihre Positionen weiterhin übertragen, werden nicht als veraltet betrachtet. 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. „VehicleTypes“ mit der Kategorie UNKNOWN sind nicht zulässig.

VehicleAttribute

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

required_attributes ist eine Liste, required_one_of_attributes verwendet eine Nachricht, die eine Liste von Listen ermöglicht. 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 zulässigen Anzahl von Attributen für ein Fahrzeug.

VehicleAttributeList

Beschränkt die Suche auf Fahrzeuge, die mindestens eines der angegebenen Attribute in jeder VehicleAttributeList haben. Innerhalb jeder Liste muss ein Fahrzeug mindestens einem der Attribute entsprechen. Dieses Feld ist eine inklusive Disjunktion/ODER-Operation in jedem VehicleAttributeList und eine Konjunktion/UND-Operation für die 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, sodass Ausdrücke wie dieser möglich sind:

(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 Fahrzeuge mit allen Attributen in einem VehicleAttributeList. Innerhalb jeder Liste muss ein Fahrzeug allen Attributen entsprechen. Dieses Feld ist eine Konjunktion/AND-Operation in jedem VehicleAttributeList und eine inklusive Disjunktion/OR-Operation für die Sammlung von VehicleAttributeList.

VehicleMatchOrder

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

bool

Gibt an, ob Fahrzeuge mit einer einzelnen 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 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 „true“ gesetzt werden.

Der Standardwert ist false.

string

Gibt die mit dieser SearchVehicleRequest verknüpfte Fahrt an.

CurrentTripsPresent

Gibt an, ob Fahrzeuge mit aktiven Fahrten für diese Suche infrage kommen. Dieser Wert muss auf etwas anderes als CURRENT_TRIPS_PRESENT_UNSPECIFIED festgelegt werden, 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, die in einer Filterabfrage zulässig sind, beträgt 50.

Außerdem werden alle Attribute als Strings gespeichert. Daher sind nur Stringvergleiche für Attribute möglich. Wenn Sie Zahlen oder boolesche Werte vergleichen möchten, 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. In JSON wird das Feld nicht ausgefüllt, wenn der Index 0 ist.

int32

Der Endindex dieses Intervalls im Pfad. In JSON wird das Feld nicht ausgefüllt, wenn der Index 0 ist.

Speed

Verkehrsgeschwindigkeit in diesem Intervall.

LatLng

Erforderlich. Gibt den tatsächlichen Standort an.

Timestamp

Gibt an, wann der Stopp erfolgte.

Timestamp

Nur Eingabe Verworfen. Verwenden Sie das Zeitstempelfeld.

LatLng

Gibt die genaue LatLng des Wegpunkts an. Es muss entweder point oder place als Eingabe angegeben werden. Wenn beide angegeben sind, wird point für das Routing und place für Metadaten verwendet. Wenn nur place als Eingabe angegeben wird, wird point aus dem place berechnet und in die Ausgabe aufgenommen.

string

Der Ressourcenname des Orts, der diesen Standort repräsentiert. Das Format dafür ist places/{place_id}. Es muss entweder point oder place als Eingabe angegeben werden. Wenn beide angegeben sind, wird point für das Routing und place für Metadaten verwendet. place wird nur in die Ausgabe aufgenommen, wenn es in der Eingabe enthalten war. Das bedeutet, dass keine place-Suche über LatLng erfolgt.

Dies ist eine experimentelle Funktion.

PointSource

Nur Ausgabe. Die Quelle des Felds point.

TerminalPointId

Verworfen: Geben Sie stattdessen das Feld place an.

string

Verworfen: Geben Sie stattdessen das Feld place an.

string

Verworfen.

WaypointType

Eingestellt: Vehicle.waypoint enthält diese Daten.

string

Verworfen.

string

Verworfen.

string

Verworfen.

VisualTrafficReportPolylineRendering

Eine Polylinien-Darstellung der Verkehrsgeschwindigkeit für alle Regionen entlang einer Strecke einer Kundenfahrt.

string

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

string

Die 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 abgeholt werden möchte.

StopLocation

Nur Eingabe. Der tatsächliche Standort, 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 Ankunftsort des Fahrers am Abholort. In diesem Feld kann der Anbieter Feedback zu den tatsächlichen Ankunftsinformationen am Abholort 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

Zwischenstopps in der Reihenfolge, in der die Fahrtanfragen (zusätzlich zu Abholung und Abgabe) erfolgen. Anfangs wird dies für geteilte Fahrten nicht unterstützt.

Timestamp

Gibt an, wann die intermediate_destinations zuletzt geändert wurde. Ihr Server sollte diesen Wert im Cache speichern und in UpdateTripRequest übergeben, wenn intermediate_destination_index aktualisiert wird, damit intermediate_destinations nicht geändert wird.

int32

Wenn TripStatus gleich ENROUTE_TO_INTERMEDIATE_DESTINATION ist, eine Zahl zwischen [0..N-1], die angibt, welches Zwischenziel das Fahrzeug als Nächstes erreicht. Wenn TripStatus gleich 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 Zeit und der tatsächliche Ort der Ankunft des Fahrers an einem Zwischenziel. In diesem Feld kann der Anbieter Feedback zu den tatsächlichen Ankunftszeiten an Zwischenzielen geben.

StopLocation

Nur Eingabe. Die tatsächliche Uhrzeit und der tatsächliche Ort, an dem der Kunde von 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 abgesetzt werden möchte.

StopLocation

Nur Eingabe. Die tatsächliche Uhrzeit und der tatsächliche Ort, an dem der Kunde abgesetzt wurde. Dieses Feld ist für den Anbieter vorgesehen, um Feedback zu den tatsächlichen Informationen zum Absetzen zu 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 bis zum Abgabeort (einschließlich). Dieser Pfad kann Wegpunkte von anderen Reisen enthalten.

TripWaypoint

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

LatLng

Nur Ausgabe. Die 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 die Verwendung durch das Driver SDK und das Consumer SDK vorgesehen. Die Dekodierung 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 durch das Driver SDK und das Consumer SDK vorgesehen.

ConsumableTrafficPolyline

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

Hinweis: Dieses Feld ist nur für die Verwendung durch 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 die Verwendung durch 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 voraussichtliche Ankunftszeit am nächsten Wegpunkt (der erste Eintrag im Feld remaining_waypoints). Der Wert ist nicht angegeben, wenn die Fahrt keinem Fahrzeug zugewiesen ist oder die Fahrt inaktiv ist (abgeschlossen oder abgebrochen).

Duration

Nur Ausgabe. Die Dauer ab dem Zeitpunkt, zu dem die Fahrtdaten zurückgegeben werden, 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 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 Client-App sollte diesen Wert im Cache speichern und in GetTripRequest übergeben, damit die Pfade und der Traffic für remaining_waypoints nur zurückgegeben werden, wenn sie aktualisiert wurden.

int32

Nicht veränderbar. Gibt die Anzahl der Passagiere auf dieser Fahrt an. Der Fahrer ist nicht enthalten. Ein Fahrzeug muss freie Kapazitäten haben, um in einer SearchVehicles-Antwort zurückgegeben zu werden.

VehicleLocation

Nur Ausgabe. Gibt den zuletzt gemeldeten Standort des Fahrzeugs auf der Route an.

bool

Nur Ausgabe. Gibt an, ob die last_location des Fahrzeugs an das aktuelle Routensegment angeglichen werden kann. „False“, wenn last_location oder current_route_segment nicht vorhanden ist. Sie wird von Fleet Engine berechnet. Alle Updates von Clients werden ignoriert.

TripView

Die Teilmenge der Trip-Felder, die ausgefüllt werden, und wie sie interpretiert werden sollten.

TripAttribute

Eine Liste benutzerdefinierter Trip-Attribute. Jedes Attribut muss einen eindeutigen Schlüssel haben.

string

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

string

Attributwert vom Typ „String“.

bool

Boolescher Attributwert.

double

Attributwert vom Typ „Double“.

TerminalLocation

Der Standort dieses Wegpunkts.

string

Die mit diesem Wegpunkt verknüpfte Fahrt.

WaypointType

Die Rolle, die dieser Wegpunkt auf dieser Fahrt spielt, z. B. Abholung oder Abgabe.

LatLng

Der Pfad vom vorherigen zum aktuellen Wegpunkt. Wenn dies der erste Wegpunkt ist, verläuft der Pfad vom aktuellen Standort des Fahrzeugs zum Wegpunkt. Dieses Feld wird nur auf Anfrage ausgefüllt.

string

Der codierte Pfad vom vorherigen zum aktuellen Wegpunkt.

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

ConsumableTrafficPolyline

Die Verkehrslage auf dem Weg zu diesem Wegpunkt. Hinweis: Verkehrsdaten sind nur für Kunden der Google Maps Platform Rides and Deliveries Solution verfügbar.

Int32Value

Die Entfernung auf dem Pfad vom vorherigen zum aktuellen Wegpunkt. Wenn dies der erste Wegpunkt ist, wird die Entfernung vom aktuellen Standort des Fahrzeugs zum Wegpunkt berechnet.

Timestamp

Die voraussichtliche Ankunftszeit an diesem Wegpunkt.

Duration

Die Reisezeit vom vorherigen Wegpunkt zu diesem Wegpunkt. Wenn dies der erste Wegpunkt ist, wird die Reisezeit vom aktuellen Standort des Fahrzeugs zum Wegpunkt berechnet.

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, zu dem das Dienstkonto gehört, das diesen Aufruf ausführt.

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 ist die Reihenfolge 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 für eine bestimmte Fahrt der Abholort vor den Zwischenzielen und alle Zwischenziele vor dem Zielort liegen. Die Wegpunkte einer EXCLUSIVE-Fahrt dürfen sich nicht mit anderen 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 von Fleet Engine übereinstimmen. Andernfalls schlägt die Anfrage fehl.

FieldMask

Erforderlich. Die Feldmaske, die angibt, welche Felder im 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, zu dem das Dienstkonto gehört, das diesen Aufruf ausführt.

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, zu dem das Dienstkonto gehört, das diesen Aufruf ausführt.

Vehicle

Erforderlich. Die anzuwendenden Werte der Vehicle-Entität. Beim Aktualisieren eines Vehicle dürfen die folgenden Felder nicht aktualisiert werden, 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 Abschnitt zur Methode UpdateVehicleAttributes.

Ebenso kann das Feld waypoints aktualisiert werden, muss aber alle Wegpunkte enthalten, die sich derzeit auf dem 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 für dieses Fahrzeug. Das Format dafür ist providers/{provider}/vehicles/{vehicle}.

VehicleState

Der Fahrzeugstatus.

TripType

Von diesem Fahrzeug unterstützte Fahrtentypen.

string

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

VehicleLocation

Letzter gemeldeter Standort des Fahrzeugs.

VehicleLocation

Nur Eingabe. Standorte, an denen sich das Fahrzeug in der Vergangenheit befunden hat und die noch nicht an Fleet Engine gemeldet wurden. Dies wird in UpdateVehicleRequest verwendet, um Standorte aufzuzeichnen, die zuvor nicht an den Server gesendet werden konnten. Das passiert in der Regel, wenn das Fahrzeug keine Internetverbindung hat.

int32

Die Gesamtzahl der Personen, die mit diesem Fahrzeug transportiert werden können. 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. Wirkt sich auch auf die Berechnung der voraussichtlichen Ankunftszeit und der Route aus.

LicensePlate

Informationen zum 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 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 durch das Driver SDK vorgesehen. Die Dekodierung wird noch nicht unterstützt.

TrafficPolylineData

Nur Eingabe. Fleet Engine verwendet diese Informationen, um die Funktion zum Teilen von Fahrten zu verbessern. Hinweis: Dieses Feld ist nur für die Verwendung durch 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 Routen zurückgegeben werden, die sich nicht geändert haben.

TripWaypoint

Der Wegpunkt, an dem current_route_segment endet. Dies kann von Fahrern bei UpdateVehicle-Aufrufen entweder als vollständiger Wegpunkt, als Wegpunkt LatLng oder als letzter LatLng der current_route_segment angegeben werden. Fleet Engine versucht dann, einen tatsächlichen Wegpunkt zu interpolieren, wenn er 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 das 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 ist nicht angegeben, wenn das Feld current_route_segment leer ist.

Timestamp

Die geschätzte Ankunftszeit für den ersten Eintrag im Feld waypoints. Der Wert ist 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 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.

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

bool

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

NavigationStatus

Der Navigationsstatus des Fahrzeugs.

DeviceSettings

Nur Eingabe. Informationen zu den Einstellungen des vom Fahrer verwendeten Mobilgeräts.

Category

Kategorie des Fahrzeugtyps

string

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

string

Der Wert des Attributs.

string

Attributwert vom Typ „String“.

Hinweis: Dieses Feld ist identisch mit dem Feld value, das demnächst eingestellt wird. Für Erstellungs- oder Aktualisierungsmethoden kann eines der beiden Felder verwendet werden. Es wird jedoch dringend empfohlen, string_value zu verwenden. Wenn sowohl string_value als auch value festgelegt sind, müssen sie identisch sein. Andernfalls wird ein Fehler ausgegeben. Beide Felder werden in Antworten ausgefüllt.

bool

Boolescher Attributwert.

double

Attributwert vom Typ „Double“.

VehicleAttribute

Eine Liste der Attribute in dieser Sammlung.

LatLng

Der Standort des Fahrzeugs. Wenn die Position an Fleet Engine gesendet wird, ist sie ein GPS-Standort. Wenn Sie den Standort in einer Antwort erhalten, kann es sich dabei entweder um einen GPS-Standort, einen ergänzenden Standort oder einen anderen geschätzten Standort handeln. Die Quelle ist in location_sensor angegeben.

DoubleValue

Verworfen: Verwenden Sie stattdessen latlng_accuracy.

DoubleValue

Genauigkeit von location Metern als Radius.

Int32Value

Richtung, in die sich das Fahrzeug bewegt, 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 in Grad.

DoubleValue

Höhe in Metern über WGS84.

DoubleValue

Verworfen: Verwenden Sie stattdessen altitude_accuracy.

DoubleValue

Genauigkeit von altitude in 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 gemeldet wurde, gemäß der Uhr des Sensors.

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 eine 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, seitdem dieser Standort zum ersten Mal an den Server gesendet wurde. Beim ersten Update ist dieser Wert null. Wenn die Zeit unbekannt ist (z. B. wenn die App neu gestartet wird), wird dieser Wert auf null zurückgesetzt.

Int32Value

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

LatLng

Rohdaten zum Fahrzeugstandort (nicht von Road-Snapper verarbeitet).

Timestamp

Der Zeitstempel, der dem Rohstandort zugeordnet ist.

LocationSensor

Quelle des Rohstandorts. Die Standardeinstellung ist GPS.

DoubleValue

Genauigkeit von raw_location als Radius in Metern.

LatLng

Der Standort vom Android-Anbieter für kombinierte Standortbestimmung (Fused Location Provider; FLP).

Timestamp

Zeitstempel von flp_location aktualisieren

DoubleValue

Genauigkeit von flp_location Metern als Radius.

Int32Value

Richtung, in die sich das Fahrzeug bewegt, in Grad, wie vom Fused Location Provider bestimmt. 0 steht für Norden. Der gültige Bereich ist [0,360).

LatLng

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

Timestamp

Zeitstempel für den zusätzlichen Standort.

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 Abholort. Ein leerer Wert weist auf einen Fehler bei der Berechnung der voraussichtlichen Ankunftszeit für das Fahrzeug hin. Wenn SearchVehiclesRequest.include_back_to_back true war und für dieses Fahrzeug eine aktive Fahrt vorliegt, enthält vehicle_pickup_eta die Zeit, die zum Abschluss der aktuellen aktiven Fahrt erforderlich ist.

Int32Value

Die Entfernung vom aktuellen Standort des Fahrzeugs zum im Antrag angegebenen Abholort, einschließlich aller Zwischenabhol- oder ‑abgabeorte für bestehende Fahrten. Diese Entfernung umfasst die berechnete Fahrstrecke (Route) sowie die Luftlinie zwischen dem Navigationsendpunkt und dem angeforderten Abholort. Der Abstand zwischen dem Navigationsziel und dem angeforderten Abholort 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 im Antrag angegebenen Abholort.

Timestamp

Die geschätzte Ankunftszeit des gesamten Fahrzeugs am in der Anfrage angegebenen Zielort. Die geschätzte Ankunftszeit umfasst auch Aufenthalte an allen Wegpunkten vor dem in der Anfrage angegebenen dropoff_point. Der Wert wird nur ausgefüllt, wenn in der Anfrage ein Abgabeort angegeben ist. Ein leerer Wert weist auf einen Fehler bei der Berechnung der voraussichtlichen Ankunftszeit hin.

Int32Value

Die Fahrstrecke des Fahrzeugs (in Metern) vom Abholort zum im Antrag angegebenen Zielort. Die Entfernung wird nur zwischen den beiden Punkten berechnet und berücksichtigt nicht den Standort des Fahrzeugs oder andere Punkte, die vor dem Abhol- oder Abgabeort angefahren werden müssen. 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 zwischen dem in der Anfrage angegebenen Abhol- und Zielort hin.

TripType

Erforderlich. Der Fahrtentyp der Anfrage, die zur Berechnung der voraussichtlichen Ankunftszeit am Abholort verwendet wurde.

Waypoint

Die geordnete Liste der Wegpunkte, die zum Berechnen der voraussichtlichen Ankunftszeit verwendet werden. 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 darauf hin, dass die voraussichtliche Ankunftszeit für das Fahrzeug nicht berechnet werden konnte.

VehicleMatchType

Typ der Fahrzeugübereinstimmung.

VehicleMatchOrder

Die für die Sortierung der Fahrzeugübereinstimmungen angeforderte Reihenfolge. Gleichbedeutend mit ordered_by.

VehicleMatchOrder

Die für die Sortierung der Fahrzeugübereinstimmungen angeforderte Reihenfolge. Gleichbedeutend mit requested_ordered_by.

RoadStretch

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

Wenn kein Straßenabschnitt zum Formatieren vorhanden ist, sollte der Client die Standardeinstellung 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 voraussichtliche Ankunftszeit des Fahrzeugs an diesem Wegpunkt.