Package maps.fleetengine.v1

Index

TripService

Fahrtverwaltungsdienst.

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 Fahrten melden

SearchTrips

rpc SearchTrips(SearchTripsRequest) returns (SearchTripsResponse)

Sie können alle Fahrten für ein bestimmtes Fahrzeug abrufen.

UpdateTrip

rpc UpdateTrip(UpdateTripRequest) returns (Trip)

Aktualisiert Fahrtdaten.

VehicleService

Fahrzeugverwaltungsdienst

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

Erzeugt ein neues Fahrzeug, das mit einem On-Demand-Fahrdienst oder einem Lieferservice verknüpft ist. Jede Vehicle muss eine eindeutige Fahrzeug-ID haben.

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

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Die folgenden Vehicle-Felder werden beim Erstellen eines 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, wenn sie angegeben sind.

GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

Gibt ein Fahrzeug aus der Fleet Engine zurück.

ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

Gibt eine paginierte Liste von Fahrzeugen zurück, die einem Anbieter zugeordnet sind und den Anfrageoptionen entsprechen.

SearchVehicles

rpc SearchVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

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

UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

Schreibt aktualisierte Fahrzeugdaten in die Fleet Engine.

Beim Aktualisieren einer 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, lesen Sie den Hilfeartikel zur Methode UpdateVehicleAttributes. Ebenso kann das Feld waypoints aktualisiert werden, muss aber alle derzeit auf dem Fahrzeug vorhandenen Wegpunkte und keine anderen Wegpunkte enthalten.

UpdateVehicleAttributes

rpc UpdateVehicleAttributes(UpdateVehicleAttributesRequest) returns (UpdateVehicleAttributesResponse)

Aktualisiert teilweise Attribute des Fahrzeugs. Es werden nur die in der Anfrage genannten Attribute aktualisiert. Andere Attribute werden NICHT geändert. Hinweis: Dies ist anders bei UpdateVehicle, da hier das gesamte Feld attributes durch das Feld in UpdateVehicleRequest ersetzt wird. Attribute, die nicht in der Anfrage enthalten sind, werden entfernt.

BatteryInfo

Informationen zum Akku des Geräts.

Felder
battery_status

BatteryStatus

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

power_source

PowerSource

Status der Akkustromquelle.

battery_percentage

float

Aktueller Akkustand in Prozent [0–100].

BatteryStatus

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

Enums
UNKNOWN_BATTERY_STATUS Akkustand unbekannt.
BATTERY_STATUS_CHARGING Der Akku wird geladen.
BATTERY_STATUS_DISCHARGING Der Akku wird entladen.
BATTERY_STATUS_FULL Akku ist vollständig geladen.
BATTERY_STATUS_NOT_CHARGING 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

Die Verkehrsdichte entlang des Pfades eines Fahrzeugs.

Felder
speed_reading_interval[]

SpeedReadingInterval

Verkehrsgeschwindigkeit auf dem Weg vom vorherigen bis zum aktuellen Wegpunkt.

encoded_path_to_waypoint

string

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

CreateTripRequest

Anfragenachricht für CreateTrip

Felder
header

RequestHeader

Der Standard-Anfrageheader von Fleet Engine.

parent

string

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

trip_id

string

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

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

Trip

Erforderlich. Zu erstellende Reiseentität.

Beim Erstellen einer Fahrt sind die folgenden Felder erforderlich:

  • trip_type
  • pickup_point

Die folgenden Felder werden verwendet, wenn Sie sie angeben:

  • number_of_passengers
  • vehicle_id
  • dropoff_point
  • intermediate_destinations
  • vehicle_waypoints

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

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

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

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

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

CreateVehicleRequest

Anfragenachricht für CreateVehicle.

Felder
header

RequestHeader

Der Standard-Anfrageheader von Fleet Engine.

parent

string

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

vehicle_id

string

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

  • Muss ein gültiger Unicode-String sein.
  • Ist auf eine maximale Länge von 64 Zeichen beschränkt.
  • Nach der Unicode-Normalisierungsform C normalisiert.
  • Darf keines 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 sie angegeben werden.

DeviceSettings

Informationen zu verschiedenen Einstellungen auf dem Mobilgerät.

Felder
location_power_save_mode

LocationPowerSaveMode

Gibt an, wie sich die Standortfunktionen 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 das Gerät interaktiv ist.

battery_info

BatteryInfo

Informationen zum Akkustatus.

GetTripRequest

GetTrip-Anfragenachricht

Felder
header

RequestHeader

Der Standard-Anfrageheader von Fleet Engine.

name

string

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

view

TripView

Die Teilmenge der zu retournierenden Trip-Felder und ihre Interpretation.

current_route_segment_version

Timestamp

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

remaining_waypoints_version

Timestamp

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

route_format_type

PolylineFormatType

Das aktuelle Routenformat, das zurückgegeben wird: 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 Mindestzeitstempel (exklusiv) an, für den Trip.current_route_segment_traffic abgerufen wird. Wenn die Verkehrsdaten seit diesem Zeitstempel unverändert sind, wird das Feld current_route_segment_traffic in der Antwort nicht festgelegt. Wenn kein Minimum angegeben ist, werden die Besucherzahlen immer abgerufen. Traffic ist nur für Kunden der On-Demand Rides and Deliveries-Lösung verfügbar.

remaining_waypoints_route_version

Timestamp

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

GetVehicleRequest

Anfragenachricht für GetVehicle.

Felder
header

RequestHeader

Der Standard-Anfrageheader von Fleet Engine.

name

string

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

current_route_segment_version

Timestamp

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

waypoints_version

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.

LicensePlate

Die Nummernschildinformationen des Fahrzeugs. Um das Speichern personenidentifizierbarer Informationen zu vermeiden, werden nur die minimalen Informationen zum Kfz-Kennzeichen als Teil des Elements gespeichert.

Felder
country_code

string

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

last_character

string

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

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

ListVehiclesRequests

Anfragenachricht für ListVehicles.

Felder
header

RequestHeader

Der Standard-Anfrageheader von Fleet Engine.

parent

string

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

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, damit Sie Seiten mit Fahrzeuggruppen aufrufen können. Der Wert ist nicht definiert, wenn die Filterkriterien der Anfrage nicht mit den Filterkriterien für den vorherigen Aufruf von ListVehicles übereinstimmen.

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. Wenn festgelegt, muss der Wert größer oder gleich 0 sein.

trip_types[]

TripType

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

maximum_staleness

Duration

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

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

required_one_of_attributes[]

string

Die Antwort wird auf Fahrzeuge mit mindestens einem der angegebenen Attribute in jedem VehicleAttributeList beschränkt. In jeder Liste muss ein Fahrzeug mit mindestens einem der Attribute übereinstimmen. Dieses Feld ist eine inklusive Disjunktion/OR-Operation in jeder VehicleAttributeList und eine Konjunktion/AND-Operation für die 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 verwendet required_one_of_attribute_sets eine Nachricht, die eine Liste von Listen zulässt und Ausdrücke wie diese zulässt:

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

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

vehicle_state

VehicleState

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

on_trip_only

bool

Geben Sie nur die Fahrzeuge mit der/den aktuellen Fahrt(en) 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 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 fungiert als AND-Klausel mit anderen Einschränkungen wie vehicle_state oder on_trip_only.

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

Außerdem werden alle Attribute als Strings gespeichert. Daher sind nur Stringvergleiche zulässig. Damit ein Vergleich mit numerischen oder booleschen Werten möglich ist, müssen die Werte explizit in Anführungszeichen gesetzt werden, damit sie als Strings behandelt werden (z. B. attributes.<key> = "10" oder attributes.<key> = "true").

viewport

Viewport

Optional. Ein Filter, der die zurückgegebenen Fahrzeuge auf diejenigen beschränkt, deren letzter bekannter Standort sich im rechteckigen Bereich befindet, der durch den Darstellungsbereich definiert ist.

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 die Anfragekriterien erfüllen.

total_size

int64

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

LocationPowerSaveMode

Wie sich die Standortfunktionen auf dem Mobilgerät verhalten, wenn die Energiesparfunktion des Geräts aktiviert ist. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

Enums
UNKNOWN_LOCATION_POWER_SAVE_MODE Undefined LocationPowerSaveMode
LOCATION_MODE_NO_CHANGE Entweder sollten Standortanbieter vom Energiesparmodus nicht betroffen sein 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 LocationManager drosselt alle Anfragen an Anbieter, wenn das Gerät nicht interaktiv ist.

LocationSensor

Der Sensor oder die Methode, die zur Standortbestimmung verwendet wird.

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 WiFi-Zugangspunkt.
ROAD_SNAPPED_LOCATION_PROVIDER Ein Standort, der vom Mobilgerät als wahrscheinlichste Straßenposition bestimmt wird.
CUSTOMER_SUPPLIED_LOCATION Ein vom Kunden angegebener Standort aus einer unabhängigen Quelle. Normalerweise wird dieser Wert für einen Standort verwendet, der aus anderen Quellen als dem Mobilgerät mit Driver SDK bereitgestellt wird. Wenn die ursprüngliche Quelle durch einen der anderen Aufzählungswerte beschrieben wird, verwenden Sie diesen Wert. Standorte mit dem Attribut „CUSTOMER_SUPPLIED_LOCATION“ werden in der Regel über die last_location.supplemental_location_sensor eines Fahrzeugs angegeben.
FLEET_ENGINE_LOCATION Ein Standort, der von Fleet Engine anhand der verfügbaren Signale berechnet wird. Nur Ausgabe. Dieser Wert wird abgelehnt, wenn er in einer Anfrage enthalten ist.
FUSED_LOCATION_PROVIDER Der Anbieter für kombinierte Standortbestimmung von Android.
CORE_LOCATION Der Standortanbieter für Apple-Betriebssysteme.

Der Navigationsstatus des Fahrzeugs.

Enums
UNKNOWN_NAVIGATION_STATUS Nicht angegebener Navigationsstatus.
NO_GUIDANCE Die Navigation der Fahr-App befindet sich im Modus FREE_NAV.
ENROUTE_TO_DESTINATION Die detaillierte Routenführung ist verfügbar und die Navigation in der Fahrer App befindet sich im Modus GUIDED_NAV.
OFF_ROUTE Das Fahrzeug ist von der vorgeschlagenen Route abgekommen.
ARRIVED_AT_DESTINATION Das Fahrzeug ist nicht weiter als 50 m vom Ziel entfernt.

PolylineFormatType

Der Typ des Polylinienformats.

Enums
UNKNOWN_FORMAT_TYPE Das Format ist nicht angegeben oder unbekannt.
LAT_LNG_LIST_TYPE Eine Liste mit google.type.LatLng.
ENCODED_POLYLINE_TYPE Eine Polylinie, die mit einem Polylinienkomprimierungsalgorithmus codiert wurde. Das Dekodieren wird noch nicht unterstützt.

PowerSource

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

Enums
UNKNOWN_POWER_SOURCE Die Stromquelle ist unbekannt.
POWER_SOURCE_AC Die Stromquelle ist ein Wechselstromladegerät.
POWER_SOURCE_USB Stromversorgung über einen USB-Anschluss
POWER_SOURCE_WIRELESS Die Stromversorgung ist kabellos.
POWER_SOURCE_UNPLUGGED Der Akku ist nicht angeschlossen.

ReportBillableTripRequest

Anfragenachricht für ReportBillableTrip

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, das diesen Aufruf durchführt, gehört (z. B. sample-cloud-project).

country_code

string

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

platform

BillingPlatformIdentifier

Die Plattform, auf der die Anfrage gestellt wurde.

related_ids[]

string

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

solution_type

SolutionType

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

SolutionType

Auswahl für verschiedene Lösungstypen 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 ein On-Demand-Mitfahrdienst und Lieferdienst.

RequestHeader

Eine RequestHeader enthält Felder, die allen Fleet Engine-RPC-Anfragen gemeinsam sind.

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. Ist keiner angegeben, kann die Antwort in einer beliebigen Sprache erfolgen. Falls ein solcher Name vorhanden ist, wird Englisch bevorzugt. Beispiel für einen 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 SDKs (falls zutreffend). Das Versionsformat ist „major.minor.patch“, z. B. 1.1.2.

os_version

string

Version des Betriebssystems, auf dem das anrufende 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 Typ des SDKs, über das 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“, z. B. 5.2.1.

nav_sdk_version

string

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

platform

Platform

Plattform des aufrufenden SDKs.

manufacturer

string

Hersteller des Android-Geräts, von dem das SDK aufgerufen wird. Gilt nur für Android-SDKs. Beispiel für einen 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 zu Logging-Zwecken zur Identifizierung der Anfrage angegeben werden kann.

Plattform

Die Plattform des aufrufenden SDKs.

Enums
PLATFORM_UNSPECIFIED Der Standardwert. Dieser Wert wird verwendet, wenn die Plattform weggelassen wird.
ANDROID Die Anfrage stammt von Android.
IOS Die Anfrage stammt von iOS.
WEB Die Anfrage stammt 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 „Driver“.
JAVASCRIPT Das aufrufende SDK ist JavaScript.

SearchTripsRequests

Anfragenachricht für SearchTrips

Felder
header

RequestHeader

Der Standard-Anfrageheader von Fleet Engine.

parent

string

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

vehicle_id

string

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

  • current_route_segment
  • remaining_waypoints
  • remaining_distance_meters
  • eta_to_first_waypoint
active_trips_only

bool

Wenn dieser Wert 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 hier einen Wert fest, der zuvor in SearchTripsResponse zurückgegeben wurde, um gegenüber den vorherigen Ergebnissen fortzufahren.

minimum_staleness

Duration

Wenn angegeben, werden die Fahrten zurückgegeben, die nach dem Zeitpunkt (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 durch die Ergebnislisten zu blättern. Die API gibt bei jedem Aufruf eine Fahrtliste zurück. Wenn keine weiteren Ergebnisse verfügbar sind, ist die Fahrtliste leer.

SearchVehiclesRequests

Anfragenachricht für SearchVehicles.

Felder
header

RequestHeader

Der Standard-Anfrageheader von Fleet Engine.

parent

string

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

pickup_point

TerminalLocation

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

dropoff_point

TerminalLocation

Der vom Kunden beabsichtigte Abgabeort. 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 liegen.

count

int32

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

minimum_capacity

int32

Erforderlich. Gibt die Anzahl der Fahrgäste an, die für eine Fahrt in Betracht gezogen werden. Der Wert muss größer oder gleich 1 sein. Der Treiber wird im 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 können.

maximum_staleness

Duration

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

vehicle_types[]

VehicleType

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

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 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 ein Konjunktions-/AND-Vorgang. Es sind maximal 50 erforderliche Attribute zulässig. Dies entspricht der maximal zulässigen Anzahl von Attributen für ein Fahrzeug.

required_one_of_attributes[]

VehicleAttributeList

Die Suche wird auf Fahrzeuge mit mindestens einem der angegebenen Attribute in jeder VehicleAttributeList beschränkt. In jeder Liste muss ein Fahrzeug mit mindestens einem der Attribute übereinstimmen. Dieses Feld ist eine inklusive Disjunktion/OR-Operation in jeder VehicleAttributeList und eine Konjunktion/AND-Operation für die 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 bei required_one_of_attribute_sets eine Nachricht verwendet, die eine Liste von Listen zulässt. So sind Ausdrücke wie dieser möglich:

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

Beschränkt die Suche auf die Fahrzeuge mit allen Attributen in einem VehicleAttributeList. Innerhalb jeder Liste muss ein Fahrzeug mit allen Attributen übereinstimmen. Dieses Feld ist eine Konjunktion/AND-Operation in jedem VehicleAttributeList und eine inklusive Disjunktion/OR-Operation für die gesamte Sammlung von VehicleAttributeList.

order_by

VehicleMatchOrder

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

include_back_to_back

bool

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

Der Standardwert ist false.

trip_id

string

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

current_trips_present

CurrentTripsPresent

Gibt an, ob Fahrzeuge mit aktiven Fahrten für diese Suche infrage kommen. Dieser muss auf einen anderen Wert als CURRENT_TRIPS_PRESENT_UNSPECIFIED festgelegt sein, wenn trip_type SHARED enthält.

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.

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

Außerdem werden alle Attribute als Strings gespeichert. Daher sind nur Stringvergleiche zulässig. Damit ein Vergleich mit numerischen oder booleschen Werten möglich ist, müssen die Werte explizit in Anführungszeichen gesetzt werden, damit sie als Strings behandelt werden (z. B. attributes.<key> = "10" oder attributes.<key> = "true").

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 durch das 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 In den Suchergebnissen sind Fahrzeuge mit höchstens 5 aktuellen Fahrten und 10 Wegpunkten enthalten. Wenn dieser Wert verwendet wird, kann include_back_to_back nicht true sein.

VehicleMatchOrder

Gibt die Reihenfolge der Fahrzeugübereinstimmungen in der Antwort an.

Enums
UNKNOWN_VEHICLE_MATCH_ORDER Standardeinstellung, die für nicht angegebene oder nicht erkannte Übereinstimmungen verwendet wird.
PICKUP_POINT_ETA Aufsteigend nach der Fahrzeit des Fahrzeugs zum Abholpunkt.
PICKUP_POINT_DISTANCE Aufsteigende Reihenfolge nach Fahrstrecke des Fahrzeugs zum Abholpunkt.
DROPOFF_POINT_ETA Aufsteigende Reihenfolge nach Fahrzeit des Fahrzeugs bis zur Abgabestelle. Diese Bestellung kann nur verwendet werden, wenn der Abholpunkt in der Anfrage angegeben ist.
PICKUP_POINT_STRAIGHT_DISTANCE Aufsteigende Reihenfolge nach der Luftlinie zwischen dem letzten gemeldeten Standort des Fahrzeugs und dem Abholort.
COST Aufsteigend nach den konfigurierten Abgleichskosten. Die Abgleichskosten werden als gewichtete Berechnung zwischen der Luftlinie und der geschätzten Ankunftszeit definiert. Die Gewichte werden mit Standardwerten festgelegt und können pro 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 die SearchVehiclesRequest-Kriterien erfüllen, sortiert nach dem Feld SearchVehiclesRequest.order_by.

SpeedReadingInterval

Verkehrsdichteanzeige für ein zusammenhängendes Segment eines Pfads. Für einen Pfad mit den Punkten P_0, P_1, ..., P_N (Index beginnt bei 0) definiert das SpeedReadingInterval-Element ein Intervall und beschreibt den Traffic mit den folgenden Kategorien.

Felder
start_polyline_point_index

int32

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

end_polyline_point_index

int32

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

speed

Speed

Die Verkehrsgeschwindigkeit in diesem Intervall.

Geschwindigkeit

Klassifizierung der Polyliniengeschwindigkeit anhand von Verkehrsdaten.

Enums
SPEED_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
NORMAL Normale Geschwindigkeit. Es wird kein Stau erkannt.
SLOW Stau erkannt, aber kein Stau entstanden.
TRAFFIC_JAM Stau erkannt.

StopLocation

Der tatsächliche Ort, an dem eine Haltestelle (Ab-/Absetz) stattfand.

Felder
point

LatLng

Erforderlich. Gibt den tatsächlichen Standort an.

timestamp

Timestamp

Gibt an, wann die Haltestelle stattgefunden hat.

stop_time
(deprecated)

Timestamp

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

TerminalLocation

Beschreibt die Position eines Wegpunkts.

Felder
point

LatLng

Erforderlich. Gibt den Standort eines Wegpunkts an.

terminal_point_id
(deprecated)

TerminalPointId

Verworfen: Geben Sie stattdessen das Feld point an.

access_point_id
(deprecated)

string

Verworfen: Geben Sie stattdessen das Feld point an.

trip_id
(deprecated)

string

Verworfen.

terminal_location_type
(deprecated)

WaypointType

Inaktuell: Diese Daten sind in Vehicle.waypoint verfügbar.

TerminalPointId

Eingestellt: Terminalpunkte werden in der Fleet Engine nicht mehr unterstützt. Verwenden Sie stattdessen TerminalLocation.point.

Felder
value
(deprecated)

string

Verworfen.

Union-Feld Id. Verworfen. Für Id ist nur einer der folgenden Werte zulässig:
place_id
(deprecated)

string

Verworfen.

generated_id
(deprecated)

string

Verworfen.

TrafficPolylineData

Die Verkehrslage auf der voraussichtlichen Route wird genannt.

Felder
traffic_rendering

VisualTrafficReportPolylineRendering

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

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 der Kunde abgeholt wurde. In diesem Feld kann der Anbieter Feedback zu den tatsächlichen Abholinformationen geben.

actual_pickup_arrival_point

StopLocation

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

pickup_time

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.

intermediate_destinations[]

TerminalLocation

Zwischenhaltestellen, damit die Fahrtanfragen (zusätzlich zu Abhol- und Absetzvorgang) Für geteilte Fahrten wird dies anfangs nicht unterstützt.

intermediate_destinations_version

Timestamp

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

intermediate_destination_index

int32

Wenn TripStatus = ENROUTE_TO_INTERMEDIATE_DESTINATION ist, eine Zahl zwischen [0..N-1], die angibt, welches Zwischenziel das Fahrzeug als Nächstes passiert. Wenn TripStatus ARRIVED_AT_INTERMEDIATE_DESTINATION ist, eine Zahl zwischen [0–N–1], die angibt, an welchem Zwischenziel sich das Fahrzeug befindet. 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 Ankunftszeit und der tatsächliche Ort des Fahrers an einem Zwischenziel. In diesem Feld können 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 wo der Kunde von einem Zwischenziel abgeholt wurde. In diesem Feld kann der Anbieter Feedback zu tatsächlichen Abholinformationen an Zwischenzielen geben.

dropoff_point

TerminalLocation

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

actual_dropoff_point

StopLocation

Nur Eingabe. Die tatsächliche Zeit und der Ort, an dem und wo der Kunde ausstieg. In diesem Feld kann der Anbieter Feedback zu den tatsächlichen Abgabeinformationen geben.

dropoff_time

Timestamp

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

remaining_waypoints[]

TripWaypoint

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

vehicle_waypoints[]

TripWaypoint

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

route[]

LatLng

Nur Ausgabe. Voraussichtliche Route für diese Fahrt zum ersten Eintrag in „remaining_waypoints“. Beachten Sie, 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 vom Driver SDK und 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 das Driver SDK und das Consumer SDK vorgesehen.

current_route_segment_traffic

ConsumableTrafficPolyline

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

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

current_route_segment_traffic_version

Timestamp

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

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

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 wird nicht angegeben, wenn die Fahrt keinem Fahrzeug zugewiesen ist oder die Fahrt beendet oder gestrichen wurde.

eta_to_first_waypoint

Timestamp

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

remaining_time_to_first_waypoint

Duration

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

remaining_waypoints_version

Timestamp

Nur Ausgabe. Gibt an, wann 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 Clientanwendung sollte diesen Wert im Cache speichern und in GetTripRequest übergeben, damit die Pfade und Zugriffe für remaining_waypoints nur zurückgegeben werden, wenn sie aktualisiert wurden.

number_of_passengers

int32

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

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 die last_location des Fahrzeugs an „current_route_segment“ ausgerichtet werden kann. Falsch, wenn last_location oder current_route_segment nicht vorhanden ist. Er wird von Fleet Engine berechnet. Alle Aktualisierungen von Kunden werden ignoriert.

view

TripView

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

TripStatus

Der Status einer Fahrt, der den Fortschritt angibt.

Enums
UNKNOWN_TRIP_STATUS Standardeinstellung, die für einen nicht angegebenen oder nicht erkannten Fahrtstatus verwendet wird.
NEW Neu erstellte Reise.
ENROUTE_TO_PICKUP Der Fahrer ist auf dem Weg zur Abholstelle.
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 zum Zielort).
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 beendet.
CANCELED Die Fahrt wurde vor der Abholung vom Fahrer, Fahrgast oder Mitfahrdienstanbieter storniert.

TripType

Die Art der Fahrt.

Enums
UNKNOWN_TRIP_TYPE Standardeinstellung, die für nicht angegebene oder nicht erkannte Fahrttypen verwendet wird.
SHARED Das Fahrzeug wird möglicherweise für andere Fahrten genutzt.
EXCLUSIVE Die Fahrt ist nur für ein Fahrzeug möglich.

TripView

Auswahl für verschiedene Trip-Felder in einer GetTrip-Antwort. Weitere Informationen finden Sie unter AIP-157. Es ist wahrscheinlich, dass weitere Aufrufe hinzugefügt werden.

Enums
TRIP_VIEW_UNSPECIFIED Der Standardwert. Aus Gründen der Abwärtskompatibilität wird in der API standardmäßig eine SDK-Ansicht verwendet. Um Stabilität und Support zu gewährleisten, wird Kunden empfohlen, eine andere TripView als SDK auszuwählen.
SDK Enthält Felder, die mithilfe öffentlich verfügbarer Bibliotheken möglicherweise nicht interpretiert oder unterstützt werden können.
JOURNEY_SHARING_V1S Für den Anwendungsfall „Teilen von Reisen“ werden die Reisefelder ausgefüllt. Diese Ansicht ist für die Server-zu-Server-Kommunikation gedacht.

TripWaypoint

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

Felder
location

TerminalLocation

Der Standort dieses Wegpunkts.

trip_id

string

Die mit diesem Wegpunkt verknüpfte Fahrt.

waypoint_type

WaypointType

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

path_to_waypoint[]

LatLng

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

encoded_path_to_waypoint

string

Der codierte Pfad vom vorherigen zum aktuellen Wegpunkt.

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

traffic_to_waypoint

ConsumableTrafficPolyline

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

distance_meters

Int32Value

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

eta

Timestamp

Die geschätzte 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 Standard-Anfrageheader von Fleet Engine.

name

string

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

trip

Trip

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

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

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

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

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

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

update_mask

FieldMask

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

UpdateVehicleAttributesRequest

Anfragenachricht für UpdateVehicleAttributes.

Felder
header

RequestHeader

Der Standard-Anfrageheader von Fleet Engine.

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, das diesen Aufruf durchführt, gehört (z. B. sample-cloud-project).

attributes[]

VehicleAttribute

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

UpdateVehicleAttributesResponse

UpdateVehicleAttributes-Antwortnachricht.

Felder
attributes[]

VehicleAttribute

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

UpdateVehicleRequest

Anfragenachricht für UpdateVehicle

Felder
header

RequestHeader

Der Standard-Anfrageheader von Fleet Engine.

name

string

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

vehicle

Vehicle

Erforderlich. Die anzuwendenden Werte der Entität „Vehicle“. Beim Aktualisieren einer Vehicle werden die folgenden Felder möglicherweise nicht aktualisiert, da sie vom Server verwaltet werden.

  • available_capacity
  • current_route_segment_version
  • current_trips
  • name
  • waypoints_version

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

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

update_mask

FieldMask

Erforderlich. Eine Feldmaske, die angibt, welche Felder des Vehicle aktualisiert werden sollen. Es muss mindestens ein Feldname 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

Der Fahrzeugstatus.

supported_trip_types[]

TripType

Fahrttypen, die von diesem Fahrzeug unterstützt werden.

current_trips[]

string

Nur Ausgabe. Liste der 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 Fahrer wird bei diesem Wert nicht berücksichtigt. Dieser Wert muss größer oder gleich 1 sein.

attributes[]

VehicleAttribute

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

vehicle_type

VehicleType

Erforderlich. Der Typ dieses Fahrzeugs. Kann verwendet werden, um Fahrzeuge in SearchVehicles-Ergebnissen zu filtern. Wirkt sich auch auf die geschätzte Ankunftszeit und die Routenberechnung aus.

license_plate

LicensePlate

Kfz-Kennzeichen des Fahrzeugs.

route[]
(deprecated)

TerminalLocation

Eingestellt: Verwende stattdessen Vehicle.waypoints.

current_route_segment

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 das Driver SDK vorgesehen. Das Dekodieren wird noch nicht unterstützt.

current_route_segment_traffic

TrafficPolylineData

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

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

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

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

eta_to_first_waypoint

Timestamp

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

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

remaining_time_seconds

Int32Value

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

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

waypoints[]

TripWaypoint

Die verbleibenden Wegpunkte, die diesem Fahrzeug zugewiesen sind.

waypoints_version

Timestamp

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

back_to_back_enabled

bool

Gibt an, ob der Fahrer aufeinanderfolgende Fahrten akzeptiert. Wenn true, SearchVehicles das Fahrzeug auch dann enthalten kann, 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.

Fahrzeugtyp

Der Fahrzeugtyp.

Felder
category

Category

Fahrzeugtypkategorie

Kategorie

Fahrzeugtypkategorien

Enums
UNKNOWN Standardwert, der für nicht angegebene oder nicht erkannte Fahrzeugkategorien verwendet wird.
AUTO Ein Auto.
TAXI Alle Fahrzeuge, die als Taxi fungieren (in der Regel lizenziert oder gesetzlich reguliert).
TRUCK In der Regel ein Fahrzeug mit einer großen Speicherkapazität.
TWO_WHEELER Ein Motorrad, Moped oder ein anderes Fahrzeug mit zwei Rädern
BICYCLE Von Menschen betriebene Fortbewegungsmittel.
PEDESTRIAN Personen, die in der Regel gehen oder laufen und Fußgängerwege entlangfahren.

VehicleAttribute

Beschreibt ein Fahrzeugattribut als Schlüssel/Wert-Paar. Die Länge des Strings „Schlüssel:Wert“ darf 256 Zeichen nicht überschreiten.

Felder
key

string

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

value

string

Der Wert des Attributs.

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

string

Als String eingegebener Attributwert.

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

bool_value

bool

Boolescher Attributwert.

number_value

double

Doppelter Attributwert.

VehicleAttributeList

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

Felder
attributes[]

VehicleAttribute

Eine Liste der Attribute in dieser Sammlung.

VehicleLocation

Der Standort, die Geschwindigkeit und die Richtung eines Fahrzeugs zu einem bestimmten Zeitpunkt.

Felder
location

LatLng

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

horizontal_accuracy
(deprecated)

DoubleValue

Verworfen. Verwenden Sie stattdessen latlng_accuracy.

latlng_accuracy

DoubleValue

Genauigkeit von location in Metern als Radius.

heading

Int32Value

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

bearing_accuracy
(deprecated)

DoubleValue

Eingestellt: Verwende stattdessen heading_accuracy.

heading_accuracy

DoubleValue

Genauigkeit von heading in Grad.

altitude

DoubleValue

Höhe in Metern über WGS84.

vertical_accuracy
(deprecated)

DoubleValue

Verworfen. Verwenden Sie stattdessen altitude_accuracy.

altitude_accuracy

DoubleValue

Genauigkeit von altitude Metern.

speed_kmph
(deprecated)

Int32Value

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

speed

DoubleValue

Geschwindigkeit des Fahrzeugs in Metern/Sekunde

speed_accuracy

DoubleValue

Genauigkeit von speed in Metern pro Sekunde.

update_time

Timestamp

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

server_time

Timestamp

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

location_sensor

LocationSensor

Anbieter von Standortdaten, z. B. GPS.

is_road_snapped

BoolValue

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

num_stale_updates
(deprecated)

Int32Value

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

raw_location

LatLng

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

raw_location_time

Timestamp

Zeitstempel, der mit dem Rohstandort verknüpft ist.

raw_location_sensor

LocationSensor

Quelle des Rohstandorts. Die Standardeinstellung ist GPS.

raw_location_accuracy

DoubleValue

Radiusgenauigkeit von raw_location in Metern.

supplemental_location

LatLng

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

supplemental_location_time

Timestamp

Zeitstempel, der mit dem zusätzlichen Standort verknüpft 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: Verwende stattdessen is_road_snapped.

VehicleMatch

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

Felder
vehicle

Vehicle

Erforderlich. Ein Fahrzeug, das der Anfrage entspricht.

vehicle_pickup_eta

Timestamp

Die geschätzte Ankunftszeit des Fahrzeugs am in der Anfrage angegebenen Abholpunkt. Ein leerer Wert bedeutet, dass bei der Berechnung der voraussichtlichen Ankunftszeit für das Fahrzeug ein Fehler aufgetreten ist. Wenn SearchVehiclesRequest.include_back_to_back true war und dieses Fahrzeug eine aktive Fahrt hat, enthält vehicle_pickup_eta die Zeit, die für die aktuell aktive Fahrt erforderlich ist.

vehicle_pickup_distance_meters

Int32Value

Die Entfernung vom aktuellen Standort des Fahrzeugs bis zum in der Anfrage angegebenen Abholort, einschließlich aller Zwischen- oder Absetzpunkte für bestehende Fahrten. Diese Entfernung umfasst die berechnete Fahrstrecke (Route) sowie die Entfernung in gerader Linie zwischen dem Navigationsendpunkt und dem angeforderten Abholort. (Der Abstand zwischen dem Navigationsendpunkt und dem angeforderten Abholpunkt ist in der Regel gering.) Ein leerer Wert weist auf einen Fehler bei der Berechnung der Entfernung hin.

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 geschätzte Ankunftszeit des gesamten Fahrzeugs am in der Anfrage angegebenen Zielort. Die ETA umfasst auch das Anhalten an Wegpunkten vor der in der Anfrage angegebenen dropoff_point. Der Wert wird nur ausgefüllt, wenn in der Anfrage ein Rückgabepunkt angegeben ist. Ein leerer Wert weist auf einen Fehler bei der Berechnung der voraussichtlichen Ankunftszeit hin.

vehicle_pickup_to_dropoff_distance_meters

Int32Value

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

trip_type

TripType

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

vehicle_trips_waypoints[]

Waypoint

Die sortierte Liste von Wegpunkten, die zur Berechnung 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 bedeutet, dass bei der Berechnung der voraussichtlichen Ankunftszeit für das Fahrzeug ein Fehler aufgetreten ist.

vehicle_match_type

VehicleMatchType

Der passende Fahrzeugtyp.

requested_ordered_by

VehicleMatchOrder

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

ordered_by

VehicleMatchOrder

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

VehicleMatchType

Art der Fahrzeugübereinstimmung.

Enums
UNKNOWN Unbekannter Übereinstimmungstyp für Fahrzeuge
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 voraussichtlichen Ankunftszeit und der Entfernung wird die vorhandene Fahrt berücksichtigt.
CARPOOL Das Fahrzeug hat genügend Kapazität für eine gemeinsam genutzte Fahrt.
CARPOOL_BACK_TO_BACK Das Fahrzeug beendet seine aktuelle, aktive Fahrt, bevor es zur Abholstelle weiterfährt. Bei der Berechnung der geschätzten Ankunftszeit und der Entfernung wird die aktuelle Fahrt berücksichtigt.

VehicleState

Der Status einer Vehicle.

Enums
UNKNOWN_VEHICLE_STATE Standardeinstellung, die für nicht angegebene oder nicht erkannte Fahrzeugstatus verwendet wird.
OFFLINE Das Fahrzeug akzeptiert keine neuen Fahrten. Hinweis: Das Fahrzeug kann in diesem Status weiter betrieben werden, während es eine ihm zugewiesene Fahrt durchführt.
ONLINE Das Fahrzeug nimmt neue Fahrten an.

VisualTrafficReportPolylineRendering

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

Felder
road_stretch[]

RoadStretch

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

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

RoadStretch

Eine Straßenstrecke, die gerendert werden soll.

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 die 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 ein VehicleMatch in einem SearchVehiclesResponse. Dieses Konzept wird in allen anderen Endpunkten als TripWaypoint dargestellt.

Felder
lat_lng

LatLng

Der Standort dieses Wegpunkts.

eta

Timestamp

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

WaypointType

Der Typ des Wegpunkts.

Enums
UNKNOWN_WAYPOINT_TYPE Wegpunkttyp unbekannt oder nicht angegeben
PICKUP_WAYPOINT_TYPE Wegpunkte für die Abholung von Fahrgästen oder Artikeln.
DROP_OFF_WAYPOINT_TYPE Wegpunkte für das Absetzen von Fahrgästen oder Gegenständen.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Wegpunkte für Zwischenziele bei einer Fahrt mit mehreren Zielen.