Package maps.fleetengine.v1

Index

TripService

Reiseverwaltungsdienst.

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

Erstellt eine Fahrt in der Fleet Engine und gibt die neue Fahrt zurück.
GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

Informationen zu einer einzelnen Fahrt abrufen
ReportBillableTrip

rpc ReportBillableTrip(ReportBillableTripRequest) returns (Empty)

Abrechenbare Fahrtnutzung melden.
SearchTrips

rpc SearchTrips(SearchTripsRequest) returns (SearchTripsResponse)

Du kannst alle Fahrten für ein bestimmtes Fahrzeug abrufen.
UpdateTrip

rpc UpdateTrip(UpdateTripRequest) returns (Trip)

Aktualisiert Fahrtdaten.

VehicleService

Fahrzeugverwaltung

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

Instanziiert ein neues Fahrzeug, das mit einem On-Demand-Anbieter von Mitfahrdiensten oder -lieferungen verknüpft ist Jede Vehicle muss eine eindeutige Fahrzeug-ID haben.

Die folgenden Vehicle-Felder sind beim Erstellen von Vehicle erforderlich:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Die folgenden Vehicle-Felder werden beim Erstellen von Vehicle 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 angegeben.
GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

Gibt ein Fahrzeug von Fleet Engine zurück.
ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

Gibt eine paginierte Liste von Fahrzeugen zurück, die mit einem Anbieter verknüpft sind und den Anfrageoptionen entsprechen.
SearchFuzzedVehicles

rpc SearchFuzzedVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

Eingestellt: Verwenden Sie stattdessen SearchVehicles.
SearchVehicles

rpc SearchVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

Gibt eine Liste der Fahrzeuge zurück, die den Anfrageoptionen entsprechen.
UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

Aktualisierte Fahrzeugdaten werden in Fleet Engine geschrieben.

Beim Aktualisieren von Vehicle können die folgenden Felder nicht aktualisiert werden, da sie vom Server verwaltet werden:

  • currentTrips
  • availableCapacity
  • current_route_segment_version
  • waypoints_version

Das Fahrzeug name kann ebenfalls nicht aktualisiert werden.

Wenn das Feld attributes aktualisiert wird, werden alle Attribute des Fahrzeugs durch die in der Anfrage angegebenen Attribute ersetzt. Wenn Sie nur einige Attribute aktualisieren möchten, verwenden Sie die Methode UpdateVehicleAttributes. Ebenso kann das Feld waypoints aktualisiert werden. Es muss aber alle Wegpunkte, die sich derzeit im Fahrzeug befinden, enthalten.
UpdateVehicleAttributes

rpc UpdateVehicleAttributes(UpdateVehicleAttributesRequest) returns (UpdateVehicleAttributesResponse)

Aktualisiert die Attribute eines Fahrzeugs teilweise. Nur die in der Anfrage genannten Attribute werden aktualisiert. Andere Attribute werden NICHT geändert. Hinweis: Bei UpdateVehicle wird hier das gesamte Feld attributes durch das Feld in UpdateVehicleRequest ersetzt. Attribute, die nicht in der Anfrage enthalten sind, werden entfernt.
UpdateVehicleLocation

rpc UpdateVehicleLocation(UpdateVehicleLocationRequest) returns (VehicleLocation)

Eingestellt: Verwenden Sie stattdessen die Methode UpdateVehicle. UpdateVehicleLocation aktualisiert den Standort des Fahrzeugs.

BatteryInfo

Informationen zum Akku des Geräts.

Felder
battery_status

BatteryStatus

Status des Akkus, u. a. vollständig aufgeladen oder aufgeladen
power_source

PowerSource

Status der Stromquelle für den Akku.
battery_percentage

float

Aktueller Akkustand in % [0–100].

BatteryStatus

Status des Akkus, u. a. vollständig aufgeladen oder aufgeladen

Enums
UNKNOWN_BATTERY_STATUS Akkustatus unbekannt.
BATTERY_STATUS_CHARGING Der Akku wird geladen.
BATTERY_STATUS_DISCHARGING Akku wird entladen.
BATTERY_STATUS_FULL Der Akku ist vollständig geladen.
BATTERY_STATUS_NOT_CHARGING Der Akku wird nicht geladen.
BATTERY_STATUS_POWER_LOW Der Akkustand ist niedrig.

BillingPlatformIdentifier

Eine Reihe von Werten, die angeben, auf welcher Plattform die Anfrage gesendet wurde.

Enums
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED Standard. Wird für nicht angegebene Plattformen verwendet.
SERVER Die Plattform ist ein Clientserver.
WEB Die Plattform ist ein Webbrowser.
ANDROID Die Plattform ist ein Android-Mobilgerät.
IOS Die Plattform ist ein iOS-Mobilgerät.
OTHERS Andere Plattformen, die in dieser Aufzählung nicht aufgeführt sind.

ConsumableTrafficPolyline

Verkehrsdichte auf der Strecke eines Fahrzeugs.

Felder
speed_reading_interval[]

SpeedReadingInterval

Die Verkehrsgeschwindigkeit auf dem Pfad vom vorherigen zum aktuellen Wegpunkt.
encoded_path_to_waypoint

string

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

CreateTripRequest

CreateTrip-Anfragenachricht.

Felder
header

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.
parent

string

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

string

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

  • Muss ein gültiger Unicode-String sein.
  • Er ist auf maximal 64 Zeichen begrenzt.
  • Normalisiert nach der Unicode-Normalisierungsform C.
  • Darf keine der folgenden ASCII-Zeichen enthalten: „/“, „:“, „?“, „,“ oder „#“.
trip

Trip

Erforderlich. 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 die Fahrt werden ignoriert. Beispielsweise beginnen alle Fahrten mit einem trip_status von NEW, auch wenn Sie in der Erstellungsanfrage ein trip_status von CANCELED übergeben.

intermediate_destinations wird nur von EXCLUSIVE Fahrten unterstützt.

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 Wegpunktreihenfolge unbestimmt.

Wenn Sie Trip.vehicle_waypoints angeben, muss die Liste alle anderen Wegpunkte der Fahrten des Fahrzeugs ohne zusätzliche Wegpunkte enthalten. Sie müssen diese Wegpunkte so bestellen, dass sich der Abholpunkt für eine bestimmte Fahrt vor Zwischenzielen und alle Zwischenziele vor diesen befinden. 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.

CreateVehicleRequest

CreateVehicle-Anfragenachricht.

Felder
header

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.
parent

string

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

string

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

  • Muss ein gültiger Unicode-String sein.
  • Er ist auf maximal 64 Zeichen begrenzt.
  • Normalisiert nach der Unicode-Normalisierungsform C.
  • Darf keine der folgenden ASCII-Zeichen enthalten: „/“, „:“, „?“, „,“ oder „#“.
vehicle

Vehicle

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

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Beim Erstellen eines Fahrzeugs werden die folgenden Felder ignoriert:

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

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

DeviceSettings

Informationen zu verschiedenen Einstellungen auf dem Mobilgerät.

Felder
location_power_save_mode

LocationPowerSaveMode

Festlegen, wie Standortfunktionen sich auf dem Gerät verhalten, wenn der Energiesparmodus aktiviert ist
is_power_save_mode

bool

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

bool

Gibt an, ob sich das Gerät im interaktiven Zustand befindet.
battery_info

BatteryInfo

Informationen zum Akkustatus.

GetTripRequest

GetTrip-Anfragenachricht.

Felder
header

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.
name

string

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

TripView

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

Timestamp

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

Timestamp

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

PolylineFormatType

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

Timestamp

Gibt den minimalen Zeitstempel (ausschließlich) an, für den Trip.current_route_segment_traffic abgerufen wird. Wenn sich die Verkehrsdaten seit diesem Zeitstempel nicht geändert haben, wird das Feld current_route_segment_traffic in der Antwort nicht festgelegt. Wenn ein Minimum nicht angegeben ist, werden die Traffic-Daten immer abgerufen. Beachten Sie, dass Traffic nur für Kunden der Lösung „On-Demand Rides and Deliveries“ verfügbar ist.
remaining_waypoints_route_version

Timestamp

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

GetVehicleRequest

GetVehicle-Anfragenachricht.

Felder
header

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.
name

string

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

Timestamp

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

Timestamp

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

LicensePlate

Das Kfz-Kennzeichen des Fahrzeugs. Damit keine personenidentifizierbaren Informationen gespeichert werden, werden nur die Informationen zum Nummernschild als Teil der Entität gespeichert.

Felder
country_code

string

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

string

Die letzte Ziffer des Kfz-Kennzeichens oder „-1“, wenn kein numerischer Wert vorhanden ist.

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

ListVehiclesRequest

ListVehicles-Anfragenachricht.

Felder
header

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.
parent

string

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

int32

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

string

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

Int32Value

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

TripType

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

Duration

Beschränkt die Antwort auf Fahrzeuge, die innerhalb des angegebenen Zeitraums Standortaktualisierungen an Fleet Engine gesendet haben. Stehende Fahrzeuge, die ihren Standort noch übertragen, gelten nicht als veraltet. Falls vorhanden, muss eine gültige positive Dauer sein.
vehicle_type_categories[]

Category

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

string

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

required_attributes ist eine Liste; required_one_of_attributes verwendet eine Nachricht, die eine Liste von Listen zulässt. In Kombination können die beiden Felder den Ausdruck zusammensetzen:

(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/UND-Operation. Es sind maximal 50 erforderliche Attribute zulässig. Das entspricht der maximalen Anzahl von Attributen, die für ein Fahrzeug zulässig sind. Jeder wiederholte String muss das Format „key:value“ haben.
required_one_of_attributes[]

string

Beschränkt die Antwort auf Fahrzeuge mit mindestens einem der angegebenen Attribute in jeder VehicleAttributeList. In jeder Liste muss ein Fahrzeug mit mindestens einem der Attribute übereinstimmen. Dieses Feld ist eine einschließende Disjunktions-/ODER-Operation für jeden VehicleAttributeList und eine Konjunktion/UND-Operation für die gesamte Sammlung von VehicleAttributeList. Jeder wiederholte String muss das Format „key1:value1|key2:value2|key3:value3“ haben.
required_one_of_attribute_sets[]

string

required_one_of_attribute_sets bietet zusätzliche Funktionen.

Ähnlich wie bei required_one_of_attributes wird in required_one_of_attribute_sets eine Nachricht verwendet, die eine Liste von Listen zulässt, wobei Ausdrücke wie diese zugelassen werden:

(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 einer VehicleAttributeList entsprechen. In jeder Liste muss ein Fahrzeug mit allen Attributen übereinstimmen. Dieses Feld ist eine Konjunktion/UND-Operation für jeden VehicleAttributeList- und alle einschließenden Disjunktions-/ODER-Vorgang in der Sammlung von VehicleAttributeList. Jeder wiederholte String muss das Format „key1:value1|key2:value2|key3:value3“ haben.
vehicle_state

VehicleState

Beschränkt die Antwort auf Fahrzeuge mit diesem Fahrzeugstatus.
on_trip_only

bool

Geben Sie nur Fahrzeuge mit aktuellen Fahrten zurück.
filter

string

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

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

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

Es werden nur Abfragen für Fahrzeugattribute wie attributes.<key> = <value> oder attributes.<key1> = <value1> AND attributes.<key2> = <value2> unterstützt. In einer Filterabfrage sind maximal 50 Einschränkungen zulässig.

Da alle Attribute als Strings gespeichert werden, werden Vergleiche mit Attributen nur unterstützt. Für einen Vergleich mit Zahlen- oder booleschen Werten müssen die Werte explizit in Anführungszeichen gesetzt werden, damit sie als Strings behandelt werden (z. B. attributes.<key> = "10" oder attributes.<key> = "true").
viewport

Viewport

Optional. Filter, der die zurückgegebenen Fahrzeuge auf diejenigen beschränkt, deren letzter bekannter Standort sich in dem rechteckigen Bereich befand, der vom Darstellungsbereich definiert wurde.

ListVehiclesResponse

ListVehicles-Antwortnachricht.

Felder
vehicles[]

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

string

Token zum Abrufen der nächsten Seite mit Fahrzeugen. Leer, wenn keine weiteren Fahrzeuge vorhanden sind, die die Anfragekriterien erfüllen.
total_size

int64

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

LocationPowerSaveMode

Festlegen, wie Standortfunktionen auf Mobilgeräten konfiguriert werden, wenn der Energiesparmodus aktiviert ist (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

Enums
UNKNOWN_LOCATION_POWER_SAVE_MODE Nicht definierter Energiesparmodus für Standort
LOCATION_MODE_NO_CHANGE Der Energiesparmodus sollte entweder keine Auswirkungen auf die Standortanbieter haben oder er ist deaktiviert.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF Der GPS-basierte Standortanbieter sollte deaktiviert werden, wenn der Energiesparmodus aktiviert ist und das Gerät nicht interaktiv ist.
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF Alle Standortanbieter sollten deaktiviert werden, wenn der Energiesparmodus aktiviert ist und das Gerät nicht interaktiv ist.
LOCATION_MODE_FOREGROUND_ONLY Alle Standortanbieter bleiben verfügbar, Standortkorrekturen sollten jedoch nur für Apps im Vordergrund bereitgestellt werden.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF Die Standortermittlung wird nicht deaktiviert, aber der Standortmanager drosselt alle Anfragen an Anbieter, wenn das Gerät nicht interaktiv ist.

LocationSensor

Der zur Standortbestimmung verwendete Sensor oder die Methode.

Enums
UNKNOWN_SENSOR Der Sensor ist nicht angegeben oder unbekannt.
GPS GPS oder unterstütztes GPS.
NETWORK Unterstütztes GPS, Mobilfunkmast-ID oder WLAN-Zugangspunkt.
PASSIVE Mobilfunkmast-ID oder WLAN-Zugangspunkt
ROAD_SNAPPED_LOCATION_PROVIDER Ein Standort, der vom Mobilgerät als wahrscheinlichste Straßenposition bestimmt wird.
CUSTOMER_SUPPLIED_LOCATION Ein vom Kunden bereitgestellter Standort aus einer unabhängigen Quelle. In der Regel wird dieser Wert für einen Standort verwendet, der aus anderen Quellen als dem Mobilgerät bereitgestellt wird, auf dem das Driver SDK ausgeführt wird. Wenn die ursprüngliche Quelle durch einen der anderen enum-Werte beschrieben wird, verwenden Sie diesen Wert. Mit CUSTOMER_SUPPLIED_LOCATION gekennzeichnete Standorte werden in der Regel über die last_location.supplemental_location_sensor eines Fahrzeugs bereitgestellt.
FLEET_ENGINE_LOCATION Ein Standort, der von Fleet Engine anhand der verfügbaren Signale berechnet wird. Nur Ausgabe Dieser Wert wird in einer Anfrage abgelehnt.
FUSED_LOCATION_PROVIDER Fused Location Provider von Android.
CORE_LOCATION Der Standortanbieter unter Apple-Betriebssystemen.

Der Navigationsstatus des Fahrzeugs.

Enums
UNKNOWN_NAVIGATION_STATUS Navigationsstatus nicht angegeben.
NO_GUIDANCE Die Navigation der Driver App befindet sich im FREE_NAV-Modus.
ENROUTE_TO_DESTINATION Die detaillierte Routenführung ist verfügbar und die Navigation der Fahrer-App befindet sich im GUIDED_NAV-Modus.
OFF_ROUTE Das Fahrzeug hat die vorgeschlagene Route verlassen.
ARRIVED_AT_DESTINATION Das Fahrzeug befindet sich im Umkreis von etwa 50 m um den Zielort.

PolylineFormatType

Der Typ des Polylinienformats.

Enums
UNKNOWN_FORMAT_TYPE Das Format ist nicht angegeben oder unbekannt.
LAT_LNG_LIST_TYPE Eine Liste von google.type.LatLng.
ENCODED_POLYLINE_TYPE Eine Polylinie, die mit einem Algorithmus zur Polylinienkomprimierung codiert ist. Die Decodierung wird noch nicht unterstützt.

PowerSource

Typ des Ladegeräts, das zum Laden des Akkus verwendet wird.

Enums
UNKNOWN_POWER_SOURCE Stromquelle unbekannt.
POWER_SOURCE_AC Als Stromquelle wird ein Netzteil verwendet.
POWER_SOURCE_USB Die Stromquelle ist ein USB-Anschluss.
POWER_SOURCE_WIRELESS Die Stromquelle ist kabellos.
POWER_SOURCE_UNPLUGGED Der Akku ist nicht angeschlossen.

ReportBillableTripRequest

ReportBillableTrip-Anfragenachricht gesendet.

Felder
name

string

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

string

Erforderlich. Der zweistellige Ländercode des Landes, in dem die Reise stattfindet. Der Preis richtet sich nach dem Ländercode.
platform

BillingPlatformIdentifier

Die Plattform, von der der Antrag gestellt wurde.
related_ids[]

string

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

SolutionType

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

SolutionType

Auswahl für verschiedene Lösungsarten einer gemeldeten Fahrt.

Enums
SOLUTION_TYPE_UNSPECIFIED Der Standardwert. Aus Gründen der Abwärtskompatibilität verwendet die API standardmäßig ON_DEMAND_RIDESHARING_AND_DELIVERIES. Dies ist der erste unterstützte Lösungstyp.
ON_DEMAND_RIDESHARING_AND_DELIVERIES Die Lösung ist eine On-Demand-Fahrt mit Mitfahr- und Lieferservice.

RequestHeader

Ein RequestHeader enthält Felder, die alle Fleet Engine-RPC-Anfragen gemeinsam haben.

Felder
language_code

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 keiner angegeben ist, kann die Antwort in einer beliebigen Sprache vorliegen, wobei Englisch bevorzugt wird, sofern ein solcher Name vorhanden ist. Beispiel für Feldwert: en-US.
region_code

string

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

string

Version des aufrufenden SDK, falls zutreffend. Das Versionsformat ist „major.minor.patch“, Beispiel: 1.1.2.
os_version

string

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

string

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

SdkType

Der SDK-Typ, von dem die Anfrage gesendet wird.
maps_sdk_version

string

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

string

Version des NavSDK, von dem das aufrufende SDK abhängt, sofern zutreffend. Das Versionsformat ist „major.minor.patch“, Beispiel: 2.1.0.
platform

Platform

Plattform des aufrufenden SDK
manufacturer

string

Hersteller des Android-Geräts über das aufrufende SDK; gilt nur für die Android SDKs. Beispiel für Feldwert: Samsung.
android_api_level

int32

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

string

Optionale ID, die für Protokollierungszwecke angegeben werden kann, um die Anfrage zu identifizieren.

Plattform

Die Plattform des aufrufenden SDK.

Enums
PLATFORM_UNSPECIFIED Der Standardwert. Dieser Wert wird verwendet, wenn der Bahnsteig ausgelassen wird.
ANDROID Die Anfrage kommt von Android.
IOS Die Anfrage stammt von iOS.
WEB Die Anfrage kommt aus dem Web.

SdkType

Mögliche SDK-Typen.

Enums
SDK_TYPE_UNSPECIFIED Der Standardwert. Dieser Wert wird verwendet, wenn sdk_type weggelassen wird.
CONSUMER Das aufrufende SDK ist „Consumer“.
DRIVER Das aufrufende SDK ist „Treiber“.
JAVASCRIPT Das aufrufende SDK ist JavaScript.

SearchTripsRequest

SearchTrips-Anfragenachricht.

Felder
header

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.
parent

string

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

string

Das mit den Fahrten in der Anfrage verknüpfte Fahrzeug. Wenn keine Vorgabe erfolgt, enthalten die zurückgegebenen Fahrten Folgendes nicht:

  • current_route_segment
  • remaining_waypoints
  • remaining_distance_meters
  • eta_to_first_waypoint
active_trips_only

bool

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

int32

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

string

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

Duration

Gibt die Fahrten zurück, die nach dem (current - minimum_staleness) nicht aktualisiert wurden.

SearchTripsResponse

SearchTrips-Antwortnachricht.

Felder
trips[]

Trip

Die Liste der Fahrten für das angeforderte Fahrzeug.
next_page_token

string

Übergeben Sie dieses Token in SearchTripsRequest, um die Listenergebnisse durchzugehen. Die API gibt bei jedem Aufruf eine Fahrtenliste zurück. Wenn keine weiteren Ergebnisse vorhanden sind, ist die Fahrtenliste leer.

SearchVehiclesRequest

SearchVehicles-Anfragenachricht.

Felder
header

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.
parent

string

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

TerminalLocation

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

TerminalLocation

Der beabsichtigte Rückgabeort des Kunden. Das Feld ist erforderlich, wenn trip_types „TripType.SHARED“ enthält.
pickup_radius_meters

int32

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

int32

Erforderlich. Gibt die maximale Anzahl von Fahrzeugen an, die zurückgegeben werden sollen. Der Wert muss zwischen 1 und 50 (einschließlich) liegen.
minimum_capacity

int32

Erforderlich. Gibt die Anzahl der Passagiere an, die für eine Fahrt berücksichtigt werden. Der Wert muss größer oder gleich eins sein. Der Treiber wird beim Kapazitätswert nicht berücksichtigt.
trip_types[]

TripType

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

Duration

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

VehicleType

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

VehicleAttribute

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

required_attributes ist eine Liste; required_one_of_attributes verwendet eine Nachricht, die eine Liste von Listen zulässt. In Kombination können die beiden Felder den Ausdruck zusammensetzen:

(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/UND-Operation. Es sind maximal 50 erforderliche Attribute zulässig. Das entspricht der maximalen Anzahl von Attributen, die für ein Fahrzeug zulässig sind.
required_one_of_attributes[]

VehicleAttributeList

Beschränkt die Suche auf Fahrzeuge mit mindestens einem der angegebenen Attribute in jeder VehicleAttributeList. In jeder Liste muss ein Fahrzeug mit mindestens einem der Attribute übereinstimmen. Dieses Feld ist eine einschließende Disjunktions-/ODER-Operation für jeden VehicleAttributeList und eine Konjunktion/UND-Operation für die gesamte Sammlung von VehicleAttributeList.
required_one_of_attribute_sets[]

VehicleAttributeList

required_one_of_attribute_sets bietet zusätzliche Funktionen.

Ähnlich wie bei required_one_of_attributes wird in required_one_of_attribute_sets eine Nachricht verwendet, die eine Liste von Listen zulässt, wobei Ausdrücke wie diese zugelassen werden:

(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 einer VehicleAttributeList. In jeder Liste muss ein Fahrzeug mit allen Attributen übereinstimmen. Dieses Feld ist eine Konjunktion/UND-Operation für jeden VehicleAttributeList- und alle einschließenden Disjunktions-/ODER-Vorgang in der Sammlung von VehicleAttributeList.
order_by

VehicleMatchOrder

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

bool

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

Der Standardwert ist false.
trip_id

string

Gibt die mit diesem SearchVehicleRequest verknüpfte Fahrt an.
current_trips_present

CurrentTripsPresent

Damit wird angegeben, ob Fahrzeuge mit aktiven Fahrten für diese Suche infrage kommen. Dieser Wert muss auf einen anderen Wert als CURRENT_TRIPS_PRESENT_UNSPECIFIED festgelegt werden, wenn trip_type SHARED enthält.
filter

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 ersetzt die Felder required_attributes, required_one_of_attributes und required_one_of_attributes_sets. Wenn hier ein nicht leerer Wert angegeben wird, müssen die folgenden Felder leer sein: required_attributes, required_one_of_attributes und required_one_of_attributes_sets.

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

Es werden nur Abfragen für Fahrzeugattribute wie attributes.<key> = <value> oder attributes.<key1> = <value1> AND attributes.<key2> = <value2> unterstützt. In einer Filterabfrage sind maximal 50 Einschränkungen zulässig.

Da alle Attribute als Strings gespeichert werden, werden Vergleiche mit Attributen nur unterstützt. Für einen Vergleich mit Zahlen- oder booleschen Werten müssen die Werte explizit in Anführungszeichen gesetzt werden, damit sie als Strings behandelt werden (z. B. attributes.<key> = "10" oder attributes.<key> = "true").

CurrentTripsPresent

Gibt die Arten von Einschränkungen für die aktuellen Fahrten eines Fahrzeugs an.

Enums
CURRENT_TRIPS_PRESENT_UNSPECIFIED Die Verfügbarkeit von Fahrzeugen mit Fahrten wird im Feld include_back_to_back geregelt.
NONE Fahrzeuge ohne Fahrten können in den Suchergebnissen erscheinen. Wenn dieser Wert verwendet wird, kann include_back_to_back nicht true sein.
ANY Fahrzeuge mit höchstens 5 aktuellen Fahrten und 10 Wegpunkten werden in die Suchergebnisse aufgenommen. Wenn dieser Wert verwendet wird, kann include_back_to_back nicht true sein.

VehicleMatchOrder

Gibt die Reihenfolge der in der Antwort übereinstimmenden Fahrzeuge an.

Enums
UNKNOWN_VEHICLE_MATCH_ORDER Standardeinstellung, wird für nicht angegebene oder nicht erkannte Fahrzeugübereinstimmungen verwendet.
PICKUP_POINT_ETA Aufsteigende Bestellung nach Fahrzeit des Fahrzeugs zum Abholpunkt.
PICKUP_POINT_DISTANCE Aufsteigende Bestellung, bezogen auf die Fahrstrecke des Fahrzeugs zum Abholpunkt.
DROPOFF_POINT_ETA Aufsteigende Reihenfolge nach Fahrzeit des Fahrzeugs bis zur Abgabestelle. Diese Reihenfolge kann nur verwendet werden, wenn der Rückgabepunkt in der Anfrage angegeben ist.
PICKUP_POINT_STRAIGHT_DISTANCE Aufsteigende Bestellung in Luftlinie vom zuletzt gemeldeten Standort des Fahrzeugs zum Abholpunkt.
COST In aufsteigender Reihenfolge nach den konfigurierten Abgleichskosten. Die Abgleichskosten sind definiert als gewichtete Berechnung zwischen linearer Entfernung und voraussichtlicher Ankunftszeit. Die Gewichtungen werden mit Standardwerten festgelegt und können je nach Kunde geändert werden. Wenden Sie sich an den Google-Support, wenn diese Gewichtungen für Ihr Projekt geändert werden müssen.

SearchVehiclesResponse

SearchVehicles-Antwortnachricht.

Felder
matches[]

VehicleMatch

Liste der Fahrzeuge, die den SearchVehiclesRequest-Kriterien entsprechen, sortiert nach dem Feld SearchVehiclesRequest.order_by.

SpeedReadingInterval

Anzeige der Verkehrsdichte an einem zusammenhängenden Abschnitt eines Pfads Bei einem Pfad mit den Punkten P_0, P_1, ... , P_N (nullbasierter Index) definiert SpeedReadingInterval ein Intervall und beschreibt den Verkehr mithilfe der folgenden Kategorien.

Felder
start_polyline_point_index

int32

Der Startindex dieses Intervalls im Pfad. Wenn der Index in JSON 0 ist, wird das Feld so angezeigt, als wäre es leer.
end_polyline_point_index

int32

Endindex dieses Intervalls im Pfad Wenn der Index in JSON 0 ist, wird das Feld so angezeigt, als wäre es leer.
speed

Speed

Verkehrsgeschwindigkeit in diesem Intervall.

Geschwindigkeit

Klassifizierung der Geschwindigkeit auf Polylinien basierend auf Verkehrsdaten.

Enums
SPEED_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
NORMAL Normale Geschwindigkeit, kein Verlangsamen wird erkannt.
SLOW Stau festgestellt, aber es wurde kein Stau gebildet.
TRAFFIC_JAM Stau erkannt.

StopLocation

Der tatsächliche Ort, an dem eine Haltestelle (Start/Abflug) stattgefunden hat.

Felder
point

LatLng

Erforderlich. Der tatsächliche Standort.
timestamp

Timestamp

Gibt an, wann die Haltestelle stattgefunden hat.
stop_time
(deprecated)

Timestamp

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

TerminalLocation

Beschreibt die Position eines Wegpunkts.

Felder
point

LatLng

Erforderlich. Gibt den Ort eines Wegpunkts an.
terminal_point_id

TerminalPointId

ID des Endpunkts.
access_point_id
(deprecated)

string

Veraltet.
trip_id
(deprecated)

string

Veraltet.
terminal_location_type
(deprecated)

WaypointType

Eingestellt: Vehicle.waypoint hat diese Daten.

TerminalPointId

Kennzeichnet einen Endpunkt.

Felder
value

string

Eindeutige ID des Endpunkts.
Union-Feld Id. Veraltet. Für Id ist nur einer der folgenden Werte zulässig:
place_id
(deprecated)

string

Veraltet.
generated_id
(deprecated)

string

Veraltet.

TrafficPolylineData

Die Verkehrslage auf der erwarteten Route des Fahrzeugs wird angezeigt.

Felder
traffic_rendering

VisualTrafficReportPolylineRendering

Polyliniendarstellung, die zeigt, wie schnell der Verkehr für alle Regionen entlang eines Abschnitts einer Fahrt ist.

Fahrt

Metadaten zu Fahrten.

Felder
name

string

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

string

ID des Fahrzeugs, das diese Fahrt durchführt.
trip_status

TripStatus

Aktueller Status der Fahrt.
trip_type

TripType

Die Art der Fahrt.
pickup_point

TerminalLocation

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

StopLocation

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

StopLocation

Nur Eingabe. Die tatsächliche Zeit und der tatsächliche Standort des Fahrers, der am Abholpunkt ankommt. In diesem Feld kann der Dienstleister Feedback zur tatsächlichen Ankunft an der Abholstelle geben.
pickup_time

Timestamp

Nur Ausgabe Entweder die geschätzte zukünftige Zeit, zu der der Fahrgast/die Fahrgäste abgeholt werden, oder die tatsächliche Uhrzeit, zu der der Fahrgast abgeholt wird.
intermediate_destinations[]

TerminalLocation

Zwischenstopps, die für die Fahrt erforderlich sind (zusätzlich zu Start und Ziel). Dies wird für gemeinsame Fahrten anfangs nicht unterstützt.
intermediate_destinations_version

Timestamp

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

int32

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

StopLocation

Nur Eingabe. Die tatsächliche Zeit und der Ort, an dem der Fahrer an einem Zwischenziel ankommt. In diesem Feld kann der Anbieter Feedback zu tatsächlichen Ankunftsinformationen an Zwischenzielen geben.
actual_intermediate_destinations[]

StopLocation

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

TerminalLocation

Ort, an dem der Kunde ausliefert
actual_dropoff_point

StopLocation

Nur Eingabe. Die tatsächliche Zeit und der tatsächliche Ort, an dem und zu der der Kunde ausgestiegen ist. In diesem Feld kann der Dienstleister Feedback zu den tatsächlichen Rückgabeinformationen geben.
dropoff_time

Timestamp

Nur Ausgabe Entweder die geschätzte zukünftige Zeit, zu der der Fahrgast/die Fahrgäste am endgültigen Ziel aussteigen, oder die tatsächliche Uhrzeit, zu der sie aussteigen.
remaining_waypoints[]

TripWaypoint

Nur Ausgabe Der vollständige Pfad vom aktuellen Standort bis zum Rückgabepunkt (einschließlich). Dieser Pfad kann Wegpunkte von anderen Fahrten enthalten.
vehicle_waypoints[]

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ückgabe-Wegpunkte für diese Fahrt. Wenn die Fahrt keinem Fahrzeug zugewiesen wurde, ignoriert Fleet Engine dieses Feld. Aus Datenschutzgründen wird dieses Feld nur bei UpdateTrip- und CreateTrip-Aufrufen vom Server ausgefüllt, NICHT bei GetTrip-Aufrufen.
route[]

LatLng

Nur Ausgabe Voraussichtliche Route für diese Fahrt zum ersten Eintrag in verbleibende_waypoints. Beachte, dass der erste Wegpunkt möglicherweise zu einer anderen Fahrt gehört.
current_route_segment

string

Nur Ausgabe Ein codierter Pfad zum nächsten Wegpunkt.

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

Timestamp

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

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

ConsumableTrafficPolyline

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

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

Timestamp

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

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

TripWaypoint

Nur Ausgabe Wegpunkt, an dem current_route_segment endet
remaining_distance_meters

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 storniert wurde.
eta_to_first_waypoint

Timestamp

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

Duration

Nur Ausgabe Der Zeitraum ab der Rückgabe der Fahrtdaten bis zur Zeit in Trip.eta_to_first_waypoint. Der Wert ist nicht angegeben, wenn die Fahrt keinem Fahrzeug zugewiesen oder inaktiv ist (abgeschlossen oder abgebrochen).
remaining_waypoints_version

Timestamp

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

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 bei einer Aktualisierung zurückgegeben werden.
number_of_passengers

int32

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

VehicleLocation

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

bool

Nur Ausgabe Gibt an, ob der last_location des Fahrzeugs an das aktuelle_route_segment angedockt werden kann. Falsch, wenn last_location oder current_route_segment nicht vorhanden ist. Sie wird von Fleet Engine berechnet. Updates von Clients werden ignoriert.
view

TripView

Der ausgefüllte Teil der Trip-Felder und wie sie zu interpretieren sind.

TripStatus

Der Status einer Fahrt, der ihren Verlauf anzeigt.

Enums
UNKNOWN_TRIP_STATUS Standardeinstellung, wird für einen unbekannten oder nicht erkannten Fahrtstatus verwendet.
NEW Neu erstellte Reise.
ENROUTE_TO_PICKUP Der Fahrer ist auf dem Weg zum Abholpunkt.
ARRIVED_AT_PICKUP Der Fahrer ist am Abholpunkt angekommen.
ARRIVED_AT_INTERMEDIATE_DESTINATION Der Fahrer ist an einem Zwischenziel angekommen und wartet auf den Fahrgast.
ENROUTE_TO_INTERMEDIATE_DESTINATION Der Fahrer ist auf dem Weg zu einem Zwischenziel (nicht zur Abgabestelle).
ENROUTE_TO_DROPOFF Der Fahrer hat den Fahrgast abgeholt und ist auf dem Weg zum nächsten Ziel.
COMPLETE Der Fahrgast ist ausgestiegen und die Fahrt ist abgeschlossen.
CANCELED Die Fahrt wurde vor der Abholung durch den Fahrer, Fahrgast oder Mitfahrdienst storniert.

TripType

Die Art einer Fahrt.

Enums
UNKNOWN_TRIP_TYPE Standardeinstellung, wird für nicht angegebene oder nicht erkannte Fahrttypen verwendet.
SHARED Möglicherweise wird ein Fahrzeug gemeinsam mit anderen Fahrten gefahren.
EXCLUSIVE Die Fahrt gilt ausschließlich für ein Fahrzeug.

TripView

Auswahl für verschiedene Gruppen von Trip-Feldern in einer GetTrip-Antwort. Weitere Informationen finden Sie unter AIP-157. Weitere Aufrufe werden wahrscheinlich hinzugefügt.

Enums
TRIP_VIEW_UNSPECIFIED Der Standardwert. Aus Gründen der Abwärtskompatibilität wird für die API standardmäßig eine SDK-Ansicht verwendet. Um Stabilität und Support zu gewährleisten, wird Kunden empfohlen, einen anderen TripView als SDK zu verwenden.
SDK Enthält Felder, die bei öffentlich verfügbaren Bibliotheken möglicherweise nicht interpretiert oder unterstützt werden können.
JOURNEY_SHARING_V1S Für den Anwendungsfall „Wegbeschreibung teilen“ werden die Felder für Fahrten ausgefüllt. Diese Ansicht ist für die Server-zu-Server-Kommunikation vorgesehen.

TripWaypoint

Beschreibt einen Haltepunkt auf der Route eines Fahrzeugs oder einen Endpunkt auf der Fahrt eines Fahrzeugs.

Felder
location

TerminalLocation

Die Position dieses Wegpunkts
trip_id

string

Die Fahrt, die diesem Wegpunkt zugeordnet ist.
waypoint_type

WaypointType

Die Rolle, die dieser Wegpunkt bei dieser Fahrt spielt, z. B. der Ein- oder Ausstieg.
path_to_waypoint[]

LatLng

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

string

Der codierte Pfad vom vorherigen zum aktuellen Wegpunkt

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

ConsumableTrafficPolyline

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

Int32Value

Der Pfadabstand vom vorherigen zum aktuellen Wegpunkt. Für den ersten Wegpunkt in einer Liste nicht definiert.
eta

Timestamp

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

Duration

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

UpdateTripRequest

UpdateTrip-Anfragenachricht.

Felder
header

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.
name

string

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

Trip

Erforderlich. Die mit der Aktualisierung verknüpfte Fahrt.

Die folgenden Felder werden von 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 anderen Wegpunkte der Fahrten des Fahrzeugs ohne zusätzliche Wegpunkte enthalten. Sie müssen diese Wegpunkte so bestellen, dass sich der Abholpunkt für eine bestimmte Fahrt vor Zwischenzielen und alle Zwischenziele vor diesen befinden. 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 eine Race-Bedingung für Fahrten mit mehreren Zielen zu vermeiden, sollten Sie beim Aktualisieren des Fahrtstatus auf ENROUTE_TO_INTERMEDIATE_DESTINATION Trip.intermediate_destinations_version angeben. Die übergebene Trip.intermediate_destinations_version muss der Version von Fleet Engine entsprechen. Andernfalls schlägt die Anfrage fehl.
update_mask

FieldMask

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

UpdateVehicleAttributesRequest

UpdateVehicleAttributes-Anfragenachricht.

Felder
header

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.
name

string

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

VehicleAttribute

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

UpdateVehicleAttributesResponse

UpdateVehicleAttributes-Antwortnachricht.

Felder
attributes[]

VehicleAttribute

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

UpdateVehicleLocationRequest

UpdateVehicleLocation-Anfragenachricht.

Felder
header

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.
name

string

Erforderlich. Muss das Format providers/{provider}/vehicles/{vehicle} haben. Bei {provider} muss es sich um die Projekt-ID des Google Cloud-Projekts handeln, zu dem das Dienstkonto gehört, zu dem dieser Aufruf gehört, z. B. sample-cloud-project.
current_location

VehicleLocation

Erforderlich. Der letzte Standort des Fahrzeugs. Die Unterfelder location und update_time sind Pflichtfelder.
current_state

VehicleState

Legen Sie den Status des Fahrzeugs auf ONLINE oder OFFLINE fest. Wird der Wert auf UNKNOWN_VEHICLE_STATE gesetzt, bleibt der Status des Fahrzeugs unverändert.

UpdateVehicleRequest

„UpdateVehicle-Anfragenachricht.

Felder
header

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.
name

string

Erforderlich. Muss das Format providers/{provider}/vehicles/{vehicle} haben. Bei {provider} muss es sich um die Projekt-ID des Google Cloud-Projekts handeln, zu dem das Dienstkonto gehört, zu dem dieser Aufruf gehört, z. B. sample-cloud-project.
vehicle

Vehicle

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

  • available_capacity
  • current_route_segment_version
  • current_trips
  • name
  • waypoints_version

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

Ebenso kann das Feld waypoints aktualisiert werden. Es muss aber alle Wegpunkte, die sich derzeit im Fahrzeug befinden, enthalten.
update_mask

FieldMask

Erforderlich. Eine Feldmaske, die angibt, welche Felder von Vehicle aktualisiert werden sollen. Mindestens ein Feldname muss angegeben werden.

Fahrzeug

Fahrzeugmetadaten.

Felder
name

string

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

VehicleState

Fahrzeugstatus
supported_trip_types[]

TripType

Von diesem Fahrzeug unterstützte Fahrttypen.
current_trips[]

string

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

VehicleLocation

Letzter gemeldeter Standort des Fahrzeugs.
maximum_capacity

int32

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

VehicleAttribute

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

VehicleType

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

LicensePlate

Das Nummernschild des Fahrzeugs.
route[]
(deprecated)

TerminalLocation

Eingestellt: Verwenden Sie stattdessen Vehicle.waypoints.
current_route_segment

string

Die Polylinie, die die Route angibt, die die Fahrer-App zum nächsten Wegpunkt zurücklegen 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 Decodierung wird noch nicht unterstützt.
current_route_segment_traffic

TrafficPolylineData

Nur Eingabe. Fleet Engine verwendet diese Informationen, um das Teilen von Journeys zu verbessern. Hinweis: Dieses Feld ist nur für die Verwendung durch das Driver SDK vorgesehen.
current_route_segment_version

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

TripWaypoint

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

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. Der Wert ist nicht angegeben, wenn das Feld current_route_segment leer ist.
eta_to_first_waypoint

Timestamp

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

Wenn ein Fahrzeug aktualisiert wird, hat remaining_time_seconds Vorrang vor eta_to_first_waypoint in derselben Anfrage.
remaining_time_seconds

Int32Value

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

Wenn ein Fahrzeug aktualisiert wird, hat remaining_time_seconds Vorrang vor eta_to_first_waypoint in derselben Anfrage.
waypoints[]

TripWaypoint

Die verbleibenden Wegpunkte, die diesem Fahrzeug zugewiesen sind.
waypoints_version

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

bool

Gibt an, ob der Fahrer Rückfahrten akzeptiert. Wenn true festgelegt ist, kann das Fahrzeug in SearchVehicles eingeschlossen werden, auch wenn es derzeit einer Fahrt zugewiesen ist. Der Standardwert ist false.
navigation_status

NavigationStatus

Der Navigationsstatus des Fahrzeugs.
device_settings

DeviceSettings

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

VehicleType

Der Fahrzeugtyp.

Felder
category

Category

Fahrzeugtypkategorie

Kategorie

Fahrzeugtypen

Enums
UNKNOWN Standardeinstellung, wird für nicht spezifizierte oder nicht erkannte Fahrzeugkategorien verwendet.
AUTO Ein Auto.
TAXI Jedes Fahrzeug, das als Taxi fungiert (in der Regel lizenziert oder reguliert).
TRUCK In der Regel ein Fahrzeug mit einer großen Speicherkapazität.
TWO_WHEELER Motorrad, Moped oder anderes zweirädriges Fahrzeug
BICYCLE Von Menschen angetriebene Fahrzeuge.
PEDESTRIAN Ein Personentransporter, der in der Regel zu Fuß oder joggt und Fußgängerwege entlangfährt.

VehicleAttribute

Beschreibt ein Fahrzeugattribut als Schlüssel/Wert-Paar. Der String „key:value“ darf nicht länger als 256 Zeichen sein.

Felder
key

string

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

string

Der Wert des Attributs.
Union-Feld vehicle_attribute_value. Der Wert des Attributs kann als String, boolescher oder doppelter Typ angegeben werden. Für vehicle_attribute_value ist nur einer der folgenden Werte zulässig:
string_value

string

Attributwert vom Typ „String“.

Hinweis: Dies ist mit dem Feld value identisch, das letztendlich verworfen wird. Bei Erstellungs- oder Aktualisierungsmethoden kann jedes Feld 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 den Antworten ausgefüllt.
bool_value

bool

Boolescher Attributwert.
number_value

double

Doppelt eingegebener Attributwert.

VehicleAttributeList

Ein Datentyp „list-of-lists“ für Fahrzeugattribute.

Felder
attributes[]

VehicleAttribute

Eine Liste von Attributen in dieser Sammlung.

VehicleLocation

Standort, Geschwindigkeit und Fahrtrichtung eines Fahrzeugs zu einem bestimmten Zeitpunkt

Felder
location

LatLng

Der Standort des Fahrzeugs. Wenn es an Fleet Engine gesendet wird, ist der Standort des Fahrzeugs ein GPS-Standort. Wenn Sie diese als Antwort erhalten, kann der Standort des Fahrzeugs entweder ein GPS-Standort, ein zusätzlicher Standort oder ein anderer ungefährer Standort sein. Die Quelle wird in location_sensor angegeben.
horizontal_accuracy
(deprecated)

DoubleValue

Eingestellt: Verwenden Sie stattdessen latlng_accuracy.
latlng_accuracy

DoubleValue

Genauigkeit von location in Metern als Radius.
heading

Int32Value

Richtung des Fahrzeugs in Grad. 0 steht für Norden. Der gültige Bereich ist [0,360).
bearing_accuracy
(deprecated)

DoubleValue

Eingestellt: Verwenden Sie stattdessen heading_accuracy.
heading_accuracy

DoubleValue

Genauigkeit von heading Grad.
altitude

DoubleValue

Höhe in Metern über WGS 84
vertical_accuracy
(deprecated)

DoubleValue

Eingestellt: Verwenden Sie stattdessen altitude_accuracy.
altitude_accuracy

DoubleValue

Genauigkeit von altitude in Metern.
speed_kmph
(deprecated)

Int32Value

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

DoubleValue

Geschwindigkeit des Fahrzeugs in Metern/Sekunde
speed_accuracy

DoubleValue

Genauigkeit von speed in Metern/Sekunde.
update_time

Timestamp

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

Timestamp

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

LocationSensor

Anbieter der Standortdaten (z. B. GPS).
is_road_snapped

BoolValue

Gibt an, ob location an eine Straße angedockt ist.
is_gps_sensor_enabled

BoolValue

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

Int32Value

Nur Eingabe. Zeit (in Sekunden), seit dieser Standort zum ersten Mal an den Server gesendet wurde Bei der ersten Aktualisierung ist der Wert null. Wenn die Uhrzeit unbekannt ist, z. B. wenn die App neu gestartet wird, wird dieser Wert auf null zurückgesetzt.
num_stale_updates
(deprecated)

Int32Value

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

LatLng

Unbearbeiteter Standort des Fahrzeugs (nicht verarbeitet von Snapper)
raw_location_time

Timestamp

Zeitstempel, der dem Rohstandort zugeordnet ist.
raw_location_sensor

LocationSensor

Quelle des unformatierten Speicherorts. Die Standardeinstellung ist GPS.
raw_location_accuracy

DoubleValue

Genauigkeit von raw_location als Radius in Metern.
supplemental_location

LatLng

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

Timestamp

Zeitstempel, der dem zusätzlichen Standort zugeordnet ist.
supplemental_location_sensor

LocationSensor

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

DoubleValue

Genauigkeit von supplemental_location als Radius in Metern.
road_snapped
(deprecated)

bool

Eingestellt: Verwenden Sie stattdessen is_road_snapped.

VehicleMatch

Enthält das Fahrzeug und zugehörige Schätzungen für ein Fahrzeug, die den Punkten aktiver Fahrten für das Fahrzeug SearchVehiclesRequest entsprechen.

Felder
vehicle

Vehicle

Erforderlich. Ein Fahrzeug, das der Anfrage entspricht.
vehicle_pickup_eta

Timestamp

Die voraussichtliche Ankunftszeit des Fahrzeugs zum Abholpunkt, der in der Anfrage angegeben ist. Ein leerer Wert bedeutet, dass die voraussichtliche Ankunftszeit für das Fahrzeug nicht berechnet werden konnte. Wenn „SearchVehiclesRequest.include_back_to_back“ auf „true“ gesetzt 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.
vehicle_pickup_distance_meters

Int32Value

Die Entfernung vom aktuellen Standort des Fahrzeugs bis zu dem in der Anfrage angegebenen Abholpunkt, einschließlich aller Zwischen- oder Absetzpunkte für bestehende Fahrten. Sie setzt sich aus der berechneten Fahrstrecke (Routen-Entfernung) plus der Luftlinie zwischen dem Navigationsendpunkt und dem angeforderten Abholpunkt zusammen. (Die Entfernung zwischen dem Navigationsendpunkt und dem gewünschten Abholpunkt ist in der Regel gering.) Ein leerer Wert weist auf einen Fehler bei der Berechnung der Entfernung hin.
vehicle_pickup_straight_line_distance_meters

Int32Value

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

Timestamp

Die voraussichtliche Ankunftszeit des gesamten Fahrzeugs an der in der Anfrage angegebenen Abgabestelle. Die voraussichtliche Ankunftszeit beinhaltet auch einen Halt an jedem Wegpunkt vor dem in der Anfrage angegebenen dropoff_point. Der Wert wird nur gefüllt, wenn in der Anfrage ein Rückgabepunkt angegeben ist. Ein leerer Wert weist auf einen Fehler bei der Berechnung der voraussichtlichen Ankunftszeit hin.
vehicle_pickup_to_dropoff_distance_meters

Int32Value

Die Fahrstrecke des Fahrzeugs (in Metern) vom Abholpunkt bis zu dem in der Anfrage angegebenen Rückgabepunkt. Die Entfernung liegt nur zwischen den beiden Punkten und umfasst weder den Fahrzeugstandort noch andere Punkte, die besichtigt werden müssen, bevor das Fahrzeug den Abhol- oder Absetzpunkt besucht. Der Wert wird nur gefüllt, wenn in der Anfrage ein dropoff_point angegeben ist. Ein leerer Wert bedeutet, dass die in der Anfrage angegebene Entfernung zwischen dem Abhol- und dem Rückgabepunkt nicht berechnet werden konnte.
trip_type

TripType

Erforderlich. Der Fahrttyp der Anfrage, der zur Berechnung der voraussichtlichen Ankunftszeit bis zum Abholpunkt verwendet wurde.
vehicle_trips_waypoints[]

Waypoint

Die sortierte Liste der Wegpunkte, die zur Berechnung der voraussichtliche Ankunftszeit verwendet werden. Die Liste enthält den Fahrzeugstandort, die Abholpunkte der aktiven Fahrten für das Fahrzeug und die in der Anfrage angegebenen Abholpunkte. Eine leere Liste weist auf einen Fehler bei der Berechnung der voraussichtlichen Ankunftszeit für das Fahrzeug hin.
vehicle_match_type

VehicleMatchType

Typ des übereinstimmenden Fahrzeugs.
requested_ordered_by

VehicleMatchOrder

Die Reihenfolge, in der die Fahrzeugübereinstimmungen sortiert werden.
ordered_by

VehicleMatchOrder

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

VehicleMatchType

Übereinstimmender Fahrzeugtyp.

Enums
UNKNOWN Unbekannter Übereinstimmungstyp des Fahrzeugs
EXCLUSIVE Dem Fahrzeug ist derzeit keine Fahrt zugewiesen und es kann zum Abholpunkt fahren.
BACK_TO_BACK Das Fahrzeug ist derzeit einer Fahrt zugewiesen, kann aber nach Abschluss der laufenden Fahrt zum Abholpunkt fahren. Bei der Berechnung der voraussichtliche Ankunftszeit und der Entfernung wird die vorhandene Fahrt berücksichtigt.
CARPOOL Das Fahrzeug hat genügend Kapazität für eine gemeinsame Fahrt.
CARPOOL_BACK_TO_BACK Das Fahrzeug beendet seine aktuelle, aktive Fahrt, bevor es zum Abholpunkt auffährt. Bei der Berechnung der voraussichtliche Ankunftszeit und der Entfernung wird die vorhandene Fahrt berücksichtigt.

VehicleState

Der Status eines Vehicle-Objekts.

Enums
UNKNOWN_VEHICLE_STATE Standardeinstellung, wird für nicht spezifizierte oder nicht erkannte Fahrzeugstatus verwendet.
OFFLINE Das Fahrzeug akzeptiert keine neuen Fahrten. Hinweis: Das Fahrzeug kann in diesem Status weiterhin betrieben werden, während eine ihm zugewiesene Fahrt beendet wird.
ONLINE Das Fahrzeug akzeptiert neue Fahrten.

VisualTrafficReportPolylineRendering

Beschreibt, wie Clients einen Teil der Polylinie entlang der Route färben sollen

Felder
road_stretch[]

RoadStretch

Optional. Straßenabschnitte, die entlang der Polylinie gerendert werden sollen. Streckenabschnitte werden garantiert nicht überlappen und reichen nicht unbedingt die gesamte Route.

Falls keine Straßenabschnitte für den Stil festgelegt werden, sollte der Client die Standardeinstellung für die Route anwenden.

RoadStretch

Ein Straßenabschnitt, der gerendert werden sollte.

Felder
style

Style

Erforderlich. Der Stil, der angewendet werden soll.
offset_meters

int32

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

int32

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

Stil

Der Verkehrsstil, der die Verkehrsgeschwindigkeit angibt.

Enums
STYLE_UNSPECIFIED Kein Stil ausgewählt.
SLOWER_TRAFFIC Der Verkehr wird langsamer.
TRAFFIC_JAM Es gibt einen Stau.

Zwischenstopp

Beschreibt Zwischenpunkte entlang einer Route für einen VehicleMatch in einem SearchVehiclesResponse. Dieses Konzept wird in allen anderen Endpunkten als TripWaypoint dargestellt.

Felder
lat_lng

LatLng

Die Position dieses Wegpunkts
eta

Timestamp

Die voraussichtliche Ankunftszeit des Fahrzeugs an diesem Wegpunkt.

WaypointType

Die Art des Wegpunkts.

Enums
UNKNOWN_WAYPOINT_TYPE Unbekannter oder nicht angegebener Wegpunkttyp.
PICKUP_WAYPOINT_TYPE Wegpunkte zum Abholen von Fahrgästen oder Gegenständen
DROP_OFF_WAYPOINT_TYPE Wegpunkte für die Abgabe von Fahrgästen oder Gegenständen
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Wegpunkte für Zwischenziele bei einer Fahrt mit mehreren Reisezielen.