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

Fahrzeugverwaltung.

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

Instanziiert ein neues Fahrzeug, das mit einem On-Demand-Mitfahrdienst oder Lieferdienst 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, sofern sie angegeben werden.

GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

Gibt ein Fahrzeug von 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 von Fahrzeugen zurück, die den Anfrageoptionen entsprechen.

UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

Schreibt aktualisierte Fahrzeugdaten in die Fleet Engine.

Beim Aktualisieren eines 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, 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 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 nicht in dieser Liste aufgeführt sind.

ConsumableTrafficPolyline

Verkehrsdichte auf der Strecke eines Fahrzeugs

Felder
speed_reading_interval[]

SpeedReadingInterval

Verkehrsgeschwindigkeit auf dem Weg vom vorherigen bis zum aktuellen Wegpunkt.

encoded_path_to_waypoint

string

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

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

trip_id

string

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

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

Trip

Erforderlich. Zu erstellende Fahrtentität

Beim Erstellen einer Reise sind folgende Felder erforderlich:

  • trip_type
  • pickup_point

Die folgenden Felder werden verwendet, wenn Sie sie angeben:

  • number_of_passengers
  • vehicle_id
  • dropoff_point
  • intermediate_destinations
  • vehicle_waypoints

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

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

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

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

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

CreateVehicleRequest

Anfragenachricht für CreateVehicle.

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

vehicle_id

string

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

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

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

view

TripView

Die Teilmenge der Trip-Felder, die zurückgegeben werden sollen, 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 remaining_waypoints nicht in der Antwort festgelegt. Wenn dieses Feld nicht angegeben ist, wird immer remaining_waypoints abgerufen.

route_format_type

PolylineFormatType

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

current_route_segment_traffic_version

Timestamp

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

remaining_waypoints_route_version

Timestamp

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

GetVehicleRequest

Anfragenachricht für GetVehicle.

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

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 current_route_segment immer abgerufen.

waypoints_version

Timestamp

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

LicensePlate

Die Nummernschildinformationen des Fahrzeugs. Damit keine personenidentifizierbaren Informationen gespeichert werden, werden nur die Mindestinformationen zum Kfz-Kennzeichen als Teil des Rechtssubjekts 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 Nummernschilds oder „-1“ an, dass kein numerischer Wert im Kfz-Kennzeichen vorhanden ist.

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

ListVehiclesRequest

Anfragenachricht für ListVehicles.

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

page_size

int32

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

page_token

string

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

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

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 Standortupdates an Fleet Engine gesendet haben. Stehende Fahrzeuge, die noch ihren Standort übermitteln, gelten nicht als veraltet. Falls vorhanden, muss die Dauer eine gültige positive Dauer sein.

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

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

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

Beschränkt die Antwort auf Fahrzeuge mit den angegebenen Attributen. Dieses Feld ist eine Konjunktion/AND-Operation. Es sind maximal 50 erforderliche Attribute zulässig. Dies entspricht der maximal für ein Fahrzeug zulässigen Anzahl von Attributen. Jeder wiederholte String muss das Format „key:value“ haben.

required_one_of_attributes[]

string

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

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. In jeder Liste muss ein Fahrzeug mit allen Attributen übereinstimmen. Dieses Feld ist eine Konjunktion/AND-Operation in jeder VehicleAttributeList- und inklusiven Disjunktions-/ODER-Operation innerhalb der Sammlung von VehicleAttributeList. Jeder wiederholte String muss das Format „key1:value1|key2:value2|key3:value3“ haben.

vehicle_state

VehicleState

Beschränkt die Antwort auf Fahrzeuge mit diesem Fahrzeugstatus.

on_trip_only

bool

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

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

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

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

viewport

Viewport

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

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 oder leer, wenn es keine weiteren Fahrzeuge gibt, die die Anfragekriterien erfüllen.

total_size

int64

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

LocationPowerSaveMode

Wie Standortfunktionen so konfiguriert sind, dass sie sich auf dem Mobilgerät verhalten, wenn das Gerät im Energiesparmodus ist ist aktiviert. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

Enums
UNKNOWN_LOCATION_POWER_SAVE_MODE Nicht definierter StandortEnergiesparmodus
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, mit der der Standort ermittelt wurde.

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 die 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 von 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 abgelehnt, wenn er in einer Anfrage enthalten ist.
FUSED_LOCATION_PROVIDER Fused Location Provider von Android.
CORE_LOCATION Der Standortanbieter für Apple-Betriebssysteme.

Der Navigationsstatus des Fahrzeugs.

Enums
UNKNOWN_NAVIGATION_STATUS Unbekannter Navigationsstatus.
NO_GUIDANCE Die Navigation in der Fahrer-App ist im FREE_NAV-Modus.
ENROUTE_TO_DESTINATION Die Schritt-für-Schritt-Navigation ist verfügbar und die Navigation in der Fahrer-App hat den GUIDED_NAV-Modus erreicht.
OFF_ROUTE Das Fahrzeug ist nicht mehr auf der vorgeschlagenen Route gefahren.
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 Mit einem Polylinien-Komprimierungsalgorithmus codierte Polylinie. Die Decodierung 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 Die Stromquelle ist ein USB-Anschluss.
POWER_SOURCE_WIRELESS Die Stromquelle ist kabellos.
POWER_SOURCE_UNPLUGGED Akku ist ausgesteckt.

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, über die das Ersuchen gesendet 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 begrenzt.

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

Ein RequestHeader enthält Felder, die für alle Fleet Engine-RPC-Anfragen gelten.

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 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 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, der die Anfrage sendet.

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ängig ist (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 aus dem aufrufenden 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 zu Protokollierungszwecken angegeben werden kann, um die Anfrage zu identifizieren.

Plattform

Die Plattform des aufrufenden SDK.

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 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 Driver.
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, 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 nicht angegeben, 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.

SearchVehiclesRequest

Anfragenachricht für SearchVehicles.

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

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 (einschließlich) liegen.

count

int32

Erforderlich. Gibt die maximale Anzahl der zurückzugebenden Fahrzeuge an. Der Wert muss zwischen 1 und 50 (einschließlich) 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 eins 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. Beschränkt die Suche auf Fahrzeuge mit einem der angegebenen Typen. Es muss mindestens ein Fahrzeugtyp angegeben werden. Fahrzeugtypen der Kategorie UNKNOWN sind nicht zulässig.

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

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

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

Beschränkt die Suche auf Fahrzeuge mit den angegebenen Attributen. Dieses Feld ist eine Konjunktion/AND-Operation. Es sind maximal 50 erforderliche Attribute zulässig. Dies entspricht der maximal für ein Fahrzeug zulässigen Anzahl von Attributen.

required_one_of_attributes[]

VehicleAttributeList

Beschränkt die Suche auf die Fahrzeuge mit mindestens einem der angegebenen Attribute in jeder VehicleAttributeList. In jeder Liste muss ein Fahrzeug mit mindestens einem der Attribute übereinstimmen. Dieses Feld ist eine inklusive Disjunktion/OR-Operation in jeder VehicleAttributeList und eine Konjunktion/AND-Operation für die Sammlung von VehicleAttributeList.

required_one_of_attribute_sets[]

VehicleAttributeList

required_one_of_attribute_sets bietet zusätzliche Funktionen.

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

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

Beschränkt die Suche auf die Fahrzeuge mit allen Attributen in einem VehicleAttributeList. In jeder Liste muss ein Fahrzeug mit allen Attributen übereinstimmen. Dieses Feld ist eine Konjunktion/AND-Operation in jeder VehicleAttributeList- und inklusiven Disjunktions-/ODER-Operation innerhalb der Sammlung von VehicleAttributeList.

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 „true“ festgelegt 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. Wenn trip_type SHARED enthält, muss hier ein anderer Wert als CURRENT_TRIPS_PRESENT_UNSPECIFIED festgelegt werden.

filter

string

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

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

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

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

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

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, darf 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, darf include_back_to_back nicht true sein.

VehicleMatchOrder

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

Enums
UNKNOWN_VEHICLE_MATCH_ORDER Standardeinstellung; wird für die Reihenfolge von nicht angegebenen oder nicht erkannten Fahrzeugübereinstimmungen verwendet.
PICKUP_POINT_ETA Aufsteigende Reihenfolge nach Fahrzeit des Fahrzeugs zum Abholpunkt.
PICKUP_POINT_DISTANCE Aufsteigende Reihenfolge nach Entfernung des Fahrzeugs zum Abholort.
DROPOFF_POINT_ETA Aufsteigende Reihenfolge nach Fahrzeit des Fahrzeugs bis zur Abgabestelle. Diese Reihenfolge kann nur verwendet werden, wenn in der Anfrage die Abgabestelle angegeben ist.
PICKUP_POINT_STRAIGHT_DISTANCE Aufsteigende Reihenfolge nach der Luftlinie zwischen dem letzten gemeldeten Standort des Fahrzeugs und dem Abholort.
COST Aufsteigende Reihenfolge nach den konfigurierten Übereinstimmungskosten. Die Angleichungskosten sind definiert als gewichtete Berechnung zwischen der direkten Entfernung und der voraussichtlichen Ankunftszeit. 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 die SearchVehiclesRequest-Kriterien erfüllen, sortiert nach dem Feld SearchVehiclesRequest.order_by.

SpeedReadingInterval

Verkehrsdichteanzeige für ein zusammenhängendes Segment eines Pfads. Bei einem Pfad mit den Punkten P_0, P_1, ... , P_N (nullbasierter Index) definiert SpeedReadingInterval ein Intervall und beschreibt seinen Traffic anhand der folgenden Kategorien.

Felder
start_polyline_point_index

int32

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

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

Verkehrsgeschwindigkeit in diesem Intervall.

Geschwindigkeit

Die Klassifizierung der Polyliniengeschwindigkeit auf Grundlage 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

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

TerminalPointId

Verworfen: TerminalPoints werden in 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 und wo 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 Zeit und der Standort der Ankunft des Fahrers am Abholpunkt. In diesem Feld können Dienstleister Feedback zur tatsächlichen Ankunft am Abholpunkt geben.

pickup_time

Timestamp

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

intermediate_destinations[]

TerminalLocation

Zwischenstopps, damit die Fahrt angefordert wird (zusätzlich zu Start- und Zielhaltestellen). 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 den Wert ENROUTE_TO_INTERMEDIATE_DESTINATION hat, ist eine Zahl zwischen [0–N–1] angegeben, die angibt, welches Zwischenziel das Fahrzeug als Nächstes überquert. Wenn TripStatus ARRIVED_AT_INTERMEDIATE_DESTINATION ist, eine Zahl zwischen [0–N–1], die angibt, an welchem Zwischenziel sich das Fahrzeug befindet. Der Anbieter legt diesen Wert fest. Wenn keine intermediate_destinations vorhanden sind, wird dieses Feld ignoriert.

actual_intermediate_destination_arrival_points[]

StopLocation

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

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

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

actual_dropoff_point

StopLocation

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

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

route[]

LatLng

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

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 die Verwendung vom Driver SDK und 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 die Verwendung vom Driver SDK und 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 vom Driver SDK und 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 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 die Fahrt inaktiv ist (abgeschlossen oder gestrichen).

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, um sicherzustellen, dass 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 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. Aktualisierungen von Clients werden ignoriert.

view

TripView

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

TripStatus

Der Status einer Fahrt, der den Verlauf 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 Absetzpunkt).
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 gestrichen.

TripType

Die Art einer Fahrt.

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

TripView

Auswahl für verschiedene Gruppen von Trip-Feldern 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 verwendet die API standardmäßig eine SDK-Ansicht. Um Stabilität und Support zu gewährleisten, wird Kunden empfohlen, eine andere TripView als SDK auszuwählen.
SDK Umfasst Felder, die in öffentlich verfügbaren Bibliotheken möglicherweise nicht interpretiert oder nicht 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 vorgesehen.

TripWaypoint

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

Felder
location

TerminalLocation

Die Position dieses Wegpunkts.

trip_id

string

Die diesem Wegpunkt zugeordnete Fahrt.

waypoint_type

WaypointType

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

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 Wegpunkt zum aktuellen Wegpunkt.

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

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 Pfadentfernung vom vorherigen Wegpunkt zum aktuellen Wegpunkt. Nicht definiert für den ersten Wegpunkt in einer Liste.

eta

Timestamp

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

duration

Duration

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

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

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 anderen Fahrten verschränken. Die Felder trip_id, waypoint_type und location werden verwendet. Alle anderen TripWaypoint-Felder in vehicle_waypoints werden ignoriert.

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

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 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, das diesen Aufruf durchführt, gehört (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 Liste der Fahrzeugattribute, einschließlich neuer, geänderter und nicht bearbeiteter Attribute.

UpdateVehicleRequest

`UpdateVehicle request message.

Felder
header

RequestHeader

Der standardmäßige Fleet Engine-Anfrageheader.

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 Vehicle-Entitätswerte. Beim Aktualisieren eines Vehicle werden die folgenden Felder möglicherweise nicht aktualisiert, da sie vom Server verwaltet werden.

  • available_capacity
  • current_route_segment_version
  • current_trips
  • name
  • waypoints_version

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

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

update_mask

FieldMask

Erforderlich. Eine Feldmaske, die angibt, welche Felder der 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

Von diesem Fahrzeug unterstützte Fahrttypen.

current_trips[]

string

Nur Ausgabe. Liste von trip_id für Fahrten, die diesem Fahrzeug aktuell 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 und jedes Attribut muss einen eindeutigen Schlüssel haben.

vehicle_type

VehicleType

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

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 die Verwendung vom Treiber-SDK vorgesehen. Die Decodierung wird noch nicht unterstützt.

current_route_segment_traffic

TrafficPolylineData

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

current_route_segment_version

Timestamp

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

current_route_segment_end_point

TripWaypoint

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

remaining_distance_meters

Int32Value

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

eta_to_first_waypoint

Timestamp

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

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

remaining_time_seconds

Int32Value

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

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

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

back_to_back_enabled

bool

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

navigation_status

NavigationStatus

Der Navigationsstatus des Fahrzeugs.

device_settings

DeviceSettings

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

VehicleType

Der Fahrzeugtyp.

Felder
category

Category

Fahrzeugtypkategorie

Kategorie

Fahrzeugtypkategorien

Enums
UNKNOWN Standardeinstellung; wird für nicht angegebene oder nicht erkannte Fahrzeugkategorien verwendet.
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 Transportmittel
PEDESTRIAN Personen, die in der Regel gehen oder laufen und Fußgängerwege entlangfahren.

VehicleAttribute

Beschreibt ein Fahrzeugattribut als Schlüssel/Wert-Paar. Das Schlüssel/Wert-Paar String 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 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 den 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. Bei der Übermittlung an Fleet Engine ist der Standort des Fahrzeugs ein GPS-Standort. Wenn Sie ihn als Antwort erhalten, kann der Standort des Fahrzeugs entweder ein GPS-Standort, ein zusätzlicher Standort oder ein anderer ungefährer Standort sein. Die Quelle wird in location_sensor angegeben.

horizontal_accuracy
(deprecated)

DoubleValue

Eingestellt: Verwende 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

Eingestellt: Verwende stattdessen altitude_accuracy.

altitude_accuracy

DoubleValue

Genauigkeit von altitude in Metern.

speed_kmph
(deprecated)

Int32Value

Geschwindigkeit des Fahrzeugs in Kilometern pro Stunde. Eingestellt: Verwende 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. 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 eine Straße ausgerichtet 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 dieser Wert null. Ist die Zeit unbekannt, z. B. beim Neustart der App, wird dieser Wert auf null zurückgesetzt.

num_stale_updates
(deprecated)

Int32Value

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

raw_location

LatLng

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

raw_location_time

Timestamp

Zeitstempel, der dem unformatierten Standort zugeordnet ist.

raw_location_sensor

LocationSensor

Quelle des unformatierten Standorts. Die Standardeinstellung ist GPS.

raw_location_accuracy

DoubleValue

Radiusgenauigkeit von raw_location in Metern.

supplemental_location

LatLng

Zusätzlicher Standort, der von der integrierenden 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

Radiusgenauigkeit von supplemental_location 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

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

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. Sie setzt sich aus der berechneten Fahrtstrecke (Routenstrecke) plus der Luftlinienentfernung zwischen dem Navigationsendpunkt und dem angeforderten Startpunkt zusammen. (Der Abstand zwischen dem Navigationsendpunkt und dem angeforderten Abholpunkt ist in der Regel gering.) Ein leerer Wert weist auf einen Fehler bei der Berechnung der Entfernung hin.

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

vehicle_pickup_to_dropoff_distance_meters

Int32Value

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

trip_type

TripType

Erforderlich. Die Art der Fahrt, die zur Berechnung der voraussichtlichen Ankunftszeit für den 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 Abholpunkte aktiver Fahrten für das Fahrzeug und die in der Anfrage angegebenen Abholpunkte. Eine leere Liste bedeutet, dass bei der Berechnung der voraussichtlichen Ankunftszeit für das Fahrzeug ein Fehler aufgetreten ist.

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 Wert aus der Anfrage. Unter bestimmten Umständen, z. B. bei einem internen Serverfehler, kann jedoch eine andere Methode verwendet werden (z. B. PICKUP_POINT_STRAIGHT_DISTANCE).

VehicleMatchType

Fahrzeugtyp stimmt überein.

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 voraussichtlichen Ankunftszeit und der Entfernung wird die vorhandene Fahrt berücksichtigt.

VehicleState

Der Status eines 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 weiterhin betrieben werden, während eine ihm zugewiesene Fahrt abgeschlossen wird.
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. Streckenabschnitte überschneiden sich garantiert nicht und decken nicht unbedingt die gesamte Route ab.

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

RoadStretch

Ein Straßenabschnitt, der 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 an allen anderen Endpunkten als TripWaypoint dargestellt.

Felder
lat_lng

LatLng

Die Position dieses Wegpunkts.

eta

Timestamp

Die geschätzte Ankunftszeit des Fahrzeugs an diesem Wegpunkt.

WaypointType

Der Typ des Wegpunkts.

Enums
UNKNOWN_WAYPOINT_TYPE Wegpunkttyp unbekannt oder nicht angegeben
PICKUP_WAYPOINT_TYPE Wegpunkte zum Abholen von Fahrgästen oder Gegenständen.
DROP_OFF_WAYPOINT_TYPE Wegpunkte zum Abstellen von Fahrern oder Gegenständen
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Wegpunkte für Zwischenziele bei einer Fahrt mit mehreren Zielen.