Package google.maps.routing.v2

Index

Routen

Routes API

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Nimmt eine Liste von Start- und Zielorten entgegen und gibt einen Stream mit Routeninformationen für jede Kombination aus Start- und Zielort zurück.

HINWEIS:Bei dieser Methode müssen Sie in der Eingabe eine Antwortfeldmaske angeben. Sie können die Antwortfeldmaske mit dem URL-Parameter $fields oder fields oder mit dem HTTP-/gRPC-Header X-Goog-FieldMask angeben (siehe Verfügbare URL-Parameter und ‑Header). Der Wert ist eine durch Kommas getrennte Liste von Feldpfaden. In dieser ausführlichen Dokumentation erfahren Sie, wie Sie Feldpfade erstellen.

Beispiel für diese Methode:

  • Feldmaske aller verfügbaren Felder (für manuelle Prüfung): X-Goog-FieldMask: *
  • Feldmaske für Routendauer, -abstände, -status, -zustand und -indizes (Beispiel für eine Produktionskonfiguration): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

Es ist wichtig, dass Sie status in Ihre Feldmaske aufnehmen, da andernfalls alle Nachrichten als in Ordnung angezeigt werden. Google rät von der Verwendung des Platzhalters (*) in der Antwortfeldmaske ab, da:

  • Wenn Sie nur die benötigten Felder auswählen, kann unser Server Rechenzyklen einsparen. So können wir Ihnen das Ergebnis mit einer geringeren Latenz zurückgeben.
  • Wenn Sie nur die Felder auswählen, die Sie in Ihrem Produktionsjob benötigen, ist die Latenzleistung stabil. Wir werden möglicherweise in Zukunft weitere Antwortfelder hinzufügen. Diese neuen Felder erfordern möglicherweise zusätzliche Rechenzeit. Wenn Sie alle Felder oder alle Felder auf oberster Ebene auswählen, kann es zu Leistungseinbußen kommen, da jedes neue Feld, das wir hinzufügen, automatisch in die Antwort aufgenommen wird.
  • Wenn Sie nur die benötigten Felder auswählen, ist die Antwort kleiner und der Netzwerkdurchsatz höher.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Gibt die Hauptroute sowie optionale alternative Routen zurück, wenn eine Reihe von End- und Zwischenpunkten angegeben wird.

HINWEIS:Bei dieser Methode müssen Sie in der Eingabe eine Antwortfeldmaske angeben. Sie können die Antwortfeldmaske mit dem URL-Parameter $fields oder fields oder mit einem HTTP-/gRPC-Header X-Goog-FieldMask angeben (siehe Verfügbare URL-Parameter und ‑Header). Der Wert ist eine durch Kommas getrennte Liste von Feldpfaden. Ausführliche Informationen zum Erstellen von Feldpfaden

Beispiel für diese Methode:

  • Feldmaske aller verfügbaren Felder (für manuelle Prüfung): X-Goog-FieldMask: *
  • Feldmaske für Dauer, Entfernung und Polylinie auf Routenebene (Beispiel für eine Produktionskonfiguration): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google rät davon ab, die Antwortfeldmaske mit dem Platzhalter (*) oder die Angabe der Feldmaske auf oberster Ebene (routes) zu verwenden. Das hat folgende Gründe:

  • Wenn Sie nur die benötigten Felder auswählen, kann unser Server Rechenzyklen einsparen. So können wir Ihnen das Ergebnis mit einer geringeren Latenz zurückgeben.
  • Wenn Sie nur die Felder auswählen, die Sie in Ihrem Produktionsjob benötigen, ist die Latenzleistung stabil. Wir werden möglicherweise in Zukunft weitere Antwortfelder hinzufügen. Diese neuen Felder erfordern möglicherweise zusätzliche Rechenzeit. Wenn Sie alle Felder oder alle Felder auf oberster Ebene auswählen, kann es zu Leistungseinbußen kommen, da jedes neue Feld, das wir hinzufügen, automatisch in die Antwort aufgenommen wird.
  • Wenn Sie nur die benötigten Felder auswählen, ist die Antwort kleiner und der Netzwerkdurchsatz höher.

ComputeRouteMatrixRequest

ComputeRouteMatrix-Anfragenachricht

Felder
origins[]

RouteMatrixOrigin

Erforderlich. Array mit Ursprüngen, das die Zeilen der Antwortmatrix bestimmt. Für die Kardinalität von Start- und Zielorten gelten mehrere Größenbeschränkungen:

  • Die Summe der Anzahl der Start- und Zielorte, die als place_id oder address angegeben sind, darf 50 nicht überschreiten.
  • Das Produkt aus der Anzahl der Start- und Zielorte darf auf keinen Fall größer als 625 sein.
  • Das Produkt aus der Anzahl der Start- und Zielorte darf 100 nicht überschreiten, wenn „routing_preference“ auf TRAFFIC_AWARE_OPTIMAL festgelegt ist.
  • Das Produkt aus der Anzahl der Start- und Zielorte darf 100 nicht überschreiten, wenn „travel_mode“ auf TRANSIT festgelegt ist.
destinations[]

RouteMatrixDestination

Erforderlich. Array mit Zielen, das die Spalten der Antwortmatrix bestimmt.
travel_mode

RouteTravelMode

Optional. Gibt die Mobilitätsform an.
routing_preference

RoutingPreference

Optional. Gibt an, wie die Route berechnet werden soll. Der Server versucht, die Route anhand der ausgewählten Routing-Einstellung zu berechnen. Wenn die Routing-Einstellung zu einem Fehler oder zu einer besonders langen Latenz führt, wird ein Fehler zurückgegeben. Diese Option kann nur angegeben werden, wenn travel_mode den Wert DRIVE oder TWO_WHEELER hat. Andernfalls schlägt die Anfrage fehl.
departure_time

Timestamp

Optional. Die Abfahrtszeit. Wenn Sie diesen Wert nicht festlegen, wird standardmäßig die Uhrzeit festgelegt, zu der Sie die Anfrage gesendet haben. HINWEIS: Sie können nur dann ein departure_time in der Vergangenheit angeben, wenn RouteTravelMode auf TRANSIT gesetzt ist.
arrival_time

Timestamp

Optional. Die Ankunftszeit. HINWEIS: Kann nur festgelegt werden, wenn RouteTravelMode auf TRANSIT gesetzt ist. Sie können entweder departure_time oder arrival_time angeben, aber nicht beide.
language_code

string

Optional. Der BCP-47-Sprachcode, z. B. "en-US" oder "sr-Latn" Weitere Informationen finden Sie unter Unicode-Sprachkennzeichnung. Eine Liste der unterstützten Sprachen finden Sie unter Sprachunterstützung. Wenn Sie diesen Wert nicht angeben, wird die Anzeigesprache aus dem Standort des ersten Ursprungs abgeleitet.
region_code

string

Optional. Der Regionscode, angegeben als zweistelliger Ländercode der Top-Level-Domain (ccTLD). Weitere Informationen finden Sie unter Top-Level-Domains mit Landeskennzeichen.
units

Units

Optional. Gibt die Maßeinheiten für die Anzeigefelder an.
extra_computations[]

ExtraComputation

Optional. Eine Liste zusätzlicher Berechnungen, die zum Ausführen der Anfrage verwendet werden können. Hinweis: Diese zusätzlichen Berechnungen können zusätzliche Felder in der Antwort zurückgeben. Diese zusätzlichen Felder müssen auch in der Feldmaske angegeben werden, die in der Antwort zurückgegeben werden soll.
traffic_model

TrafficModel

Optional. Gibt die Annahmen an, die bei der Berechnung der Reisezeit verwendet werden sollen. Diese Einstellung wirkt sich auf den Wert für die voraussichtliche Reisezeit aus, der in der Antwort im Feld „duration“ (Dauer) zurückgegeben und anhand bisheriger Durchschnittswerte berechnet wird.RouteMatrixElement RoutingPreference nach TRAFFIC_AWARE_OPTIMAL und RouteTravelMode nach DRIVE. Der Standardwert ist BEST_GUESS, wenn der Traffic angefordert und TrafficModel nicht angegeben wurde.
transit_preferences

TransitPreferences

Optional. Gibt Einstellungen an, die die für TRANSIT-Routen zurückgegebene Route beeinflussen. HINWEIS: Sie können nur dann eine transit_preferences angeben, wenn RouteTravelMode auf TRANSIT gesetzt ist.

ExtraComputation

Zusätzliche Berechnungen, die beim Ausführen der Anfrage ausgeführt werden.

Enums
EXTRA_COMPUTATION_UNSPECIFIED Nicht verwendet. Anfragen mit diesem Wert schlagen fehl.
TOLLS Informationen zu Maut für die Matrixelemente.

ComputeRoutesRequest

ComputeRoutes-Anfrage

Felder
origin

Waypoint

Erforderlich. Startpunkt.
destination

Waypoint

Erforderlich. Ziel-Wegpunkt
intermediates[]

Waypoint

Optional. Eine Reihe von Wegpunkten entlang der Route (ohne Endpunkte), an denen angehalten oder vorbeigefahren werden soll. Es werden bis zu 25 Wegpunkte unterstützt.
travel_mode

RouteTravelMode

Optional. Gibt die Mobilitätsform an.
routing_preference

RoutingPreference

Optional. Gibt an, wie die Route berechnet werden soll. Der Server versucht, die Route anhand der ausgewählten Routing-Einstellung zu berechnen. Wenn die Routing-Einstellung zu einem Fehler oder zu einer besonders langen Latenz führt, wird ein Fehler zurückgegeben. Diese Option kann nur angegeben werden, wenn travel_mode den Wert DRIVE oder TWO_WHEELER hat. Andernfalls schlägt die Anfrage fehl.
polyline_quality

PolylineQuality

Optional. Gibt die gewünschte Qualität der Polylinie an.
polyline_encoding

PolylineEncoding

Optional. Gibt die bevorzugte Codierung für die Polylinie an.
departure_time

Timestamp

Optional. Die Abfahrtszeit. Wenn Sie diesen Wert nicht festlegen, wird standardmäßig die Uhrzeit festgelegt, zu der Sie die Anfrage gesendet haben. HINWEIS: Sie können nur dann ein departure_time in der Vergangenheit angeben, wenn RouteTravelMode auf TRANSIT gesetzt ist. Fahrten mit öffentlichen Verkehrsmitteln sind bis zu 7 Tage in der Vergangenheit oder 100 Tage in der Zukunft verfügbar.
arrival_time

Timestamp

Optional. Die Ankunftszeit. HINWEIS: Kann nur festgelegt werden, wenn RouteTravelMode auf TRANSIT gesetzt ist. Sie können entweder departure_time oder arrival_time angeben, aber nicht beide. Fahrten mit öffentlichen Verkehrsmitteln sind bis zu 7 Tage in der Vergangenheit oder 100 Tage in der Zukunft verfügbar.
compute_alternative_routes

bool

Optional. Gibt an, ob zusätzlich zur Route alternative Routen berechnet werden sollen. Für Anfragen mit Zwischenpunkten werden keine alternativen Routen zurückgegeben.
route_modifiers

RouteModifiers

Optional. Eine Reihe von Bedingungen, die erfüllt sein müssen und sich auf die Berechnung von Routen auswirken.
language_code

string

Optional. Der BCP-47-Sprachcode, z. B. "en-US" oder "sr-Latn" Weitere Informationen finden Sie unter Unicode-Sprachkennzeichnung. Eine Liste der unterstützten Sprachen finden Sie unter Sprachunterstützung. Wenn Sie diesen Wert nicht angeben, wird die Anzeigesprache aus dem Standort der Routenanfrage abgeleitet.
region_code

string

Optional. Der Regionscode, angegeben als zweistelliger Ländercode der Top-Level-Domain (ccTLD). Weitere Informationen finden Sie unter Top-Level-Domains mit Landeskennzeichen.
units

Units

Optional. Gibt die Maßeinheiten für die Anzeigefelder an. Dazu gehört das Feld instruction in NavigationInstruction. Die Maßeinheiten für Route, Teilstrecke, Schrittentfernung und Dauer sind von diesem Wert nicht betroffen. Wenn Sie diesen Wert nicht angeben, werden die Anzeigeeinheiten aus dem Standort des ersten Ursprungs abgeleitet.
optimize_waypoint_order

bool

Optional. Wenn diese Option auf „wahr“ gesetzt ist, versucht der Dienst, die Gesamtkosten der Route zu minimieren, indem die angegebenen Zwischenziele neu angeordnet werden. Die Anfrage schlägt fehl, wenn einer der Zwischenwegpunkte ein via-Wegpunkt ist. Verwenden Sie ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index, um die neue Reihenfolge zu finden. Wenn ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index nicht im X-Goog-FieldMask-Header angefordert wird, schlägt die Anfrage fehl. Wenn optimize_waypoint_order auf „false“ gesetzt ist, ist ComputeRoutesResponse.optimized_intermediate_waypoint_index leer.
requested_reference_routes[]

ReferenceRoute

Optional. Gibt an, welche Referenzrouten zusätzlich zur Standardroute im Rahmen der Anfrage berechnet werden sollen. Eine Referenzroute ist eine Route mit einem anderen Ziel für die Routenberechnung als die Standardroute. Bei der Berechnung einer FUEL_EFFICIENT-Referenzroute werden beispielsweise verschiedene Parameter berücksichtigt, die eine optimale, verbrauchsgünstige Route ergeben. Wenn Sie diese Funktion verwenden, achten Sie auf das Symbol route_labels in den angezeigten Routen.
extra_computations[]

ExtraComputation

Optional. Eine Liste zusätzlicher Berechnungen, die zum Ausführen der Anfrage verwendet werden können. Hinweis: Diese zusätzlichen Berechnungen können zusätzliche Felder in der Antwort zurückgeben. Diese zusätzlichen Felder müssen auch in der Feldmaske angegeben werden, die in der Antwort zurückgegeben werden soll.
traffic_model

TrafficModel

Optional. Gibt die Annahmen an, die bei der Berechnung der Reisezeit verwendet werden sollen. Diese Einstellung wirkt sich auf den Wert für die voraussichtliche Reisezeit aus, der in den Antworten in den Feldern Route und RouteLeg zurückgegeben und anhand bisheriger Durchschnittswerte berechnet wird. TrafficModel ist nur für Anfragen verfügbar, bei denen RoutingPreference auf TRAFFIC_AWARE_OPTIMAL und RouteTravelMode auf DRIVE gesetzt ist. Der Standardwert ist BEST_GUESS, wenn der Traffic angefordert und TrafficModel nicht angegeben wurde.
transit_preferences

TransitPreferences

Optional. Gibt Einstellungen an, die die für TRANSIT-Routen zurückgegebene Route beeinflussen. HINWEIS: Sie können nur dann eine transit_preferences angeben, wenn RouteTravelMode auf TRANSIT gesetzt ist.

ExtraComputation

Zusätzliche Berechnungen, die beim Ausführen der Anfrage ausgeführt werden.

Enums
EXTRA_COMPUTATION_UNSPECIFIED Nicht verwendet. Anfragen mit diesem Wert schlagen fehl.
TOLLS Informationen zu Mautgebühren für die Route(n).
FUEL_CONSUMPTION Geschätzter Kraftstoffverbrauch für die Route(n).
TRAFFIC_ON_POLYLINE Polylinien mit Berücksichtigung der aktuellen Verkehrslage für die Routen.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions als formatierter HTML-Textstring dargestellt. Dieser Inhalt ist so zu lesen, wie er ist. Er dient nur zur Anzeige. Wir raten davon ab, sie programmatisch zu parsen.
FLYOVER_INFO_ON_POLYLINE Informationen zu den Überflügen der Routen. Die Feldmaske routes.polyline_details.flyover_info muss angegeben werden, damit diese Informationen zurückgegeben werden. Diese Daten werden derzeit nur für bestimmte Metropolen in Indien erfasst. Diese Funktion ist experimentell und die SKU/Ladung kann sich ändern.
NARROW_ROAD_INFO_ON_POLYLINE Informationen zu engen Straßen für die Route(n). Die Feldmaske routes.polyline_details.narrow_road_info muss angegeben werden, damit diese Informationen zurückgegeben werden. Diese Daten werden derzeit nur für bestimmte Metropolen in Indien erfasst. Diese Funktion ist experimentell und die SKU/Ladung kann sich ändern.

ReferenceRoute

Eine unterstützte Referenzroute in der ComputeRoutesRequest.

Enums
REFERENCE_ROUTE_UNSPECIFIED Nicht verwendet. Anfragen mit diesem Wert schlagen fehl.
FUEL_EFFICIENT Spritsparende Route.
SHORTER_DISTANCE

Route mit kürzerer Fahrstrecke Dies ist eine experimentelle Funktion.

Bei DRIVE-Anfragen wird mit dieser Funktion die kürzeste Entfernung vor dem Fahrkomfort priorisiert. So werden beispielsweise möglicherweise Landstraßen anstelle von Autobahnen bevorzugt, es werden Feldwege befahren oder Parkplätze durchquert. Mit dieser Funktion werden keine Manöver zurückgegeben, die laut Google Maps illegal sind.

Bei BICYCLE- und TWO_WHEELER-Anfragen werden mit dieser Funktion ähnliche Routen zurückgegeben wie bei Anfragen ohne Angabe von requested_reference_routes.

Diese Funktion ist nicht mit anderen Verkehrsmitteln, über Zwischenziele oder optimize_waypoint_order kompatibel. Solche Anfragen schlagen fehl. Sie können sie jedoch mit jeder routing_preference verwenden.

ComputeRoutesResponse

ComputeRoutes die Antwortnachricht.

Felder
routes[]

Route

Enthält ein Array mit bis zu drei berechneten Routen, wenn Sie compute_alternatives_routes angeben, und nur eine Route, wenn Sie dies nicht tun. Wenn dieses Array mehrere Einträge enthält, ist der erste die am besten empfohlene Route. Wenn das Array leer ist, konnte keine Route gefunden werden.
fallback_info

FallbackInfo

Wenn der Server die Routenergebnisse nicht mit allen Eingabeeinstellungen berechnen kann, wird möglicherweise eine andere Berechnungsmethode verwendet. Wenn der Fallback-Modus verwendet wird, enthält dieses Feld detaillierte Informationen zur Fallback-Antwort. Andernfalls ist dieses Feld nicht festgelegt.
geocoding_results

GeocodingResults

Enthält Geocoding-Antwortinformationen für Wegpunkte, die als Adressen angegeben sind.

FallbackInfo

Informationen dazu, wie und warum ein Fallback-Ergebnis verwendet wurde. Wenn dieses Feld festgelegt ist, hat der Server als Fallback einen anderen Routingmodus als Ihren bevorzugten Modus verwendet.

Felder
routing_mode

FallbackRoutingMode

Der für die Antwort verwendete Routingmodus. Wenn der Fallback ausgelöst wurde, kann der Modus von der Routing-Einstellung abweichen, die in der ursprünglichen Clientanfrage festgelegt wurde.
reason

FallbackReason

Der Grund, warum anstelle der ursprünglichen Antwort die Fallback-Antwort verwendet wurde. Dieses Feld wird nur ausgefüllt, wenn der Fallback-Modus ausgelöst und die Fallback-Antwort zurückgegeben wird.

FallbackReason

Gründe für die Verwendung einer Fallback-Antwort.

Enums
FALLBACK_REASON_UNSPECIFIED Kein Grund für den Fallback angegeben.
SERVER_ERROR Beim Berechnen von Routen mit Ihrem bevorzugten Routingmodus ist ein Serverfehler aufgetreten. Wir konnten jedoch ein Ergebnis zurückgeben, das mit einem alternativen Modus berechnet wurde.
LATENCY_EXCEEDED Wir konnten die Berechnung mit Ihrem bevorzugten Routenmodus nicht rechtzeitig abschließen, konnten aber ein Ergebnis zurückgeben, das mit einem alternativen Modus berechnet wurde.

FallbackRoutingMode

Der tatsächliche Routingmodus, der für die zurückgegebene Fallback-Antwort verwendet wird.

Enums
FALLBACK_ROUTING_MODE_UNSPECIFIED Nicht verwendet.
FALLBACK_TRAFFIC_UNAWARE Gibt an, dass die TRAFFIC_UNAWARE RoutingPreference zur Berechnung der Antwort verwendet wurde.
FALLBACK_TRAFFIC_AWARE Gibt an, dass die TRAFFIC_AWARE RoutingPreference zur Berechnung der Antwort verwendet wurde.

GeocodedWaypoint

Details zu den als Wegpunkte verwendeten Standorten. Wird nur für Wegpunkte von Adressen ausgefüllt. Enthält Details zu den Geocoding-Ergebnissen, um zu ermitteln, wo die Adresse geocodiert wurde.

Felder
geocoder_status

Status

Gibt den Statuscode des Geocoding-Vorgangs an.
type[]

string

Der Typ oder die Typen des Ergebnisses in Form von null oder mehr Typ-Tags. Unterstützte Typen: Typen von Adressen und Adresskomponenten
partial_match

bool

Gibt an, dass der Geocoder keine genaue Übereinstimmung für die ursprüngliche Anfrage zurückgegeben hat, obwohl ein Teil der angeforderten Adresse zugeordnet werden konnte. Überprüfen Sie ggf. die Anforderung auf Tippfehler und/oder Unvollständigkeit.
place_id

string

Die Orts-ID für dieses Ergebnis.
intermediate_waypoint_request_index

int32

Der Index des entsprechenden Zwischen-Wegpunkts in der Anfrage. Wird nur ausgefüllt, wenn der entsprechende Wegpunkt ein Zwischenwegpunkt ist.

GeocodingResults

Enthält GeocodedWaypoints für Start-, Ziel- und Zwischenwegpunkte. Wird nur für Wegpunkte von Adressen ausgefüllt.

Felder
origin

GeocodedWaypoint

Geocodierter Startpunkt.
destination

GeocodedWaypoint

Geocodierter Wegpunkt für das Ziel.
intermediates[]

GeocodedWaypoint

Eine Liste von Zwischen-Wegpunkten, die jeweils ein Indexfeld enthalten, das der Position des Wegpunkts (gezählt ab null) in der Reihenfolge entspricht, in der sie in der Anfrage angegeben wurden.

LocalizedTime

Lokalisierte Zeitbeschreibung.

Felder
time

LocalizedText

Die als String angegebene Zeit in einer bestimmten Zeitzone.
time_zone

string

Enthält die Zeitzone. Der Wert entspricht dem Namen der Zeitzone, die in der IANA-Zeitzonendatenbank definiert ist, z. B. "America/New_York".

Standort

Umfasst einen Standort (einen geografischen Punkt und eine optionale Überschrift).

Felder
lat_lng

LatLng

Die geografischen Koordinaten des Wegpunkts.
heading

Int32Value

Die Kompassrichtung, die der Verkehrsflussrichtung entspricht. Dieser Wert gibt die Straßenseite für die Abholung und Rückgabe an. Die Werte für die Richtung können zwischen 0 und 360 liegen. Dabei gibt 0 die Richtung „Nördlich“ an, 90 die Richtung „Osten“ usw. Dieses Feld kann nur für DRIVE und TWO_WHEELER RouteTravelMode verwendet werden.

Manöver

Eine Reihe von Werten, die die Navigationsaktion für den aktuellen Schritt angeben (z. B. links abbiegen, einfädeln oder geradeaus fahren).

Enums
MANEUVER_UNSPECIFIED Nicht verwendet.
TURN_SLIGHT_LEFT Drehen Sie sich leicht nach links.
TURN_SHARP_LEFT Abbiegen Sie scharf nach links.
UTURN_LEFT Wenden Sie nach links.
TURN_LEFT Biegen Sie links ab.
TURN_SLIGHT_RIGHT Drehen Sie sich leicht nach rechts.
TURN_SHARP_RIGHT Achten Sie darauf, dass Sie nicht zu stark nach rechts abbiegen.
UTURN_RIGHT Wenden Sie nach rechts.
TURN_RIGHT Biegen Sie rechts ab.
STRAIGHT Fahren Sie geradeaus.
RAMP_LEFT Nehmen Sie die linke Auffahrt.
RAMP_RIGHT Nehmen Sie die rechte Auffahrt.
MERGE Einfädeln.
FORK_LEFT Nehmen Sie die Abzweigung nach links.
FORK_RIGHT Biegen Sie rechts ab.
FERRY Nehmen Sie die Fähre.
FERRY_TRAIN Nehmen Sie den Zug zur Fähre.
ROUNDABOUT_LEFT Biegen Sie am Kreisverkehr links ab.
ROUNDABOUT_RIGHT Biegen Sie am Kreisverkehr rechts ab.
DEPART Erster Fahrmanöver
NAME_CHANGE Wird verwendet, um eine Änderung des Straßennamens anzugeben.

Kapselt Navigationsanweisungen für eine RouteLegStep ein.

Felder
maneuver

Maneuver

Enthält die Navigationsanweisungen für den aktuellen Schritt (z. B. links abbiegen, einfädeln oder geradeaus fahren). In diesem Feld wird festgelegt, welches Symbol angezeigt wird.
instructions

string

Anleitung für diesen Schritt

Polyline

Kapselt eine codierte Polylinie ein.

Felder
Union-Feld polyline_type. Der Typ des Polyliniens. Standardeinstellung ist „encoded_polyline“. Für polyline_type ist nur einer der folgenden Werte zulässig:
encoded_polyline

string

Die Stringcodierung der Polylinie mit dem Algorithmus für die Polyliniencodierung
geo_json_linestring

Struct

Gibt eine Polylinie im GeoJSON-LineString-Format an.

PolylineDetails

Details, die einem bestimmten Index oder zusammenhängenden Segment einer Polylinie entsprechen. Bei einer Polylinie mit den Punkten P_0, P_1, …, P_N (Index beginnt bei 0) definiert PolylineDetails ein Intervall und zugehörige Metadaten.

Felder
flyover_info[]

FlyoverInfo

Details zur Überflugsstrecke entlang der Polylinie.
narrow_road_info[]

NarrowRoadInfo

Details zu schmalen Straßen entlang der Polylinie.

FlyoverInfo

Enthält Informationen zu Flyovers entlang der Polylinie.

Felder
flyover_presence

RoadFeatureState

Nur Ausgabe. Gibt an, ob für einen bestimmten Abschnitt der Polylinie eine Flyover-Ansicht vorhanden ist.
polyline_point_index

PolylinePointIndex

Die Position von Informationen zu Überflügen entlang der Polylinie.

NarrowRoadInfo

Enthält Informationen zu schmalen Straßen entlang der Polylinie.

Felder
narrow_road_presence

RoadFeatureState

Nur Ausgabe. Gibt an, ob für einen bestimmten Abschnitt der Polylinie eine schmale Straße vorhanden ist.
polyline_point_index

PolylinePointIndex

Der Standort von Informationen zu schmalen Straßen entlang der Polylinie.

PolylinePointIndex

Umschließt die Start- und Endindexe für ein Polyliniendetail. Wenn die Daten einem einzelnen Punkt entsprechen, sind start_index und end_index gleich.

Felder
start_index

int32

Der Startindex dieses Details in der Polylinie.
end_index

int32

Der Endindex dieses Details in der Polylinie.

RoadFeatureState

Kapselt die Status von Straßenelementen entlang eines Polylinienabschnitts ein.

Enums
ROAD_FEATURE_STATE_UNSPECIFIED Der Status der Straßenelemente wurde nicht berechnet (Standardwert).
EXISTS Die Straßenelemente sind vorhanden.
DOES_NOT_EXIST Die Straßenelemente sind nicht vorhanden.

PolylineEncoding

Gibt den bevorzugten Polylinientyp an, der zurückgegeben werden soll.

Enums
POLYLINE_ENCODING_UNSPECIFIED Es wurde keine Einstellung für den Polylinientyp angegeben. Die Standardeinstellung ist ENCODED_POLYLINE.
ENCODED_POLYLINE Gibt eine Polylinie an, die mit dem Algorithmus für codierte Polylinien codiert wurde.
GEO_JSON_LINESTRING Gibt eine Polylinie im GeoJSON-LineString-Format an.

PolylineQuality

Eine Reihe von Werten, die die Qualität der Polylinie angeben.

Enums
POLYLINE_QUALITY_UNSPECIFIED Es wurde keine Einstellung für die Polylinienqualität angegeben. Die Standardeinstellung ist OVERVIEW.
HIGH_QUALITY Gibt eine Polylinie mit hoher Qualität an, die aus mehr Punkten als OVERVIEW besteht. Dies führt zu einer größeren Antwortgröße. Verwenden Sie diesen Wert, wenn Sie eine höhere Genauigkeit benötigen.
OVERVIEW Hiermit wird eine Übersichtspolylinie angegeben, die aus einer kleinen Anzahl von Punkten besteht. Verwenden Sie diesen Wert, wenn eine Übersicht der Route angezeigt werden soll. Bei dieser Option ist die Anfragelatenz niedriger als bei der Option HIGH_QUALITY.

Route

Enthält eine Route, die aus einer Reihe verbundener Straßensegmente besteht, die Start-, End- und Zwischenwegpunkte verbinden.

Felder
route_labels[]

RouteLabel

Labels für die Route, mit denen sich bestimmte Eigenschaften der Route identifizieren lassen, um sie mit anderen zu vergleichen.
legs[]

RouteLeg

Eine Reihe von Abschnitten (Pfadsegmente zwischen Wegpunkten), die die Route bilden. Jede Etappe entspricht der Fahrt zwischen zwei nicht via Waypoints. Eine Route ohne Zwischenziele hat beispielsweise nur einen Abschnitt. Eine Route mit einem Zwischenpunkt, der kein via ist, hat zwei Abschnitte. Eine Route mit einem via-Wegpunkt hat einen Abschnitt. Die Reihenfolge der Strecken entspricht der Reihenfolge der Wegpunkte von origin über intermediates zu destination.
distance_meters

int32

Die zurückgelegte Strecke der Route in Metern.
duration

Duration

Die Zeit, die für die Route benötigt wird. Wenn Sie routing_preference auf TRAFFIC_UNAWARE festlegen, ist dieser Wert mit static_duration identisch. Wenn Sie routing_preference auf TRAFFIC_AWARE oder TRAFFIC_AWARE_OPTIMAL festlegen, wird dieser Wert unter Berücksichtigung der Verkehrsbedingungen berechnet.
static_duration

Duration

Die Fahrtdauer auf der Route ohne Berücksichtigung der Verkehrslage.
polyline

Polyline

Die Polylinie der gesamten Route. Diese Polylinie ist die kombinierte Polylinie aller legs.
description

string

Eine Beschreibung der Route.
warnings[]

string

Ein Array mit Warnungen, die zusammen mit der Route angezeigt werden müssen.
viewport

Viewport

Der Begrenzungsrahmen des Darstellungsbereichs der Polylinie.
travel_advisory

RouteTravelAdvisory

Zusätzliche Informationen zur Route.
optimized_intermediate_waypoint_index[]

int32

Wenn Sie optimize_waypoint_order auf „wahr“ setzen, enthält dieses Feld die optimierte Reihenfolge der Zwischenziele. Andernfalls ist dieses Feld leer. Wenn Sie beispielsweise „Start: Los Angeles; Zwischenziele: Dallas, Bangor, Phoenix; Ziel: New York“ eingeben und die optimierte Reihenfolge der Zwischenziele Phoenix, Dallas, Bangor ist, enthält dieses Feld die Werte [2, 0, 1]. Der Index beginnt mit 0 für den ersten Zwischenpunkt in der Eingabe.
localized_values

RouteLocalizedValues

Textdarstellungen von Properties der Route.
route_token

string

Ein undurchsichtiges Token, das an das Navigation SDK übergeben werden kann, um die Route während der Navigation neu zu erstellen und bei einer Umleitung die ursprüngliche Absicht beim Erstellen der Route zu berücksichtigen. Dieses Token als intransparenten Blob behandeln Vergleichen Sie den Wert nicht zwischen Anfragen, da er sich auch dann ändern kann, wenn der Dienst genau dieselbe Route zurückgibt.

HINWEIS: Route.route_token ist nur für Anfragen verfügbar, bei denen ComputeRoutesRequest.routing_preference auf TRAFFIC_AWARE oder TRAFFIC_AWARE_OPTIMAL gesetzt ist. Route.route_token wird nicht für Anfragen mit Zwischenstopp-Wegpunkten unterstützt.
polyline_details

PolylineDetails

Enthält Informationen zu Details entlang der Polylinie.

RouteLocalizedValues

Textdarstellungen bestimmter Properties.

Felder
distance

LocalizedText

Die zurückgelegte Strecke in Textform.
duration

LocalizedText

Dauer, dargestellt in Textform und lokalisiert auf die Region der Suchanfrage. Die Verkehrslage wird berücksichtigt. Hinweis: Wenn Sie keine Verkehrsinformationen angefordert haben, entspricht dieser Wert dem Wert static_duration.
static_duration

LocalizedText

Dauer ohne Berücksichtigung der Verkehrslage, in Textform
transit_fare

LocalizedText

Preis für öffentliche Verkehrsmittel in Textform.

RouteLabel

Labels für die Route, mit denen sich bestimmte Eigenschaften der Route identifizieren lassen, um sie mit anderen zu vergleichen.

Enums
ROUTE_LABEL_UNSPECIFIED Standardeinstellung – nicht verwendet.
DEFAULT_ROUTE Die standardmäßige „beste“ Route, die für die Routenberechnung zurückgegeben wird.
DEFAULT_ROUTE_ALTERNATE Eine Alternative zur Standardroute „Beste Route“. Solche Routen werden zurückgegeben, wenn compute_alternative_routes angegeben wird.
FUEL_EFFICIENT Spritsparende Route. Routen mit diesem Wert sind für umweltfreundliche Parameter wie den Kraftstoffverbrauch optimiert.
SHORTER_DISTANCE Route mit kürzerer zurückgelegter Strecke. Dies ist eine experimentelle Funktion.

RouteLeg

Enthält ein Segment zwischen Wegpunkten, die keine via sind.

Felder
distance_meters

int32

Die zurückgelegte Strecke des Streckenabschnitts in Metern.
duration

Duration

Die Zeit, die für die Route benötigt wird. Wenn route_preference auf TRAFFIC_UNAWARE gesetzt ist, ist dieser Wert mit static_duration identisch. Wenn route_preference den Wert TRAFFIC_AWARE oder TRAFFIC_AWARE_OPTIMAL hat, wird dieser Wert unter Berücksichtigung der Verkehrsbedingungen berechnet.
static_duration

Duration

Die Reisedauer für den Abschnitt, berechnet ohne Berücksichtigung der Verkehrsbedingungen.
polyline

Polyline

Der Polylinie für diesen Abschnitt, der den Polylinien aller step enthält.
start_location

Location

Der Startort dieses Abschnitts. Dieser Standort kann sich von der angegebenen origin unterscheiden. Wenn sich der angegebene Wert für origin beispielsweise nicht in der Nähe einer Straße befindet, ist dies ein Punkt auf der Straße.
end_location

Location

Der Endpunkt dieses Abschnitts. Dieser Standort kann sich von der angegebenen destination unterscheiden. Wenn sich der angegebene Wert für destination beispielsweise nicht in der Nähe einer Straße befindet, ist dies ein Punkt auf der Straße.
steps[]

RouteLegStep

Ein Array von Schritten, die Segmente innerhalb dieses Abschnitts bezeichnen. Jeder Schritt entspricht einer Navigationsanweisung.
travel_advisory

RouteLegTravelAdvisory

Enthält zusätzliche Informationen, über die der Nutzer informiert werden sollte, z. B. mögliche Einschränkungen für Verkehrszonen auf einem Streckenabschnitt.
localized_values

RouteLegLocalizedValues

Textdarstellungen von Properties der RouteLeg.
steps_overview

StepsOverview

Übersicht über die Schritte in dieser RouteLeg. Dieses Feld wird nur für ROUTEN MIT ÖFFENTLICHEN VERKEHRSMITTELN ausgefüllt.

RouteLegLocalizedValues

Textdarstellungen bestimmter Properties.

Felder
distance

LocalizedText

Die zurückgelegte Strecke in Textform.
duration

LocalizedText

Dauer, dargestellt in Textform und lokalisiert auf die Region der Suchanfrage. Die Verkehrslage wird berücksichtigt. Hinweis: Wenn Sie keine Verkehrsinformationen angefordert haben, entspricht dieser Wert dem Wert „static_duration“.
static_duration

LocalizedText

Dauer ohne Berücksichtigung der Verkehrslage, in Textform

StepsOverview

Bietet eine Übersicht über eine Liste von RouteLegSteps.

Felder
multi_modal_segments[]

MultiModalSegment

Zusammenfassung der Informationen zu den verschiedenen multimodalen Segmenten der RouteLeg.steps. Dieses Feld wird nicht ausgefüllt, wenn die RouteLeg in den Schritten keine multimodalen Segmente enthält.

MultiModalSegment

Bietet zusammengefasste Informationen zu verschiedenen multimodalen Segmenten der RouteLeg.steps. Ein multimodales Segment wird als ein oder mehrere zusammenhängende RouteLegStep mit derselben RouteTravelMode definiert. Dieses Feld wird nicht ausgefüllt, wenn die RouteLeg in den Schritten keine multimodalen Segmente enthält.

Felder
navigation_instruction

NavigationInstruction

Navigationsanleitung für das multimodale Segment.
travel_mode

RouteTravelMode

Die Mobilitätsform des multimodalen Abschnitts.
step_start_index

int32

Der entsprechende RouteLegStep-Index, der den Beginn eines multimodalen Segments markiert.
step_end_index

int32

Der entsprechende RouteLegStep-Index, der das Ende eines multimodalen Abschnitts markiert.

RouteLegStep

Enthält ein Segment einer RouteLeg. Ein Schritt entspricht einer einzelnen Navigationsanweisung. Routenabschnitte bestehen aus Schritten.

Felder
distance_meters

int32

Die zurückgelegte Strecke dieses Schritts in Metern. Unter bestimmten Umständen ist dieses Feld möglicherweise leer.
static_duration

Duration

Die Fahrtdauer für diesen Schritt ohne Berücksichtigung der Verkehrslage. Unter bestimmten Umständen ist dieses Feld möglicherweise leer.
polyline

Polyline

Die Polylinie, die mit diesem Schritt verknüpft ist.
start_location

Location

Der Startort dieses Schritts.
end_location

Location

Der Endpunkt dieses Schritts.
navigation_instruction

NavigationInstruction

Navigationsanleitung
travel_advisory

RouteLegStepTravelAdvisory

Enthält zusätzliche Informationen, über die der Nutzer informiert werden sollte, z. B. mögliche Einschränkungen für Zonen mit Verkehrsbeschränkungen.
localized_values

RouteLegStepLocalizedValues

Textdarstellungen von Properties der RouteLegStep.
transit_details

RouteLegStepTransitDetails

Details zu diesem Schritt, wenn der Reisemodus TRANSIT ist.
travel_mode

RouteTravelMode

Der für diesen Schritt verwendete Verkehrsmitteltyp.

RouteLegStepLocalizedValues

Textdarstellungen bestimmter Properties.

Felder
distance

LocalizedText

Die zurückgelegte Strecke in Textform.
static_duration

LocalizedText

Dauer ohne Berücksichtigung der Verkehrslage, in Textform

RouteLegStepTransitDetails

Zusätzliche Informationen für die RouteLegStep im Zusammenhang mit TRANSIT-Routen.

Felder
stop_details

TransitStopDetails

Informationen zu den Ankunfts- und Abfahrtshaltestellen für den Schritt.
localized_values

TransitDetailsLocalizedValues

Textdarstellungen von Properties der RouteLegStepTransitDetails.
headsign

string

Gibt die Fahrtrichtung dieser Linie an, die auf dem Fahrzeug oder an der Haltestelle ausgewiesen ist. Die Richtung ist oft die Endhaltestelle.
headway

Duration

Gibt die erwartete Zeit als Dauer zwischen Abfahrten von derselben Haltestelle zu dieser Zeit an. Bei einem Wert von 600 Sekunden für die Vorlaufzeit wäre z. B. mit einer Wartezeit von 10 Minuten zu rechnen, wenn man einen Bus verpasst.
transit_line

TransitLine

Informationen zur in diesem Schritt verwendeten ÖPNV-Linie.
stop_count

int32

Die Anzahl der Haltestellen zwischen der Starthaltestelle und der Zielhaltestelle. Dabei wird die Zielhaltestelle mitgezählt, die Starthaltestelle aber nicht. Wenn Sie z. B. an Haltestelle A abfahren, die Haltestellen B und C durchfahren und bei Haltestelle D aussteigen,

stop_count

gibt 3 zurück.
trip_short_text

string

Der Text, der in Fahrplänen und auf Aushängen erscheint, um Fahrgäste auf eine Fahrt mit öffentlichen Verkehrsmitteln hinzuweisen. Der Text sollte eine Fahrt innerhalb eines Betriebstags eindeutig identifizieren. „538“ ist beispielsweise die trip_short_text des Amtrak-Zugs, der an Wochentagen um 15:10 Uhr von San Jose, CA nach Sacramento, CA fährt.

TransitDetailsLocalizedValues

Lokalisierte Beschreibungen von Werten für RouteTransitDetails.

Felder
arrival_time

LocalizedTime

Die Uhrzeit in der formatierten Textdarstellung mit einer entsprechenden Zeitzone.
departure_time

LocalizedTime

Die Uhrzeit in der formatierten Textdarstellung mit einer entsprechenden Zeitzone.

TransitStopDetails

Details zu den Haltestellen der RouteLegStep.

Felder
arrival_stop

TransitStop

Informationen zur Ankunftshaltestelle für den Schritt.
arrival_time

Timestamp

Die voraussichtliche Ankunftszeit für den Schritt.
departure_stop

TransitStop

Informationen zur Abfahrtshaltestelle für den Schritt.
departure_time

Timestamp

Die geschätzte Abfahrtszeit für den Schritt.

RouteLegStepTravelAdvisory

Enthält zusätzliche Informationen, über die der Nutzer informiert werden sollte, z. B. mögliche Einschränkungen für Verkehrszonen für einen Streckenabschnitt.

Felder
speed_reading_intervals[]

SpeedReadingInterval

HINWEIS: Dieses Feld ist derzeit nicht ausgefüllt.

RouteLegTravelAdvisory

Enthält die zusätzlichen Informationen, über die der Nutzer bei einem Streckenabschnitt informiert werden sollte, z. B. mögliche Einschränkungen für Zonen mit Verkehrsbeschränkungen.

Felder
toll_info

TollInfo

Enthält Informationen zu Mautgebühren auf der jeweiligen RouteLeg. Dieses Feld wird nur ausgefüllt, wenn wir davon ausgehen, dass auf der RouteLeg Mautgebühren anfallen. Wenn dieses Feld festgelegt ist, das Unterfeld „estimated_price“ aber nicht ausgefüllt ist, gehen wir davon aus, dass die Straße Mautgebühren enthält, wir aber keinen geschätzten Preis kennen. Wenn dieses Feld nicht vorhanden ist, gibt es keine Maut auf der RouteLeg.
speed_reading_intervals[]

SpeedReadingInterval

Geschwindigkeitsintervalle mit Angaben zur Verkehrsdichte. Gilt für TRAFFIC_AWARE- und TRAFFIC_AWARE_OPTIMAL-Routingeinstellungen. Die Intervalle umfassen die gesamte Polylinie der RouteLeg ohne Überschneidungen. Der Startpunkt eines bestimmten Intervalls ist mit dem Endpunkt des vorherigen Intervalls identisch.

Beispiel:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteMatrixDestination

Ein einzelnes Ziel für ComputeRouteMatrixRequest

Felder
waypoint

Waypoint

Erforderlich. Zielmarkierung

RouteMatrixElement

Enthält Routeninformationen, die für ein Start-/Zielortpaar in der ComputeRouteMatrix API berechnet wurden. Dieses Proto kann an den Client gestreamt werden.

Felder
status

Status

Fehlerstatuscode für dieses Element.
condition

RouteMatrixElementCondition

Gibt an, ob die Route gefunden wurde oder nicht. Unabhängig vom Status.
distance_meters

int32

Die zurückgelegte Strecke der Route in Metern.
duration

Duration

Die Zeit, die für die Route benötigt wird. Wenn Sie routing_preference auf TRAFFIC_UNAWARE festlegen, ist dieser Wert mit static_duration identisch. Wenn Sie routing_preference auf TRAFFIC_AWARE oder TRAFFIC_AWARE_OPTIMAL festlegen, wird dieser Wert unter Berücksichtigung der Verkehrsbedingungen berechnet.
static_duration

Duration

Die Dauer der Fahrt auf der Route, ohne Berücksichtigung der Verkehrslage.
travel_advisory

RouteTravelAdvisory

Zusätzliche Informationen zur Route. Beispiel: Informationen zu Einschränkungen und Mautgebühren
fallback_info

FallbackInfo

Wenn der Server die Route mit den angegebenen Einstellungen für dieses bestimmte Start-/Zielortpaar nicht berechnen kann, wird möglicherweise ein anderer Berechnungsmodus verwendet. Wenn der Fallback-Modus verwendet wird, enthält dieses Feld detaillierte Informationen zur Fallback-Antwort. Andernfalls ist dieses Feld nicht festgelegt.
localized_values

LocalizedValues

Textdarstellungen von Properties der RouteMatrixElement.
origin_index

int32

Der nullbasierte Index des Ursprungs in der Anfrage.
destination_index

int32

Der nullbasierte Index des Ziels in der Anfrage.

LocalizedValues

Textdarstellungen bestimmter Properties.

Felder
distance

LocalizedText

Die zurückgelegte Strecke in Textform.
duration

LocalizedText

Die Dauer wird in Textform angegeben und berücksichtigt die Verkehrslage. Hinweis: Wenn keine Verkehrsinformationen angefordert wurden, entspricht dieser Wert dem Wert „static_duration“.
static_duration

LocalizedText

Die Dauer wird in Textform angegeben, ohne die Verkehrsbedingungen zu berücksichtigen.
transit_fare

LocalizedText

Preis für öffentliche Verkehrsmittel in Textform.

RouteMatrixElementCondition

Der Zustand der zurückgegebenen Route.

Enums
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Wird nur verwendet, wenn der status des Elements nicht in Ordnung ist.
ROUTE_EXISTS Eine Route wurde gefunden und die entsprechenden Informationen für das Element ausgefüllt.
ROUTE_NOT_FOUND Es konnte keine Route gefunden werden. Felder mit Routeninformationen wie distance_meters oder duration werden im Element nicht ausgefüllt.

RouteMatrixOrigin

Eine einzelne Quelle für ComputeRouteMatrixRequest

Felder
waypoint

Waypoint

Erforderlich. Startpunkt
route_modifiers

RouteModifiers

Optional. Modifikatoren für jede Route, die diesen als Startpunkt hat

RouteModifiers

Umfasst eine Reihe optionaler Bedingungen, die bei der Berechnung der Routen erfüllt werden müssen.

Felder
avoid_tolls

bool

Wenn dieser Wert auf „wahr“ gesetzt ist, werden Mautstraßen nach Möglichkeit vermieden und Routen ohne Mautstraßen bevorzugt. Gilt nur für DRIVE und TWO_WHEELER RouteTravelMode.
avoid_highways

bool

Wenn dieser Wert auf „wahr“ gesetzt ist, werden nach Möglichkeit Autobahnen vermieden und Routen ohne Autobahnen bevorzugt. Gilt nur für DRIVE und TWO_WHEELER RouteTravelMode.
avoid_ferries

bool

Wenn dieser Wert auf „wahr“ gesetzt ist, werden nach Möglichkeit Fähren vermieden und Routen ohne Fähren bevorzugt. Gilt nur für DRIVE und TWO_WHEELER RouteTravelMode.
avoid_indoor

bool

Wenn diese Option auf „wahr“ gesetzt ist, wird nach Möglichkeit die Navigation in Innenräumen vermieden. Routen ohne Navigation in Innenräumen werden bevorzugt. Gilt nur für den WALK RouteTravelMode.
vehicle_info

VehicleInfo

Gibt die Fahrzeuginformationen an.
toll_passes[]

TollPass

Enthält Informationen zu Mautkarten/-vignetten. Wenn Mautkarten angegeben sind, versucht die API, den Preis der Karte zurückzugeben. Wenn keine Mautkarten angegeben werden, behandelt die API die Mautkarte als unbekannt und versucht, den Barpreis zurückzugeben. Gilt nur für DRIVE und TWO_WHEELER RouteTravelMode.

RouteTravelAdvisory

Enthält zusätzliche Informationen, über die der Nutzer informiert werden sollte, z. B. mögliche Einschränkungen für Zonen mit Verkehrsbeschränkungen.

Felder
toll_info

TollInfo

Enthält Informationen zu Mautgebühren auf der Route. Dieses Feld wird nur ausgefüllt, wenn auf der Route Mautgebühren anfallen. Wenn dieses Feld festgelegt ist, das Unterfeld estimatedPrice aber nicht ausgefüllt ist, enthält die Route Mautgebühren, der geschätzte Preis ist jedoch unbekannt. Wenn dieses Feld nicht festgelegt ist, sind auf der Route keine Mautgebühren zu erwarten.
speed_reading_intervals[]

SpeedReadingInterval

Geschwindigkeitsintervalle mit Angaben zur Verkehrsdichte. Gilt für TRAFFIC_AWARE- und TRAFFIC_AWARE_OPTIMAL-Routingeinstellungen. Die Intervalle müssen die gesamte Polylinie der Route abdecken, ohne sich zu überschneiden. Der Startpunkt eines bestimmten Intervalls ist mit dem Endpunkt des vorherigen Intervalls identisch.

Beispiel:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).
fuel_consumption_microliters

int64

Der geschätzte Kraftstoffverbrauch in Mikrolitern.
route_restrictions_partially_ignored

bool

Die zurückgegebene Route kann Einschränkungen enthalten, die für den angeforderten Verkehrsmitteltyp oder die Routenmodifikatoren nicht geeignet sind.
transit_fare

Money

Enthält den Gesamtfahrpreis oder die Gesamtfahrkartenkosten für diese Route. Diese Eigenschaft wird nur für TRANSIT-Anfragen und nur für Routen zurückgegeben, für die Fahrpreisinformationen für alle Abschnitte mit öffentlichen Verkehrsmitteln verfügbar sind.

RouteTravelMode

Eine Reihe von Werten, mit denen die Mobilitätsform angegeben wird. HINWEIS: WALK-, BICYCLE- und TWO_WHEELER-Routen befinden sich in der Betaphase und es fehlen manchmal befahrbare Bürgersteige, Fußwege oder Radwege. Sie müssen diese Warnung für alle Fußwege, Radwege und Routen für Zweiräder anzeigen, die Sie in Ihrer App präsentieren.

Enums
TRAVEL_MODE_UNSPECIFIED Es wurde kein Verkehrsmittel angegeben. Die Standardeinstellung ist DRIVE.
DRIVE Mit dem Pkw unterwegs sein
BICYCLE Mit dem Fahrrad fahren
WALK Sie gehen zu Fuß.
TWO_WHEELER Zweirädriges, motorisiertes Fahrzeug. Beispiel: Motorrad. Dieser Wert unterscheidet sich von der Mobilitätsform BICYCLE, die die Fortbewegung zu Fuß umfasst.
TRANSIT Nutzen Sie nach Möglichkeit öffentliche Verkehrsmittel.

RoutingPreference

Eine Reihe von Werten, die Faktoren angeben, die bei der Berechnung der Route berücksichtigt werden sollen.

Enums
ROUTING_PREFERENCE_UNSPECIFIED Es wurde keine Routingpriorität angegeben. Standardeinstellung ist TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Routen werden berechnet, ohne die aktuelle Verkehrslage zu berücksichtigen. Geeignet, wenn die Verkehrslage keine Rolle spielt oder nicht zutrifft. Mit diesem Wert wird die niedrigste Latenz erzielt. Hinweis: Bei RouteTravelMode, DRIVE und TWO_WHEELER beruhen die Auswahl der Route und die Reisezeit auf dem Straßennetz sowie der durchschnittlichen zeitunabhängigen Verkehrslage.und nicht auf der aktuellen Verkehrslage. Daher können Routen Straßen umfassen, die vorübergehend gesperrt sind. Die Ergebnisse für eine bestimmte Anfrage können sich im Laufe der Zeit aufgrund von Änderungen im Straßennetz, Aktualisierungen der durchschnittlichen Verkehrslage und der Dezentralisierung des Diensts ändern. Außerdem können die Ergebnisse zwischen praktisch gleichwertigen Routen jederzeit und beliebig oft variieren.
TRAFFIC_AWARE Routen werden unter Berücksichtigung der aktuellen Verkehrslage berechnet. Im Gegensatz zu TRAFFIC_AWARE_OPTIMAL werden einige Optimierungen angewendet, um die Latenz deutlich zu reduzieren.
TRAFFIC_AWARE_OPTIMAL Die Routen werden unter Berücksichtigung der aktuellen Verkehrsbedingungen berechnet, ohne die meisten Leistungsoptimierungen anzuwenden. Bei Verwendung dieses Werts ist die Latenz am höchsten.

SpeedReadingInterval

Ein Indikator für die Verkehrsdichte auf einem zusammenhängenden Abschnitt einer Polylinie oder eines Pfads. Bei einem Pfad mit den Punkten P_0, P_1, …, P_N (Index beginnt bei null) definiert SpeedReadingInterval ein Intervall und beschreibt den Traffic mit den folgenden Kategorien.

Felder
start_polyline_point_index

int32

Der Startindex dieses Intervalls in der Polylinie.
end_polyline_point_index

int32

Der Endindex dieses Intervalls in der Polylinie.

Union-Feld speed_type.

Für speed_type ist nur einer der folgenden Werte zulässig:
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, keine Verlangsamung festgestellt.
SLOW Es wurde eine Verkehrsbehinderung erkannt, aber es hat sich kein Stau gebildet.
TRAFFIC_JAM Stau erkannt.

TollInfo

Kapselt Mautinformationen in einer Route oder RouteLeg ein.

Felder
estimated_price[]

Money

Der Geldbetrag der Maut für die entsprechende Route oder RouteLeg. Diese Liste enthält einen Geldbetrag für jede Währung, der voraussichtlich an den Mautstationen berechnet wird. Normalerweise enthält diese Liste nur einen Eintrag für Strecken mit Maut in einer Währung. Bei internationalen Fahrten kann diese Liste mehrere Elemente enthalten, um Mautgebühren in verschiedenen Währungen widerzuspiegeln.

TollPass

Liste der von uns unterstützten Mautkarten und ‑vignetten weltweit

Enums
TOLL_PASS_UNSPECIFIED Nicht verwendet. Wenn dieser Wert verwendet wird, schlägt die Anfrage fehl.
AU_ETOLL_TAG Sydney-Mautkarte Weitere Informationen finden Sie unter https://www.myetoll.com.au.
AU_EWAY_TAG Sydney-Mautkarte Weitere Informationen finden Sie unter https://www.tollpay.com.au.
AU_LINKT Bundesweiter australischer Mautpass. Weitere Informationen finden Sie unter https://www.linkt.com.au/.
AR_TELEPASE Mautkarte/-ticket für Argentinien Weitere Informationen finden Sie unter https://telepase.com.ar.
BR_AUTO_EXPRESO Mautkarte für Brasilien Weitere Informationen finden Sie unter https://www.autoexpreso.com.
BR_CONECTCAR Mautkarte für Brasilien Weitere Informationen finden Sie unter https://conectcar.com.
BR_MOVE_MAIS Mautkarte für Brasilien Weitere Informationen finden Sie unter https://movemais.com.
BR_PASSA_RAPIDO Mautkarte für Brasilien Weitere Informationen finden Sie unter https://pasorapido.gob.do/.
BR_SEM_PARAR Mautkarte für Brasilien Weitere Informationen finden Sie unter https://www.semparar.com.br.
BR_TAGGY Mautkarte für Brasilien Weitere Informationen finden Sie unter https://taggy.com.br.
BR_VELOE Mautkarte für Brasilien Weitere Informationen finden Sie unter https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Grenzübergang zwischen Kanada und den USA
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Grenzübergang zwischen Kanada und den USA
CA_US_BLUE_WATER_EDGE_PASS Grenzübergang zwischen Ontario, Kanada und Michigan, USA.
CA_US_CONNEXION Grenzübergang zwischen Ontario, Kanada und Michigan, USA.
CA_US_NEXUS_CARD Grenzübergang zwischen Kanada und den USA
ID_E_TOLL Indonesien. E-Karte, die von mehreren Banken zur Zahlung von Mautgebühren angeboten wird. Alle E-Karten über Banken werden gleich berechnet, sodass nur ein Enum-Wert erforderlich ist. Beispiele:https://www.bankmandiri.co.id/e-moneyhttps://www.bca.co.id/flazzhttps://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG Indien
IN_LOCAL_HP_PLATE_EXEMPT Indien, Ausnahme für Kennzeichen des Bundesstaats Himachal Pradesh.
JP_ETC Japan ETC: Elektronisches System zur Erhebung von Mautgebühren. https://www.go-etc.jp/
JP_ETC2 Japan ETC2.0. Neue Version von ETC mit weiterem Rabatt und bidirektionaler Kommunikation zwischen Geräten in Fahrzeugen und Antennen auf der Straße. https://www.go-etc.jp/etc2/index.html
MX_IAVE Mexikanische Mautkarte. https://iave.capufe.gob.mx/#/
MX_PASE Mexiko https://www.pase.com.mx
MX_QUICKPASS Mexiko https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE Mexiko
MX_TAG_TELEVIA Anbieter von Mautpässen in Mexiko. Einer von vielen in Mexiko-Stadt. Weitere Informationen findest du unter https://www.televia.com.mx.
MX_TELEVIA Anbieter von Mautpässen in Mexiko. Eine von vielen in Mexiko-Stadt. https://www.televia.com.mx
MX_VIAPASS Mautkarte für Mexiko. Weitere Informationen finden Sie unter https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS AL, USA.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, USA.
US_CA_FASTRAK CA, USA.
US_CA_FASTRAK_CAV_STICKER Gibt an, dass der Fahrer zusätzlich zum von der DMV ausgestellten CAV-Aufkleber (Clean Air Vehicle) einen FasTrak-Pass hat. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, USA.
US_CO_GO_PASS CO, USA.
US_DE_EZPASSDE DE, USA.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS FL, USA.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL, USA.
US_FL_EPASS FL, USA.
US_FL_GIBA_TOLL_PASS FL, USA.
US_FL_LEEWAY FL, USA.
US_FL_SUNPASS FL, USA.
US_FL_SUNPASS_PRO FL, USA.
US_IL_EZPASSIL IL, USA.
US_IL_IPASS IL, USA.
US_IN_EZPASSIN IN, USA.
US_KS_BESTPASS_HORIZON KS, USA.
US_KS_KTAG KS, USA.
US_KS_NATIONALPASS KS, USA.
US_KS_PREPASS_ELITEPASS KS, USA.
US_LA_GEAUXPASS Los Angeles, USA.
US_LA_TOLL_TAG Los Angeles, USA.
US_MA_EZPASSMA MA, USA.
US_MD_EZPASSMD MD, USA.
US_ME_EZPASSME ME, USA.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, USA.
US_MI_BCPASS MI, USA.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, USA.
US_MI_IQ_PROX_CARD

MI, USA. Dieser Karten-/Tickettyp wird nicht mehr unterstützt.
US_MI_IQ_TAG MI, USA.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, USA.
US_MI_NEXPRESS_TOLL MI, USA.
US_MN_EZPASSMN MN, USA.
US_NC_EZPASSNC NC, USA.
US_NC_PEACH_PASS NC, USA.
US_NC_QUICK_PASS NC, USA.
US_NH_EZPASSNH NH, USA.
US_NJ_DOWNBEACH_EXPRESS_PASS New Jersey, USA.
US_NJ_EZPASSNJ New Jersey, USA.
US_NY_EXPRESSPASS NY, USA.
US_NY_EZPASSNY NY, USA.
US_OH_EZPASSOH OH, USA.
US_PA_EZPASSPA PA, USA.
US_RI_EZPASSRI RI, USA.
US_SC_PALPASS SC, USA.
US_TX_AVI_TAG TX, USA.
US_TX_BANCPASS TX, USA.
US_TX_DEL_RIO_PASS TX, USA.
US_TX_EFAST_PASS TX, USA.
US_TX_EAGLE_PASS_EXPRESS_CARD TX, USA.
US_TX_EPTOLL TX, USA.
US_TX_EZ_CROSS TX, USA.
US_TX_EZTAG TX, USA.
US_TX_FUEGO_TAG TX, USA.
US_TX_LAREDO_TRADE_TAG TX, USA.
US_TX_PLUSPASS TX, USA.
US_TX_TOLLTAG TX, USA.
US_TX_TXTAG TX, USA.
US_TX_XPRESS_CARD TX, USA.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT, USA.
US_VA_EZPASSVA VA, USA.
US_WA_BREEZEBY WA, USA.
US_WA_GOOD_TO_GO WA, USA.
US_WV_EZPASSWV WV, USA.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, USA.
US_WV_MOV_PASS WV, USA
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, USA.

TrafficModel

Gibt die Annahmen an, die bei der Berechnung der Reisezeit verwendet werden sollen. Diese Einstellung wirkt sich auf den Wert für die voraussichtliche Reisezeit aus, der in der Antwort im Feld duration zurückgegeben und anhand bisheriger Durchschnittswerte berechnet wird.

Enums
TRAFFIC_MODEL_UNSPECIFIED Nicht verwendet Wenn angegeben, wird standardmäßig BEST_GUESS verwendet.
BEST_GUESS Gibt an, dass die zurückgegebene duration die beste Schätzung der Reisezeit sein sollte. Dazu werden Verlaufs- und Echtzeitdaten zur Verkehrslage herangezogen. Die aktuelle Verkehrslage wird umso stärker gewichtet, je näher die departure_time rückt.
PESSIMISTIC Gibt an, dass die zurückgegebene Dauer an den meisten Tagen länger als die tatsächliche Reisezeit sein sollte. An Tagen mit besonders schlechter Verkehrslage kann dieser Wert jedoch überschritten werden.
OPTIMISTIC Gibt an, dass die zurückgegebene Dauer an den meisten Tagen kürzer als die tatsächliche Reisezeit sein sollte. An Tagen mit besonders guter Verkehrslage kann dieser Wert jedoch unterschritten werden.

TransitAgency

Ein Betreiber, der eine ÖPNV-Linie betreibt.

Felder
name

string

Der Name des Betreibers.
phone_number

string

Die länderspezifische Telefonnummer des Betreibers.
uri

string

Der URI des Betreibers.

TransitLine

Enthält Informationen zur in diesem Schritt verwendeten ÖPNV-Linie.

Felder
agencies[]

TransitAgency

Der Betreiber oder die Betreiber, die diese ÖPNV-Linie betreiben.
name

string

Der vollständige Name der ÖPNV-Linie, z. B. „8 Avenue Local“.
uri

string

den URI für die ÖPNV-Linie, der vom Betreiber bereitgestellt wird.
color

string

Die Farbe, die üblicherweise für die Beschilderung dieser Linie verwendet wird. Hexadezimal dargestellt.
icon_uri

string

Der URI für das Symbol, das dieser Linie zugeordnet ist.
name_short

string

Der Kurzname dieser ÖPNV-Linie. Das ist normalerweise eine Nummer wie „M7“ oder „355“.
text_color

string

Die Farbe, die üblicherweise für die Beschilderung dieser Linie verwendet wird. Hexadezimal dargestellt.
vehicle

TransitVehicle

Der Fahrzeugtyp, der auf dieser ÖPNV-Linie eingesetzt wird.

TransitPreferences

Einstellungen für TRANSIT-basierte Routen, die sich auf die zurückgegebene Route auswirken.

Felder
allowed_travel_modes[]

TransitTravelMode

Eine Reihe von Mobilitätsformen, die beim Abrufen einer TRANSIT-Route verwendet werden können. Standardmäßig sind alle unterstützten Mobilitätsformen ausgewählt.
routing_preference

TransitRoutingPreference

Eine Routing-Einstellung, die die zurückgegebene TRANSIT-Route beeinflusst.

TransitRoutingPreference

Gibt die Routingeinstellungen für Routen mit öffentlichen Verkehrsmitteln an.

Enums
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED Es wurde keine Präferenz angegeben.
LESS_WALKING Gibt an, dass die berechnete Route möglichst wenige Gehstrecken enthalten soll.
FEWER_TRANSFERS Gibt an, dass die berechnete Route möglichst wenige Umstiege beinhalten soll.

TransitTravelMode

Eine Reihe von Werten, mit denen das Verkehrsmittel angegeben wird.

Enums
TRANSIT_TRAVEL_MODE_UNSPECIFIED Es wurde keine Mobilitätsform für öffentliche Verkehrsmittel angegeben.
BUS Mit dem Bus fahren
SUBWAY Mit der U-Bahn fahren
TRAIN Mit dem Zug reisen
LIGHT_RAIL Mit der Stadtbahn oder Straßenbahn fahren
RAIL Mit der Bahn reisen Dies entspricht einer Kombination aus SUBWAY, TRAIN und LIGHT_RAIL.

TransitStop

Informationen zu einer Haltestelle.

Felder
name

string

Der Name der Haltestelle.
location

Location

Der Standort der Haltestelle oder des Bahnhofs in Breiten-/Längengradkoordinaten.

TransitVehicle

Informationen zu einem Fahrzeug, das auf ÖPNV-Routen eingesetzt wird.

Felder
name

LocalizedText

Der Name dieses Fahrzeugs, großgeschrieben.
type

TransitVehicleType

Der verwendete Fahrzeugtyp.
icon_uri

string

Die URI für ein Symbol, das mit diesem Fahrzeugtyp verknüpft ist.
local_icon_uri

string

Der URI für das Symbol, das diesem Fahrzeugtyp zugeordnet ist, und basiert auf der Beschilderung.

TransitVehicleType

Der Fahrzeugtyp für ÖPNV-Routen.

Enums
TRANSIT_VEHICLE_TYPE_UNSPECIFIED Nicht verwendet
BUS Bus
CABLE_CAR Ein Fahrzeug, das über Kabel betrieben wird, normalerweise am Boden. Luftseilbahnen haben den Typ GONDOLA_LIFT.
COMMUTER_TRAIN Schnellbahn
FERRY Fähre
FUNICULAR Ein Fahrzeug, das mit einem Kabel eine starke Steigung hinaufgezogen wird. Besteht normalerweise aus zwei Wagen, von denen einer als Gegengewicht zum anderen dient.
GONDOLA_LIFT Eine Luftseilbahn.
HEAVY_RAIL Eisenbahn
HIGH_SPEED_TRAIN Schnellzug
INTERCITY_BUS Fernbus
LONG_DISTANCE_TRAIN Fernzug.
METRO_RAIL Stadtbahn
MONORAIL Einschienenbahn
OTHER Alle anderen Fahrzeuge
RAIL Schienenverkehr
SHARE_TAXI Sammeltaxi
SUBWAY U-Bahn
TRAM Straßenbahn
TROLLEYBUS Oberleitungsbus

Einheiten

Eine Reihe von Werten, die die Maßeinheit angeben, die in der Anzeige verwendet wird.

Enums
UNITS_UNSPECIFIED Maßeinheiten nicht angegeben. Standardmäßig wird die aus der Anfrage abgeleitete Maßeinheit verwendet.
METRIC Metrische Maßeinheiten.
IMPERIAL Angloamerikanische Maßeinheiten

VehicleEmissionType

Eine Reihe von Werten, die den Emissionstyp des Fahrzeugs beschreiben. Gilt nur für den DRIVE RouteTravelMode.

Enums
VEHICLE_EMISSION_TYPE_UNSPECIFIED Es wurde kein Emissionstyp angegeben. Standardeinstellung ist GASOLINE.
GASOLINE Benzinfahrzeug
ELECTRIC Ein elektrisch betriebenes Fahrzeug.
HYBRID Hybridfahrzeug (z. B. Benzin- und Elektromotor)
DIESEL Dieselfahrzeug

VehicleInfo

Enthält die Fahrzeuginformationen, z. B. den Fahrzeugemissionstyp.

Felder
emission_type

VehicleEmissionType

Beschreibt den Emissionstyp des Fahrzeugs. Gilt nur für den DRIVE RouteTravelMode.

Zwischenstopp

Kapselt einen Wegpunkt ein. Wegpunkte markieren sowohl den Anfang als auch das Ende einer Route und umfassen Zwischenstopps entlang der Route.

Felder
via

bool

Dieser Wegpunkt wird als Meilenstein und nicht als Haltepunkt gekennzeichnet. Für jeden Zwischenstopp in der Anfrage wird in der Antwort ein Eintrag an das legs-Array angehängt, um die Details zu den Zwischenstopps auf diesem Teil der Fahrt anzugeben. Legen Sie diesen Wert auf „wahr“ fest, wenn die Route diesen Wegpunkt passieren soll, ohne dort anzuhalten. Über Wegpunkte wird dem Array legs kein Eintrag hinzugefügt, die Route wird jedoch über den Wegpunkt geleitet. Sie können diesen Wert nur für Zwischenziele festlegen. Die Anfrage schlägt fehl, wenn Sie dieses Feld für Endpunkt-Wegpunkte festlegen. Wenn ComputeRoutesRequest.optimize_waypoint_order auf „true“ gesetzt ist, kann dieses Feld nicht auf „true“ gesetzt werden. Andernfalls schlägt die Anfrage fehl.
vehicle_stopover

bool

Gibt an, dass der Wegpunkt für Fahrzeuge gedacht ist, die anhalten sollen, um Personen aufzunehmen oder abzusetzen. Wenn Sie diesen Wert festlegen, enthält die berechnete Route keine via-Wegpunkte auf Straßen, die für die Abholung und Absetzung nicht geeignet sind. Diese Option funktioniert nur für die Mobilitätsarten DRIVE und TWO_WHEELER und wenn location_type Location ist.
side_of_road

bool

Gibt an, dass das Fahrzeug am Standort dieses Wegpunkts an einer bestimmten Straßenseite halten soll. Wenn Sie diesen Wert festlegen, führt die Route durch den Standort, damit das Fahrzeug an der Straßenseite anhalten kann, die vom Standort aus gesehen auf der rechten Seite der Straße liegt. Diese Option funktioniert nur für DRIVE und TWO_WHEELER RouteTravelMode.
Union-Feld location_type. Verschiedene Möglichkeiten, einen Standort darzustellen. Für location_type ist nur einer der folgenden Werte zulässig:
location

Location

Ein Punkt, der anhand von geografischen Koordinaten angegeben ist, einschließlich einer optionalen Richtung.
place_id

string

Die POI-Orts-ID, die mit dem Wegpunkt verknüpft ist.
address

string

Eine für Menschen lesbare Adresse oder ein Plus Code. Weitere Informationen finden Sie unter https://plus.codes.