Package google.maps.routing.v2

Index

Routen

Routes API

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

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

HINWEIS:Für diese Methode müssen Sie im Input eine Antwortfeldmaske angeben. Sie können die Feldmaske für die Antwort 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. Ausführliche Informationen zum Erstellen der Feldpfade

Beispiel:

  • Feldmaske aller verfügbaren Felder (zur manuellen Überprüfung): X-Goog-FieldMask: *
  • Feldmaske für Routendauern, ‑entfernungen, Elementstatus, Bedingung und Elementindexe (Beispiel für die Produktionseinrichtung): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

Es ist wichtig, dass Sie status in Ihre Feldmaske aufnehmen, da sonst alle Nachrichten als OK angezeigt werden. Google rät von der Verwendung der Platzhalter-Antwortfeldmaske (*) ab, da:

  • Wenn Sie nur die benötigten Felder auswählen, kann unser Server Rechenzyklen sparen und wir können Ihnen das Ergebnis mit einer geringeren Latenz zurückgeben.
  • Wenn Sie nur die Felder auswählen, die Sie für Ihren Produktionsjob benötigen, wird eine stabile Latenzleistung gewährleistet. Möglicherweise fügen wir in Zukunft weitere Antwortfelder hinzu. Diese neuen Felder erfordern möglicherweise zusätzliche Rechenzeit. Wenn Sie alle Felder oder alle Felder auf der obersten 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 Antwortgröße kleiner und der Netzwerkdurchsatz höher.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Gibt die primäre Route zusammen mit optionalen alternativen Routen zurück, wenn eine Reihe von End- und Zwischenwegpunkten angegeben wird.

HINWEIS:Für diese Methode müssen Sie im Input eine Antwortfeldmaske angeben. Sie können die Feldmaske für die Antwort 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. Ausführliche Dokumentation zum Erstellen der Feldpfade

Beispiel:

  • Feldmaske aller verfügbaren Felder (zur manuellen Überprüfung): X-Goog-FieldMask: *
  • Feldmaske für Dauer, Entfernung und Polylinie auf Routenebene (Beispiel für die Produktionseinrichtung): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google rät von der Verwendung der Platzhalter-Feldmaske (*) oder der Angabe der Feldmaske auf oberster Ebene (routes) ab, da:

  • Wenn Sie nur die benötigten Felder auswählen, kann unser Server Rechenzyklen sparen und wir können Ihnen das Ergebnis mit einer geringeren Latenz zurückgeben.
  • Wenn Sie nur die Felder auswählen, die Sie für Ihren Produktionsjob benötigen, wird eine stabile Latenzleistung gewährleistet. Möglicherweise fügen wir in Zukunft weitere Antwortfelder hinzu. Diese neuen Felder erfordern möglicherweise zusätzliche Rechenzeit. Wenn Sie alle Felder oder alle Felder auf der obersten 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 Antwortgröße kleiner und der Netzwerkdurchsatz höher.

ComputeRouteMatrixRequest

ComputeRouteMatrix-Anfragenachricht

Felder
origins[]

RouteMatrixOrigin

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

  • Die Summe der Anzahl der als place_id oder address angegebenen Start- und Zielorte darf nicht mehr als 50 betragen.
  • Das Produkt aus der Anzahl der Startpunkte und der Anzahl der Zielorte darf in keinem Fall größer als 625 sein.
  • Das Produkt aus der Anzahl der Startpunkte × Anzahl der Ziele darf nicht größer als 100 sein, wenn „routing_preference“ auf TRAFFIC_AWARE_OPTIMAL festgelegt ist.
  • Das Produkt aus der Anzahl der Startorte × Anzahl der Zielorte darf nicht größer als 100 sein, wenn „travel_mode“ auf TRANSIT festgelegt ist.
destinations[]

RouteMatrixDestination

Erforderlich. Array von Zielvorhaben, 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 einer besonders langen Latenz führt, wird ein Fehler zurückgegeben. Sie können diese Option nur angeben, 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 Zeit verwendet, zu der Sie die Anfrage gestellt haben. HINWEIS: Sie können nur ein departure_time in der Vergangenheit angeben, wenn RouteTravelMode auf TRANSIT festgelegt 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 beides.

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 Ländercode-Top-Level-Domains.

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: Durch diese zusätzlichen Berechnungen können zusätzliche Felder in der Antwort zurückgegeben werden. Diese zusätzlichen Felder müssen auch in der Feldmaske angegeben werden, damit sie in der Antwort zurückgegeben werden.

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 TrafficModel ist nur für Anfragen verfügbar, bei denen RoutingPreference auf TRAFFIC_AWARE_OPTIMAL und RouteTravelMode auf DRIVE festgelegt ist. Der Standardwert ist BEST_GUESS, wenn Verkehrsdaten angefordert werden und TrafficModel nicht angegeben ist.

transit_preferences

TransitPreferences

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

ExtraComputation

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

Enums
EXTRA_COMPUTATION_UNSPECIFIED Nicht verwendet. Anfragen mit diesem Wert schlagen fehl.
TOLLS Mautinformationen für das/die Matrixelement(e).

ComputeRoutesRequest

ComputeRoutes-Anfragenachricht.

Felder
origin

Waypoint

Erforderlich. Start-Wegpunkt.

destination

Waypoint

Erforderlich. Ziel-Wegpunkt.

intermediates[]

Waypoint

Optional. Eine Reihe von Wegpunkten entlang der Route (mit Ausnahme der Endpunkte), an denen entweder angehalten oder vorbeigefahren wird. 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 einer besonders langen Latenz führt, wird ein Fehler zurückgegeben. Sie können diese Option nur angeben, wenn travel_mode den Wert DRIVE oder TWO_WHEELER hat. Andernfalls schlägt die Anfrage fehl.

polyline_quality

PolylineQuality

Optional. Gibt Ihre Einstellung für die 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 Zeit verwendet, zu der Sie die Anfrage gestellt haben. HINWEIS: Sie können nur ein departure_time in der Vergangenheit angeben, wenn RouteTravelMode auf TRANSIT festgelegt ist. Öffentliche Verkehrsmittel sind für bis zu 7 Tage in der Vergangenheit oder 100 Tage in der Zukunft verfügbar.

arrival_time

Timestamp

Optional. Die Ankunftszeit. HINWEIS: Dieses Feld wird ignoriert, wenn in Anfragen ein anderer RouteTravelMode als TRANSIT angegeben wird. Sie können entweder departure_time oder arrival_time angeben, aber nicht beides. Öffentliche Verkehrsmittel sind für 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 Wegpunkten werden keine alternativen Routen zurückgegeben.

route_modifiers

RouteModifiers

Optional. Eine Reihe von Bedingungen, die erfüllt werden müssen und die 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 Ländercode-Top-Level-Domains.

units

Units

Optional. Gibt die Maßeinheiten für die Anzeigefelder an. Zu diesen Feldern gehört das Feld instruction in NavigationInstruction. Die für die Entfernung und Dauer von Route, Abschnitt und Schritt verwendeten Maßeinheiten 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 auf „true“ gesetzt, versucht der Dienst, die Gesamtkosten der Route zu minimieren, indem er die angegebenen Zwischenziele neu anordnet. Die Anfrage schlägt fehl, wenn einer der Zwischenwegpunkte ein via-Wegpunkt ist. Mit ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index können Sie die neue Reihenfolge 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, um eine optimale, kraftstoffsparende Route zu erstellen. Achten Sie bei der Verwendung dieser Funktion auf route_labels in den resultierenden Routen.

extra_computations[]

ExtraComputation

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

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) in 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 festgelegt ist. Der Standardwert ist BEST_GUESS, wenn Verkehrsdaten angefordert werden und TrafficModel nicht angegeben ist.

transit_preferences

TransitPreferences

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

ExtraComputation

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

Enums
EXTRA_COMPUTATION_UNSPECIFIED Nicht verwendet. Anfragen mit diesem Wert schlagen fehl.
TOLLS Mautinformationen für die Route(n).
FUEL_CONSUMPTION Geschätzter Kraftstoffverbrauch für die Route(n).
TRAFFIC_ON_POLYLINE Polylinien für die Route(n), die die aktuelle Verkehrslage berücksichtigen.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions wird als formatierter HTML-Textstring dargestellt. Dieser Inhalt ist so zu lesen, wie er ist. Er dient nur zur Anzeige. Wir raten davon ab, diesen Code programmatisch zu parsen.
FLYOVER_INFO_ON_POLYLINE Informationen zu Überflügen für die Route(n). Die routes.polyline_details.flyover_info-Feldmaske 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/Gebühr kann sich ändern.
NARROW_ROAD_INFO_ON_POLYLINE Informationen zu schmalen Straßen für die Route(n). Die routes.polyline_details.narrow_road_info-Feldmaske 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/Gebühr kann sich ändern.

ReferenceRoute

Eine unterstützte Referenzroute im 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 bei dieser Funktion die kürzere Strecke gegenüber dem Fahrkomfort priorisiert. So werden beispielsweise unter Umständen Landstraßen statt Autobahnen bevorzugt, Schotterstraßen befahren oder Parkplätze durchquert. Diese Funktion gibt keine Manöver zurück, die Google Maps als illegal erkennt.

Für BICYCLE- und TWO_WHEELER-Anfragen werden mit dieser Funktion Routen zurückgegeben, die denen ähneln, die zurückgegeben werden, wenn Sie requested_reference_routes nicht angeben.

Diese Funktion ist nicht mit anderen Verkehrsmitteln, Zwischenwegpunkten oder optimize_waypoint_order kompatibel. Solche Anfragen schlagen fehl. Sie können es jedoch mit jedem routing_preference verwenden.

ComputeRoutesResponse

Die Antwortnachricht für ComputeRoutes.

Felder
routes[]

Route

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

fallback_info

FallbackInfo

In einigen Fällen, in denen der Server die Routenergebnisse nicht mit allen Eingabeeinstellungen berechnen kann, wird möglicherweise auf eine andere Berechnungsmethode zurückgegriffen. 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 Informationen zur Geocoding-Antwort für Wegpunkte, die als Adressen angegeben sind.

FallbackInfo

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

Felder
routing_mode

FallbackRoutingMode

Für die Antwort verwendeter Routingmodus. Wenn ein Fallback ausgelöst wurde, kann sich der Modus von der in der ursprünglichen Clientanfrage festgelegten Routing-Einstellung unterscheiden.

reason

FallbackReason

Der Grund, warum anstelle der ursprünglichen Antwort eine 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 Fallback-Grund angegeben.
SERVER_ERROR Beim Berechnen von Routen mit Ihrem bevorzugten Routing-Modus ist ein Serverfehler aufgetreten. Wir konnten jedoch ein Ergebnis zurückgeben, das mit einem alternativen Modus berechnet wurde.
LATENCY_EXCEEDED Die Berechnung mit Ihrem bevorzugten Routing-Modus konnte nicht rechtzeitig abgeschlossen werden. Wir konnten jedoch 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 TRAFFIC_UNAWARE RoutingPreference zur Berechnung der Antwort verwendet wurde.
FALLBACK_TRAFFIC_AWARE Gibt an, dass TRAFFIC_AWARE RoutingPreference zur Berechnung der Antwort verwendet wurde.

GeocodedWaypoint

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

Felder
geocoder_status

Status

Gibt den Statuscode des Geocoding-Vorgangs an.

type[]

string

Der Typ bzw. 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 Zwischenzielpunkts in der Anfrage. Wird nur ausgefüllt, wenn der entsprechende Wegpunkt ein Zwischenwegpunkt ist.

GeocodingResults

Enthält GeocodedWaypoints für Startort, Zielort und Zwischenwegpunkte. Wird nur für Adressen-Wegpunkte ausgefüllt.

Felder
origin

GeocodedWaypoint

Geocodierter Wegpunkt für den Startort.

destination

GeocodedWaypoint

Geocodierter Zielwegpunkt.

intermediates[]

GeocodedWaypoint

Eine Liste mit geocodierten Zwischenwegpunkten, die jeweils ein Indexfeld enthalten, das der nullbasierten Position des Wegpunkts in der Reihenfolge entspricht, in der sie in der Anfrage angegeben wurden.

LocalizedTime

Lokalisierte Beschreibung der Zeit.

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

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

Felder
lat_lng

LatLng

Die geografischen Koordinaten des Wegpunkts.

heading

Int32Value

Die Kompassausrichtung, die der Richtung des Verkehrsflusses zugeordnet ist. Dieser Wert gibt die Straßenseite für die Abholung und das Absetzen an. Die Werte für die Richtung können zwischen 0 und 360 liegen. Dabei steht 0 für Norden, 90 für Osten usw. Sie können dieses Feld nur für DRIVE und TWO_WHEELER RouteTravelMode verwenden.

Maneuver

Eine Reihe von Werten, die die Navigationsaktion für den aktuellen Schritt angeben (z. B. „Links abbiegen“, „Einordnen“ oder „Geradeaus“).

Enums
MANEUVER_UNSPECIFIED Nicht verwendet.
TURN_SLIGHT_LEFT Drehe dich leicht nach links.
TURN_SHARP_LEFT Biegen Sie scharf links ab.
UTURN_LEFT Bitte wenden.
TURN_LEFT Biegen Sie links ab.
TURN_SLIGHT_RIGHT Drehe dich leicht nach rechts.
TURN_SHARP_RIGHT Biegen Sie scharf rechts ab.
UTURN_RIGHT Machen Sie eine Rechtskurve.
TURN_RIGHT Biegen Sie rechts ab.
STRAIGHT Gehen Sie geradeaus.
RAMP_LEFT Nehmen Sie die linke Rampe.
RAMP_RIGHT Nehmen Sie die rechte Rampe.
MERGE Fahren Sie in den fließenden Verkehr ein.
FORK_LEFT Nimm die linke Abzweigung.
FORK_RIGHT Nimm die rechte Abzweigung.
FERRY Nimm die Fähre.
FERRY_TRAIN Nehmen Sie den Zug, der auf die Fähre führt.
ROUNDABOUT_LEFT Biegen Sie beim Kreisverkehr links ab.
ROUNDABOUT_RIGHT Biegen Sie beim Kreisverkehr rechts ab.
DEPART Erstes Manöver
NAME_CHANGE Wird verwendet, um eine Änderung des Straßennamens anzugeben.

Kapselt Navigationsanweisungen für ein RouteLegStep.

Felder
maneuver

Maneuver

Enthält die Navigationsanweisungen für den aktuellen Schritt (z. B. „Links abbiegen“, „Einfädeln“ oder „Geradeaus“). In diesem Feld wird festgelegt, welches Symbol angezeigt werden soll.

instructions

string

Anleitung für diesen Schritt.

Polyline

Kapselt eine codierte Polylinie.

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

string

Die String-Codierung der Polylinie mit dem Algorithmus für codierte Polylinien

geo_json_linestring

Struct

Gibt eine Polylinie im GeoJSON-Format „LineString“ an.

PolylineDetails

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

Felder
flyover_info[]

FlyoverInfo

Flyover-Details entlang der Polylinie.

narrow_road_info[]

NarrowRoadInfo

Details zu schmalen Straßen entlang der Polylinie.

FlyoverInfo

Enthält Informationen zu Überflügen entlang der Polylinie.

Felder
flyover_presence

RoadFeatureState

Nur Ausgabe. Gibt an, ob für einen bestimmten Abschnitt der Polylinie ein Flyover vorhanden ist.

polyline_point_index

PolylinePointIndex

Die Position von Flyover-bezogenen Informationen 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

Die Position von Informationen zu schmalen Straßen entlang der Polylinie.

PolylinePointIndex

Kapselt die Start- und Endindexe für ein Polyliniendetail. In Fällen, in denen 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ßenmerkmalen entlang eines Polylinienabschnitts.

Enums
ROAD_FEATURE_STATE_UNSPECIFIED Der Status des Straßenelements wurde nicht berechnet (Standardwert).
EXISTS Die Straße ist vorhanden.
DOES_NOT_EXIST Das Straßenmerkmal ist nicht vorhanden.

PolylineEncoding

Gibt den bevorzugten Typ der zurückzugebenden Polylinie an.

Enums
POLYLINE_ENCODING_UNSPECIFIED Es wurde keine Einstellung für den Polylinentyp 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-Format „LineString“ an.

PolylineQuality

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

Enums
POLYLINE_QUALITY_UNSPECIFIED Es wurde keine Einstellung für die Qualität der Polylinie angegeben. Die Standardeinstellung ist OVERVIEW.
HIGH_QUALITY Gibt eine hochwertige Polylinie an, die aus mehr Punkten als OVERVIEW besteht. Dies führt zu einer größeren Antwort. Verwenden Sie diesen Wert, wenn Sie mehr Präzision benötigen.
OVERVIEW Gibt eine Übersichtspolylinie an, die aus einer kleinen Anzahl von Punkten besteht. Verwenden Sie diesen Wert, wenn Sie eine Übersicht der Route anzeigen. Bei dieser Option ist die Anfrage-Latenz geringer als bei der Option HIGH_QUALITY.

Route

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

Felder
route_labels[]

RouteLabel

Labels für die Route, mit denen sich bestimmte Eigenschaften der Route identifizieren lassen, die mit anderen verglichen werden sollen.

legs[]

RouteLeg

Eine Sammlung von Abschnitten (Pfadsegmente zwischen Wegpunkten), aus denen die Route besteht. Jede Etappe entspricht der Fahrt zwischen zwei nicht via Waypoints. Eine Route ohne Zwischenziele hat beispielsweise nur einen Abschnitt. Eine Route mit einem Zwischenziel, das kein via ist, hat zwei Abschnitte. Eine Route mit einem via-Zwischenziel hat einen Abschnitt. Die Reihenfolge der Abschnitte entspricht der Reihenfolge der Wegpunkte von origin über intermediates nach destination.

distance_meters

int32

Die zurückzulegende Strecke der Route in Metern.

duration

Duration

Die Zeit, die für die Navigation auf der Route benötigt wird. Wenn Sie routing_preference auf TRAFFIC_UNAWARE festlegen, entspricht dieser Wert static_duration. 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.

polyline

Polyline

Die gesamte Routen-Polylinie. Diese Polylinie ist die kombinierte Polylinie aller legs.

description

string

Eine Beschreibung der Route.

warnings[]

string

Ein Array mit Warnungen, die beim Anzeigen der Route eingeblendet werden sollen.

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 „true“ setzen, enthält dieses Feld die optimierte Reihenfolge der Zwischenwegpunkte. Andernfalls ist dieses Feld leer. Wenn Sie beispielsweise die Eingabe „Origin: LA; Intermediate waypoints: Dallas, Bangor, Phoenix; Destination: New York“ (Startpunkt: Los Angeles; Zwischenziele: Dallas, Bangor, Phoenix; Ziel: New York) machen und die optimierte Reihenfolge der Zwischenziele „Phoenix, Dallas, Bangor“ lautet, enthält dieses Feld die Werte [2, 0, 1]. Der Index beginnt mit 0 für den ersten Zwischen-Waypoint in der Eingabe.

localized_values

RouteLocalizedValues

Textdarstellungen von Attributen der Route.

route_token

string

Ein undurchsichtiges Token, das an das Navigation SDK übergeben werden kann, um die Route während der Navigation zu rekonstruieren und bei einer Umleitung die ursprüngliche Absicht beim Erstellen der Route zu berücksichtigen. Behandeln Sie dieses Token als intransparenten Blob. Vergleichen Sie den Wert nicht über Anfragen hinweg, da er sich ändern kann, auch 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 Via-Wegpunkten unterstützt.

polyline_details

PolylineDetails

Enthält Informationen zu Details entlang der Polylinie.

RouteLocalizedValues

Textdarstellungen bestimmter Properties.

Felder
distance

LocalizedText

Die zurückgelegte Entfernung in Textform.

duration

LocalizedText

Die Dauer in Textform, lokalisiert für die Region der Anfrage. Berücksichtigt die Verkehrslage. Hinweis: Wenn Sie keine Verkehrsinformationen angefordert haben, entspricht dieser Wert dem Wert von static_duration.

static_duration

LocalizedText

Dauer ohne Berücksichtigung der Verkehrslage in Textform.

transit_fare

LocalizedText

Der Fahrpreis für öffentliche Verkehrsmittel wird in Textform dargestellt.

RouteLabel

Labels für die Route, mit denen sich bestimmte Eigenschaften der Route identifizieren lassen, die mit anderen verglichen werden sollen.

Enums
ROUTE_LABEL_UNSPECIFIED Standard: 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“. Solche Routen werden zurückgegeben, wenn compute_alternative_routes angegeben ist.
FUEL_EFFICIENT Spritsparende Route. Routen mit diesem Wert sind für ökologische Parameter wie den Kraftstoffverbrauch optimiert.
SHORTER_DISTANCE Route mit kürzerer Fahrstrecke. Dies ist eine experimentelle Funktion.

RouteLeg

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

Felder
distance_meters

int32

Die zurückgelegte Strecke des Routenabschnitts in Metern.

duration

Duration

Die Zeit, die für die Navigation auf dem Abschnitt benötigt wird. Wenn route_preference auf TRAFFIC_UNAWARE gesetzt ist, entspricht dieser Wert static_duration. Wenn route_preference entweder TRAFFIC_AWARE oder TRAFFIC_AWARE_OPTIMAL ist, wird dieser Wert unter Berücksichtigung der Verkehrsbedingungen berechnet.

static_duration

Duration

Die Dauer der Reise auf dem Abschnitt, berechnet ohne Berücksichtigung der Verkehrsbedingungen.

polyline

Polyline

Der gesamte Linienzug für diesen Abschnitt, der den Linienzug jedes step enthält.

start_location

Location

Der Startort dieses Abschnitts. Dieser Standort kann sich von der angegebenen origin unterscheiden. Wenn die angegebene origin beispielsweise nicht in der Nähe einer Straße liegt, 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 die angegebene destination beispielsweise nicht in der Nähe einer Straße liegt, ist dies ein Punkt auf der Straße.

steps[]

RouteLegStep

Ein Array von Schritten, die Segmente innerhalb dieses Legs darstellen. Jeder Schritt entspricht einer Navigationsanweisung.

travel_advisory

RouteLegTravelAdvisory

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

localized_values

RouteLegLocalizedValues

Textdarstellungen von Attributen der RouteLeg.

steps_overview

StepsOverview

Übersichtsinformationen zu den Schritten in diesem RouteLeg. Dieses Feld wird nur für Routen mit öffentlichen Verkehrsmitteln ausgefüllt.

RouteLegLocalizedValues

Textdarstellungen bestimmter Properties.

Felder
distance

LocalizedText

Die zurückgelegte Entfernung in Textform.

duration

LocalizedText

Die Dauer in Textform, lokalisiert für die Region der Anfrage. Berücksichtigt die Verkehrslage. Hinweis: Wenn Sie keine Verkehrsinformationen angefordert haben, entspricht dieser Wert dem Wert von „static_duration“.

static_duration

LocalizedText

Dauer ohne Berücksichtigung der Verkehrslage in Textform.

StepsOverview

Bietet einen Überblick über eine Liste von RouteLegSteps.

Felder
multi_modal_segments[]

MultiModalSegment

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

MultiModalSegment

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

Felder
navigation_instruction

NavigationInstruction

NavigationInstruction für das multimodale Segment.

travel_mode

RouteTravelMode

Das Transportmittel des multimodalen Segments.

step_start_index

int32

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

step_end_index

int32

Der entsprechende RouteLegStep-Index, der das Ende eines multimodalen Segments darstellt.

RouteLegStep

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

Felder
distance_meters

int32

Die zurückgelegte Strecke dieses Schritts in Metern. Unter Umständen hat dieses Feld keinen Wert.

static_duration

Duration

Die Dauer der Fahrt durch diesen Schritt ohne Berücksichtigung der Verkehrsbedingungen. Unter Umständen hat dieses Feld keinen Wert.

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

Hinweise zur Navigation.

travel_advisory

RouteLegStepTravelAdvisory

Enthält die zusätzlichen Informationen, über die der Nutzer in einem Leg-Schritt informiert werden sollte, z. B. mögliche Einschränkungen für Verkehrszonen.

localized_values

RouteLegStepLocalizedValues

Textdarstellungen von Attributen der RouteLegStep.

transit_details

RouteLegStepTransitDetails

Details zu diesem Schritt, wenn der Fortbewegungsmodus TRANSIT ist.

travel_mode

RouteTravelMode

Die für diesen Schritt verwendete Art der Fortbewegung.

RouteLegStepLocalizedValues

Textdarstellungen bestimmter Properties.

Felder
distance

LocalizedText

Die zurückgelegte Entfernung in Textform.

static_duration

LocalizedText

Dauer ohne Berücksichtigung der Verkehrslage in Textform.

RouteLegStepTransitDetails

Zusätzliche Informationen für die RouteLegStep in Bezug auf TRANSIT-Routen.

Felder
stop_details

TransitStopDetails

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

localized_values

TransitDetailsLocalizedValues

Textdarstellungen von Attributen 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 „Headway seconds“ 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 von der Abfahrts- bis zur 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 Anzeigetafeln erscheint, um eine Fahrt mit öffentlichen Verkehrsmitteln für Fahrgäste zu kennzeichnen. Der Text sollte eine Fahrt innerhalb eines Betriebstags eindeutig identifizieren. Beispiel: „538“ ist die trip_short_text des Amtrak-Zugs, der wochentags um 15:10 Uhr von San Jose, CA, nach Sacramento, CA, fährt.

TransitDetailsLocalizedValues

Lokalisierte Beschreibungen der Werte für RouteTransitDetails.

Felder
arrival_time

LocalizedTime

Die Zeit in ihrer formatierten Textdarstellung mit einer entsprechenden Zeitzone.

departure_time

LocalizedTime

Die Zeit in ihrer formatierten Textdarstellung mit einer entsprechenden Zeitzone.

TransitStopDetails

Details zu den Haltestellen für die 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 die zusätzlichen Informationen, über die der Nutzer informiert werden sollte, z. B. mögliche Einschränkungen der Verkehrszone für einen Beinabschnitt.

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 Leg-Schritt informiert werden sollte, z. B. mögliche Einschränkungen der Verkehrszone.

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 auf der Straße Mautgebühren anfallen, wir aber keinen geschätzten Preis kennen. Wenn dieses Feld nicht vorhanden ist, wird für die RouteLeg keine Maut erhoben.

speed_reading_intervals[]

SpeedReadingInterval

Schnellleseintervalle mit Angaben zur Verkehrsdichte. Gilt für die Routing-Einstellungen TRAFFIC_AWARE und TRAFFIC_AWARE_OPTIMAL. Die Intervalle decken die gesamte Polylinie von RouteLeg ohne Überschneidung ab. Der Startpunkt eines angegebenen Intervalls ist derselbe wie der Endpunkt des vorherigen Intervalls.

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

RouteMatrixElement

Enthält Routeninformationen, die für ein Start- und 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. Unabhängig vom Status.

distance_meters

int32

Die zurückzulegende Strecke der Route in Metern.

duration

Duration

Die Zeit, die für die Navigation auf der Route benötigt wird. Wenn Sie routing_preference auf TRAFFIC_UNAWARE festlegen, entspricht dieser Wert static_duration. 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. Beispiele: Informationen zu Einschränkungen und Mautgebühren

fallback_info

FallbackInfo

In einigen Fällen, in denen der Server die Route mit den angegebenen Einstellungen für dieses bestimmte Start-/Zielpaar nicht berechnen kann, wird möglicherweise auf einen anderen Berechnungsmodus zurückgegriffen. 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 Attributen der RouteMatrixElement.

origin_index

int32

Nullbasierter Index des Ursprungs in der Anfrage.

destination_index

int32

Nullbasierter Index des Ziels in der Anfrage.

LocalizedValues

Textdarstellungen bestimmter Properties.

Felder
distance

LocalizedText

Die zurückgelegte Entfernung in Textform.

duration

LocalizedText

Dauer in Textform unter Berücksichtigung der Verkehrslage. Hinweis: Wenn keine Verkehrsinformationen angefordert wurden, entspricht dieser Wert dem Wert von „static_duration“.

static_duration

LocalizedText

Dauer in Textform, ohne Berücksichtigung der Verkehrsbedingungen.

transit_fare

LocalizedText

Der Fahrpreis für öffentliche Verkehrsmittel wird in Textform dargestellt.

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 Es wurde eine Route gefunden und die entsprechenden Informationen wurden 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

Ein einzelner Ursprung für ComputeRouteMatrixRequest

Felder
waypoint

Waypoint

Erforderlich. Ausgangspunkt

route_modifiers

RouteModifiers

Optional. Modifikatoren für jede Route, die diesen Ort als Ausgangspunkt verwendet

RouteModifiers

Kapselt eine Reihe optionaler Bedingungen, die beim Berechnen der Routen erfüllt sein müssen.

Felder
avoid_tolls

bool

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

avoid_highways

bool

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

avoid_ferries

bool

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

avoid_indoor

bool

Wenn der Wert auf „true“ gesetzt ist, wird die Navigation in Innenräumen nach Möglichkeit vermieden und Routen ohne Navigation in Innenräumen werden bevorzugt. Gilt nur für die WALK RouteTravelMode.

vehicle_info

VehicleInfo

Gibt die Fahrzeuginformationen an.

toll_passes[]

TollPass

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

RouteTravelAdvisory

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

Felder
toll_info

TollInfo

Enthält Informationen zu Mautgebühren auf der Route. Dieses Feld wird nur ausgefüllt, wenn auf der Route mit Mautgebühren zu rechnen ist. Wenn dieses Feld festgelegt ist, das Unterfeld estimatedPrice jedoch 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

Schnellleseintervalle mit Angaben zur Verkehrsdichte. Gilt für die Routing-Einstellungen TRAFFIC_AWARE und TRAFFIC_AWARE_OPTIMAL. Die Intervalle decken die gesamte Polylinie der Route ohne Überschneidung ab. Der Startpunkt eines angegebenen Intervalls ist derselbe wie der Endpunkt des vorherigen Intervalls.

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 aufweisen, die für das angeforderte Verkehrsmittel oder die Routenmodifikatoren nicht geeignet sind.

transit_fare

Money

Falls vorhanden, enthält diese Eigenschaft den Gesamtfahrpreis oder die gesamten Fahrkartenkosten für diese Route. Sie wird nur für TRANSIT-Anfragen zurückgegeben und nur für Routen, für die für alle Schritte mit öffentlichen Verkehrsmitteln Fahrpreisinformationen verfügbar sind.

RouteTravelMode

Eine Reihe von Werten, mit denen die Art der Fortbewegung angegeben wird. HINWEIS: WALK-, BICYCLE- und TWO_WHEELER-Routen befinden sich in der Betaphase und enthalten möglicherweise keine ausgewiesenen Fußgänger- oder Radwege. Sie müssen diese Warnung für alle Fußgänger-, Fahrrad- und Zweiradrouten einblenden, die Sie in Ihrer App anzeigen.

Enums
TRAVEL_MODE_UNSPECIFIED Es wurde keine Fortbewegungsart angegeben. Die Standardeinstellung ist DRIVE.
DRIVE Mit dem Pkw anreisen.
BICYCLE Mit dem Fahrrad reisen.
WALK Zu Fuß unterwegs sein
TWO_WHEELER Zweirädriges, motorisiertes Fahrzeug. Zum Beispiel Motorrad. Diese Mobilitätsform unterscheidet sich von BICYCLE, die von Menschen betriebene Fortbewegungsmittel umfasst.
TRANSIT Nutzen Sie nach Möglichkeit Routen mit öffentlichen Verkehrsmitteln.

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 Routingeinstellung angegeben. Standardeinstellung ist TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Berechnet Routen, ohne die aktuelle Verkehrslage zu berücksichtigen. Geeignet, wenn die Verkehrsbedingungen keine Rolle spielen oder nicht anwendbar sind. Mit diesem Wert wird die niedrigste Latenz erzielt. Hinweis: Für 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 Berechnet Routen unter Berücksichtigung der aktuellen Verkehrslage. Im Gegensatz zu TRAFFIC_AWARE_OPTIMAL werden einige Optimierungen angewendet, um die Latenz deutlich zu reduzieren.
TRAFFIC_AWARE_OPTIMAL Berechnet die Routen unter Berücksichtigung der aktuellen Verkehrslage, ohne die meisten Leistungsoptimierungen anzuwenden. Dieser Wert führt zur höchsten Latenz.

SpeedReadingInterval

Indikator für die Verkehrsdichte auf einem zusammenhängenden Segment einer Polylinie oder eines Pfads. Bei einem Pfad mit den Punkten P_0, P_1, …, P_N (nullbasierter Index) wird mit SpeedReadingInterval ein Intervall definiert und der Traffic anhand der folgenden Kategorien beschrieben.

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

Verkehrsgeschwindigkeit in diesem Intervall.

Geschwindigkeit

Die Klassifizierung der Polylinien-Geschwindigkeit basierend auf Verkehrsdaten.

Enums
SPEED_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
NORMAL Normale Geschwindigkeit, keine Verkehrsbehinderungen.
SLOW Verlangsamung erkannt, mittleres Verkehrsaufkommen.
TRAFFIC_JAM Verkehrsbehinderungen.

TollInfo

Kapselt Mautinformationen für ein Route oder ein RouteLeg.

Felder
estimated_price[]

Money

Der Geldbetrag der Mautgebühren für die entsprechende Route oder RouteLeg. Diese Liste enthält einen Geldbetrag für jede Währung, die voraussichtlich von den Mautstellen berechnet wird. Normalerweise enthält diese Liste nur ein Element für Routen mit Mautgebühren in einer Währung. Bei internationalen Fahrten kann diese Liste mehrere Einträge enthalten, um Mautgebühren in verschiedenen Währungen abzubilden.

TollPass

Liste der Mautkarten weltweit, die wir unterstützen.

Enums
TOLL_PASS_UNSPECIFIED Nicht verwendet. Wenn dieser Wert verwendet wird, schlägt die Anfrage fehl.
AU_ETOLL_TAG Mautpass für Sydney Weitere Informationen finden Sie unter https://www.myetoll.com.au.
AU_EWAY_TAG Mautpass für Sydney Weitere Informationen finden Sie unter https://www.tollpay.com.au.
AU_LINKT Mautpass für ganz Australien. Weitere Informationen finden Sie unter https://www.linkt.com.au/.
AR_TELEPASE Mautpass für Argentinien. Weitere Informationen finden Sie unter https://telepase.com.ar.
BR_AUTO_EXPRESO Mautpass für Brasilien. Weitere Informationen finden Sie unter https://www.autoexpreso.com.
BR_CONECTCAR Mautpass für Brasilien. Weitere Informationen finden Sie unter https://conectcar.com.
BR_MOVE_MAIS Mautpass für Brasilien. Weitere Informationen finden Sie unter https://movemais.com.
BR_PASSA_RAPIDO Mautpass für Brasilien. Weitere Informationen finden Sie unter https://pasorapido.gob.do/.
BR_SEM_PARAR Mautpass für Brasilien. Weitere Informationen finden Sie unter https://www.semparar.com.br.
BR_TAGGY Mautpass für Brasilien. Weitere Informationen finden Sie unter https://taggy.com.br.
BR_VELOE Mautpass für Brasilien. Weitere Informationen finden Sie unter https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Grenzübergang von Kanada in die USA.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Grenzübergang von Kanada in die USA.
CA_US_BLUE_WATER_EDGE_PASS Grenzübergang von Ontario, Kanada, nach Michigan, USA.
CA_US_CONNEXION Grenzübergang von Ontario, Kanada, nach Michigan, USA.
CA_US_NEXUS_CARD Grenzübergang von Kanada in die USA.
ID_E_TOLL Indonesien E-Karte, die von mehreren Banken ausgestellt wurde und zum Bezahlen von Mautgebühren verwendet wird. Für alle E-Cards über Banken wird derselbe Betrag berechnet. Daher ist nur ein Enum-Wert erforderlich. z.B. Bank Mandiri https://www.bankmandiri.co.id/e-money, BCA https://www.bca.co.id/flazz, BNI https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG Indien
IN_LOCAL_HP_PLATE_EXEMPT Indien, Befreiung von der Kennzeichenpflicht im Bundesstaat Himachal Pradesh.
JP_ETC Japan ETC. Elektronisches drahtloses System zur Erhebung von Mautgebühren. https://www.go-etc.jp/
JP_ETC2 Japan ETC2.0. Neue Version von ETC mit zusätzlichem 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 Mautkarte für Mexiko: 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 Mautpassunternehmen in Mexiko. Einer von vielen in Mexiko-Stadt. Weitere Informationen finden Sie unter https://www.televia.com.mx.
MX_TELEVIA Mautpassunternehmen in Mexiko. Eines von vielen in Mexiko-Stadt. https://www.televia.com.mx
MX_VIAPASS Mautpass 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, ob der Fahrer zusätzlich zum vom 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 LA, USA.
US_LA_TOLL_TAG LA, 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. Eingestellt, da dieser Pass-Typ nicht mehr vorhanden ist.

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 NJ, USA.
US_NJ_EZPASSNJ NJ, USA.
US_NY_EXPRESSPASS New York, USA.
US_NY_EZPASSNY New York, 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 dürfte. 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 dieses Betreibers.

phone_number

string

Die sprachen- bzw. regionsspezifisch formatierte Telefonnummer des Betreibers.

uri

string

Der URI des Verkehrsverbunds.

TransitLine

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

Felder
agencies[]

TransitAgency

Der Betreiber (oder die Betreiber), der diese ÖPNV-Linie betreibt.

name

string

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

uri

string

die URI für diese ÖPNV-Linie, die vom Betreiber bereitgestellt wird.

color

string

Die Farbe, die üblicherweise für die Beschilderung dieser Linie verwendet wird. Wird hexadezimal dargestellt.

icon_uri

string

Der URI für das Symbol, das dieser Zeile 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 den Text auf der Beschilderung dieser Linie verwendet wird. 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 sollen. Standardmäßig sind alle unterstützten Verkehrsmittel ausgewählt.

routing_preference

TransitRoutingPreference

Eine Routing-Einstellung, die sich bei Angabe auf die zurückgegebene TRANSIT-Route auswirkt.

TransitRoutingPreference

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

Enums
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED 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 der Verkehrsmittelmodus 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 Stadt- oder Straßenbahn fahren
RAIL Mit dem Zug 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

Die Position der Haltestelle oder des Bahnhofs in Breiten-/Längengradkoordinaten.

TransitVehicle

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

Felder
name

LocalizedText

Der Name dieses Fahrzeugs in Großbuchstaben.

type

TransitVehicleType

Der verwendete Fahrzeugtyp.

icon_uri

string

Der URI für ein Symbol, das diesem Fahrzeugtyp zugeordnet ist.

local_icon_uri

string

Die 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 in der Anzeige verwendete Maßeinheit angeben.

Enums
UNITS_UNSPECIFIED Maßeinheiten nicht angegeben. Die Standardeinstellung ist die aus der Anfrage abgeleitete Maßeinheit.
METRIC Metrische Maßeinheiten.
IMPERIAL Angloamerikanische Maßeinheiten.

VehicleEmissionType

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

Enums
VEHICLE_EMISSION_TYPE_UNSPECIFIED Es wurde kein Emissionstyp angegeben. Standardeinstellung ist GASOLINE.
GASOLINE Benzinfahrzeug
ELECTRIC Fahrzeug mit Elektroantrieb.
HYBRID Hybridfahrzeug (z. B. Benzin + Elektro)
DIESEL Dieselfahrzeug

VehicleInfo

Enthält die Fahrzeuginformationen, z. B. den Emissionstyp des Fahrzeugs.

Felder
emission_type

VehicleEmissionType

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

Zwischenstopp

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

Felder
via

bool

Kennzeichnet diesen Wegpunkt als Meilenstein und nicht als Haltepunkt. Für jeden nicht über einen Zwischenstopp angefahrenen Wegpunkt in der Anfrage wird der Antwort ein Eintrag im legs-Array angehängt, um die Details für Zwischenstopps auf dieser Etappe der Fahrt anzugeben. Setzen Sie diesen Wert auf „true“, wenn die Route ohne Zwischenstopp durch diesen Wegpunkt verlaufen soll. Durch Wegpunkte wird kein Eintrag im legs-Array hinzugefügt, aber die Route führt durch den Wegpunkt. Sie können diesen Wert nur für Zwischenziele festlegen. Die Anfrage schlägt fehl, wenn Sie dieses Feld für Endwegpunkte 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, an denen angehalten werden soll, um Personen oder Waren abzuholen oder abzusetzen. Wenn Sie diesen Wert festlegen, enthält die berechnete Route keine via-Wegpunkte auf Straßen, die für die Abholung und das Absetzen ungeeignet sind. Diese Option funktioniert nur für die Fortbewegungsmittel DRIVE und TWO_WHEELER und wenn location_type Location ist.

side_of_road

bool

Gibt an, dass das Fahrzeug an diesem Wegpunkt bevorzugt auf einer bestimmten Straßenseite anhalten soll. Wenn Sie diesen Wert festlegen, verläuft die Route durch den Ort, sodass das Fahrzeug am Straßenrand anhalten kann, der vom Straßenmittelpunkt aus in Richtung des Ortes liegt. Diese Option funktioniert nur für DRIVE und TWO_WHEELER RouteTravelMode.

Union-Feld location_type. Verschiedene Möglichkeiten, einen Ort darzustellen Für location_type ist nur einer der folgenden Werte zulässig:
location

Location

Ein Punkt, der mit geografischen Koordinaten angegeben wird, 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.