Package google.maps.routing.v2

Index

Routen

Routes API

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Nimmt eine Liste von Start- und Zielorten auf 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 mithilfe des URL-Parameters $fields oder fields oder mit dem HTTP/gRPC-Header X-Goog-FieldMask bereitstellen. Weitere Informationen zu verfügbaren URL-Parametern und -Headern Der Wert ist eine durch Kommas getrennte Liste von Feldpfaden. Ausführliche Informationen finden Sie unter Feldpfade erstellen.

Zum Beispiel in dieser Methode:

  • Feldmaske aller verfügbaren Felder (für die manuelle Prüfung): X-Goog-FieldMask: *
  • Feldmaske mit Routendauern, Entfernungen, Elementstatus, Bedingungen und Elementindexen (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 sonst alle Nachrichten in Ordnung zu sein scheinen. Google rät von der Verwendung der Platzhalter-Antwortfeldmaske (*) aus folgenden Gründen ab:

  • Indem Sie nur die Felder auswählen, die Sie benötigen, spart unser Server Berechnungszyklen, sodass wir das Ergebnis mit einer geringeren Latenz an Sie zurückgeben können.
  • Wenn Sie nur die Felder auswählen, die Sie für Ihren Produktionsjob benötigen, wird eine stabile Latenzleistung sichergestellt. Möglicherweise fügen wir in Zukunft weitere Antwortfelder hinzu, und 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 neu hinzugefügte Feld automatisch in die Antwort aufgenommen wird.
  • Wenn Sie nur die Felder auswählen, die Sie benötigen, führt dies zu einer kleineren Antwortgröße und damit zu einem höheren Netzwerkdurchsatz.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

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

HINWEIS:Bei dieser Methode müssen Sie in der Eingabe eine Antwortfeldmaske angeben. Sie können die Antwortfeldmaske mithilfe des URL-Parameters $fields oder fields oder mit dem HTTP/gRPC-Header X-Goog-FieldMask bereitstellen. Weitere Informationen zu verfügbaren URL-Parametern und -Headern Der Wert ist eine durch Kommas getrennte Liste von Feldpfaden. Ausführliche Informationen finden Sie unter Feldpfade erstellen.

Zum Beispiel in dieser Methode:

  • Feldmaske aller verfügbaren Felder (für die manuelle Prüfung): X-Goog-FieldMask: *
  • Feldmaske mit 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 Platzhalter-Antwortfeldmaske (*) zu verwenden oder die Feldmaske auf oberster Ebene (routes) anzugeben, weil:

  • Indem Sie nur die Felder auswählen, die Sie benötigen, spart unser Server Berechnungszyklen, sodass wir das Ergebnis mit einer geringeren Latenz an Sie zurückgeben können.
  • Wenn Sie nur die Felder auswählen, die Sie für Ihren Produktionsjob benötigen, wird eine stabile Latenzleistung sichergestellt. Möglicherweise fügen wir in Zukunft weitere Antwortfelder hinzu, und 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 neu hinzugefügte Feld automatisch in die Antwort aufgenommen wird.
  • Wenn Sie nur die Felder auswählen, die Sie benötigen, führt dies zu einer kleineren Antwortgröße und damit zu einem höheren Netzwerkdurchsatz.

ComputeRouteMatrixRequest

ComputeRouteMatrix-Anfragenachricht

Felder
origins[]

RouteMatrixOrigin

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

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

RouteMatrixDestination

Erforderlich. Array von 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 wird. Der Server versucht, die Route anhand der ausgewählten Routingeinstellung zu berechnen. Wenn die Routingeinstellung zu einem Fehler oder zu einer sehr 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 der Zeitpunkt der Anfrage verwendet. HINWEIS: Sie können nur einen departure_time in der Vergangenheit angeben, wenn RouteTravelMode auf TRANSIT gesetzt ist.

arrival_time

Timestamp

Optional. 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 vom Standort des ersten Startorts abgeleitet.

region_code

string

Optional. Der Regionscode, angegeben als zweistelliger ccTLD-Wert ("top-level domain"). 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 zur Vervollständigung der Anfrage verwendet werden können. Hinweis: Durch diese zusätzlichen Berechnungen können in der Antwort zusätzliche Felder 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 aus, der im Feld für die Dauer in RouteMatrixElement zurückgegeben wird. Dieser enthält die vorhergesagte Zeit im Traffic basierend auf den bisherigen Durchschnittswerten. RoutingPreference bis TRAFFIC_AWARE_OPTIMAL und RouteTravelMode bis DRIVE. Die Standardeinstellung ist BEST_GUESS, wenn Traffic angefordert wird, und TrafficModel ist nicht angegeben.

transit_preferences

TransitPreferences

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

ExtraComputation

Zusätzliche Berechnungen, die während der Anfrage ausgeführt werden müssen.

Enums
EXTRA_COMPUTATION_UNSPECIFIED Nicht verwendet. Anfragen, die diesen Wert enthalten, schlagen fehl.
TOLLS Mautinformationen für die Matrixelemente.

ComputeRoutesRequest

ComputeRoutes-Anfragenachricht

Felder
origin

Waypoint

Erforderlich. Ursprungswegpunkt.

destination

Waypoint

Erforderlich. Zielwegpunkt.

intermediates[]

Waypoint

Optional. Eine Gruppe von Wegpunkten entlang der Route (mit Ausnahme von Endpunkten), die an einem Zwischenstopp stehen oder an einem vorbeigehen. 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 wird. Der Server versucht, die Route anhand der ausgewählten Routingeinstellung zu berechnen. Wenn die Routingeinstellung zu einem Fehler oder zu einer sehr 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 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 der Zeitpunkt der Anfrage verwendet. HINWEIS: Sie können nur einen departure_time in der Vergangenheit angeben, wenn RouteTravelMode auf TRANSIT gesetzt ist. Fahrten mit öffentlichen Verkehrsmitteln sind für bis zu 7 Tage in der Vergangenheit oder bis zu 100 Tage in der Zukunft verfügbar.

arrival_time

Timestamp

Optional. 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. Fahrten mit öffentlichen Verkehrsmitteln sind für bis zu 7 Tage in der Vergangenheit oder bis zu 100 Tage in der Zukunft verfügbar.

compute_alternative_routes

bool

Optional. Gibt an, ob neben der Route alternative Routen berechnet werden sollen. Bei Anfragen mit Wegpunkten 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 der 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 Ort der Routenanfrage abgeleitet.

region_code

string

Optional. Der Regionscode, angegeben als zweistelliger ccTLD-Wert ("top-level domain"). 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 Maßeinheiten, die für Route, Streckenabschnitt, Schrittstrecke und Dauer verwendet werden, sind von diesem Wert nicht betroffen. Wenn Sie diesen Wert nicht angeben, werden die Anzeigeeinheiten vom Standort des ersten Startorts abgeleitet.

optimize_waypoint_order

bool

Optional. Wenn dieser Wert auf „true“ gesetzt ist, versucht der Dienst, die Gesamtkosten der Route durch eine Neuanordnung der angegebenen Zwischenwegpunkte zu minimieren. Die Anfrage schlägt fehl, wenn einer der Wegzwischenpunkte 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 als Teil der Anfrage berechnet werden sollen. Eine Referenzroute ist eine Route, deren Berechnungsziel von der Standardroute abweicht. Bei der Berechnung einer FUEL_EFFICIENT-Referenzroute werden beispielsweise verschiedene Parameter berücksichtigt, die eine optimale spritsparende Route generieren würden.

extra_computations[]

ExtraComputation

Optional. Eine Liste zusätzlicher Berechnungen, die zur Vervollständigung der Anfrage verwendet werden können. Hinweis: Durch diese zusätzlichen Berechnungen können in der Antwort zusätzliche Felder 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 aus, der im Feld für die Dauer in Route und RouteLeg zurückgegeben wird. Dieser Wert enthält die vorhergesagte Zeit im Traffic basierend auf historischen Durchschnittswerten. TrafficModel ist nur für Anfragen verfügbar, bei denen RoutingPreference auf TRAFFIC_AWARE_OPTIMAL und RouteTravelMode auf DRIVE festgelegt wurde. Die Standardeinstellung ist BEST_GUESS, wenn Traffic angefordert wird, und TrafficModel ist nicht angegeben.

transit_preferences

TransitPreferences

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

ExtraComputation

Zusätzliche Berechnungen, die während der Anfrage ausgeführt werden müssen.

Enums
EXTRA_COMPUTATION_UNSPECIFIED Nicht verwendet. Anfragen, die diesen Wert enthalten, schlagen fehl.
TOLLS Mautinformationen für die Route(n).
FUEL_CONSUMPTION Geschätzter Kraftstoffverbrauch für die Route(n).
TRAFFIC_ON_POLYLINE Polylinien mit Verkehrsinformationen für die Route(n).
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions wird als formatierter HTML-Textstring dargestellt. Dieser Inhalt ist so zu lesen, wie er ist. Dieser Inhalt dient nur der Anzeige. Parsen Sie ihn nicht programmatisch.

ReferenceRoute

Eine unterstützte Referenzroute in ComputeRoutesRequest.

Enums
REFERENCE_ROUTE_UNSPECIFIED Nicht verwendet. Anfragen, die diesen Wert enthalten, schlagen fehl.
FUEL_EFFICIENT Spritsparende Route. Routen, die mit diesem Wert gekennzeichnet sind, sind für Parameter wie den Kraftstoffverbrauch optimiert.

ComputeRoutesResponse

ComputeRoutes die Antwortnachricht.

Felder
routes[]

Route

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

fallback_info

FallbackInfo

Wenn der Server die Routenergebnisse nicht mit allen Eingabepräferenzen berechnen kann, greift er unter Umständen auf eine andere Berechnungsmethode zurück. 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 als Adressen angegebene Wegpunkte.

FallbackInfo

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

Felder
routing_mode

FallbackRoutingMode

Routingmodus, der für die Antwort verwendet wird. Wenn ein Fallback ausgelöst wurde, kann sich der Modus von der Routingeinstellung unterscheiden, die in der ursprünglichen Clientanfrage festgelegt wurde.

reason

FallbackReason

Der Grund, warum die Fallback-Antwort anstelle der ursprünglichen 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 der Fallback-Antwort.

Enums
FALLBACK_REASON_UNSPECIFIED Kein Grund für Fallback angegeben.
SERVER_ERROR Bei der Berechnung von Routen mit dem bevorzugten Routenmodus ist ein Serverfehler aufgetreten. Es wurde jedoch ein Ergebnis zurückgegeben, das mit einer alternativen Mobilitätsform berechnet wurde.
LATENCY_EXCEEDED Wir konnten die Berechnung mit Ihrem bevorzugten Routenmodus nicht rechtzeitig abschließen, konnten jedoch ein Ergebnis zurückgeben, das von einem alternativen Modus berechnet wurde.

FallbackRoutingMode

Tatsächlicher 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 zum Berechnen der Antwort verwendet wurde.
FALLBACK_TRAFFIC_AWARE Gibt an, dass TRAFFIC_AWARE RoutingPreference zum Berechnen der Antwort verwendet wurde.

GeocodedWaypoint

Details zu den Standorten, die als Wegpunkte verwendet werden Wird nur für Wegpunkte der Adresse ausgefüllt. Enthält Details über die Geocodierungsergebnisse, um zu bestimmen, für welche Adresse die Adresse geocodiert wurde.

Felder
geocoder_status

Status

Gibt den Statuscode des Geocoding-Vorgangs an.

type[]

string

Die Art(en) des Ergebnisses in Form von null oder mehr Typ-Tags. Unterstützte Typen: Adresstypen und Adresskomponententypen.

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 Wegpunkts in der Anfrage. Wird nur gefüllt, wenn der entsprechende Wegpunkt ein Zwischenwegpunkt ist.

GeocodingResults

Enthält GeocodedWaypoints für Start- und Zielort sowie Wegpunkte. Wird nur für Wegpunkte der Adresse ausgefüllt.

Felder
origin

GeocodedWaypoint

Geocodierter Startwegpunkt.

destination

GeocodedWaypoint

Geocodierter Wegpunkt für das Ziel.

intermediates[]

GeocodedWaypoint

Eine Liste mit geocodierten Zwischenpunkten, 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 in einer bestimmten Zeitzone angegebene Zeit.

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 ein (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 das Zu- und Aussteigen an. Ausrichtungswerte können zwischen 0 und 360 liegen, wobei 0 eine Richtung in Richtung Norden, 90 eine Richtung nach Osten und so weiter angibt. Sie können dieses Feld nur für DRIVE und TWO_WHEELER RouteTravelMode verwenden.

Manöver

Eine Reihe von Werten, die die Navigationsaktion angeben, die für den aktuellen Schritt ausgeführt werden soll (z. B. links abbiegen, verbinden oder gerade).

Enums
MANEUVER_UNSPECIFIED Nicht verwendet.
TURN_SLIGHT_LEFT Leicht nach links abbiegen.
TURN_SHARP_LEFT Scharf nach links abbiegen.
UTURN_LEFT Wenden.
TURN_LEFT Links abbiegen.
TURN_SLIGHT_RIGHT Leicht nach rechts abbiegen.
TURN_SHARP_RIGHT Scharf nach rechts abbiegen.
UTURN_RIGHT Wenden.
TURN_RIGHT Rechts abbiegen.
STRAIGHT Fahren Sie geradeaus.
RAMP_LEFT Nimm die linke Auffahrt.
RAMP_RIGHT Dann nehmen Sie die rechte Auffahrt.
MERGE Zusammenführen in Traffic.
FORK_LEFT Nimm die linke Gabelung.
FORK_RIGHT Nimm die rechte Gabel.
FERRY Nimm die Fähre.
FERRY_TRAIN Nehmen Sie den Zug, der zur Fähre führt.
ROUNDABOUT_LEFT Biegen Sie am Kreisverkehr links ab.
ROUNDABOUT_RIGHT Im Kreisverkehr rechts abbiegen.
DEPART Anfängliche Manöver.
NAME_CHANGE Wird verwendet, um eine Änderung des Straßennamens anzugeben.

Umfasst Navigationsanweisungen für ein RouteLegStep.

Felder
maneuver

Maneuver

Fasst die Navigationsanweisungen für den aktuellen Schritt zusammen (z. B. links abbiegen, fahren oder geradeaus). Mit diesem Feld wird festgelegt, welches Symbol angezeigt wird.

instructions

string

Hier finden Sie eine Anleitung für diesen Schritt.

Polyline

Kapselt eine codierte Polylinie ein.

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

string

Die Stringcodierung der Polylinie unter Verwendung des Algorithmus für die Polyliniencodierung.

geo_json_linestring

Struct

Gibt eine Polylinie im GeoJSON-LineString-Format an.

PolylineEncoding

Gibt den bevorzugten Typ der Polylinie an, die zurückgegeben werden soll.

Enums
POLYLINE_ENCODING_UNSPECIFIED Keine Einstellung für Polylinientyp angegeben. Die Standardeinstellung ist ENCODED_POLYLINE.
ENCODED_POLYLINE Gibt eine Polylinie an, die mithilfe des Codierungsalgorithmus für 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 Keine Einstellung für die Polylinienqualität angegeben. Die Standardeinstellung ist OVERVIEW.
HIGH_QUALITY Gibt eine Polylinie von hoher Qualität an, die aus mehr Punkten als OVERVIEW zusammengesetzt ist, allerdings zulasten einer größeren Antwortgröße. Verwenden Sie diesen Wert, wenn Sie mehr Genauigkeit benötigen.
OVERVIEW Gibt eine Übersichtspolygone an, die sich aus einer kleinen Anzahl von Punkten zusammensetzt. Verwenden Sie diesen Wert, wenn Sie eine Übersicht der Route anzeigen lassen. Diese Option hat eine niedrigere Anfragelatenz als die Option HIGH_QUALITY.

Route

Enthält eine Route, die aus einer Reihe verbundener Straßenabschnitte besteht, die Wegpunkte am Anfang, am Ende und in der Mitte verbinden.

Felder
route_labels[]

RouteLabel

Labels für die Route, mit denen bestimmte Eigenschaften der Route angegeben werden können, um sie mit anderen zu vergleichen.

legs[]

RouteLeg

Eine Sammlung von Streckenabschnitten zwischen Wegpunkten, aus denen die Route besteht. Jeder Abschnitt entspricht der Fahrt zwischen zwei Nicht-via-Waypoints. So hat beispielsweise eine Route ohne Wegpunkte nur einen Streckenabschnitt. Eine Route, die einen Wegpunkt (nicht via) enthält, hat zwei Streckenabschnitte. Eine Route mit einem via-Zwischenwegpunkt hat einen Streckenabschnitt. Die Reihenfolge der Streckenabschnitte entspricht der Reihenfolge der Wegpunkte von origin über intermediates bis destination.

distance_meters

int32

Die Entfernung der Route in Metern.

duration

Duration

Die für die Navigation der Route erforderliche Zeit. Wenn Sie routing_preference auf TRAFFIC_UNAWARE festlegen, ist dieser Wert derselbe wie static_duration. Wenn Sie für routing_preference entweder TRAFFIC_AWARE oder TRAFFIC_AWARE_OPTIMAL festlegen, wird dieser Wert unter Berücksichtigung der Verkehrslage berechnet.

static_duration

Duration

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

polyline

Polyline

Die gesamte Polylinie der Route. 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 angezeigt werden sollen.

viewport

Viewport

Der Markierungsrahmen 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 Wegpunkte. Andernfalls ist dieses Feld leer. Wenn Sie beispielsweise Origin: LA; Wegpunkte mittlerer Stufe: Dallas, Bangor, Phoenix Zielort: New York; und die optimierte Wegpunktreihenfolge Phoenix, Dallas, Bangor ist, enthält dieses Feld die Werte [2, 0, 1]. Der Index beginnt für den ersten in der Eingabe angegebenen Zwischenwegpunkt mit 0.

localized_values

RouteLocalizedValues

Textdarstellungen von Attributen von Route.

route_token

string

Ein websicheres, base64-codiertes Routentoken, das an das Navigation SDK übergeben werden kann, mit dem das Navigation SDK die Route während der Navigation rekonstruieren kann und im Fall einer Neuberechnung der Route durch Aufrufen von ComputeRoutes die ursprüngliche Absicht berücksichtigt. Kunden sollten dieses Token als intransparentes Blob behandeln. Vergleichen Sie seinen Wert nicht über verschiedene Anfragen. Dieses Token kann sich ändern, auch wenn genau die gleiche Route zurückgegeben wurde. HINWEIS: Route.route_token ist nur für Anfragen verfügbar, bei denen ComputeRoutesRequest.routing_preference auf TRAFFIC_AWARE oder TRAFFIC_AWARE_OPTIMAL gesetzt wurde. Route.route_token wird für Anfragen mit Via-Wegpunkten nicht unterstützt.

RouteLocalizedValues

Textdarstellungen bestimmter Eigenschaften.

Felder
distance

LocalizedText

In Textform dargestellte Reisestrecke.

duration

LocalizedText

In Textform dargestellte Dauer unter Berücksichtigung der Verkehrsbedingungen. Hinweis: Wenn Sie keine Traffic-Informationen angefordert haben, entspricht dieser Wert dem Wert static_duration.

static_duration

LocalizedText

Dauer ohne Berücksichtigung der Verkehrslage, dargestellt in Textform.

transit_fare

LocalizedText

Fahrpreis in Textform

RouteLabel

Labels für die Route, mit denen bestimmte Eigenschaften der Route angegeben werden können, um sie mit anderen zu vergleichen.

Enums
ROUTE_LABEL_UNSPECIFIED Standard: nicht verwendet.
DEFAULT_ROUTE Die Standardeinstellung „Am besten“ für die Routenberechnung zurückgegebene Route.
DEFAULT_ROUTE_ALTERNATE Eine Alternative zur Standardeinstellung „Am besten“ Route. Solche Routen werden zurückgegeben, wenn compute_alternative_routes angegeben ist.
FUEL_EFFICIENT Spritsparende Route. Routen, die mit diesem Wert gekennzeichnet sind, sind für Eco-Parameter wie den Kraftstoffverbrauch optimiert.

RouteLeg

Enthält ein Segment zwischen Wegpunkten, die nicht zu via gehören.

Felder
distance_meters

int32

Die Strecke des Streckenabschnitts in Metern.

duration

Duration

Die Zeit, die zum Navigieren im Bein benötigt wird. Wenn route_preference auf TRAFFIC_UNAWARE gesetzt ist, ist dieser Wert derselbe wie 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 Fahrt durch einen Abschnitt, die ohne Berücksichtigung der Verkehrslage berechnet wird.

polyline

Polyline

Die gesamte Polylinie für diesen Abschnitt, die die Polylinie jeder step enthält.

start_location

Location

Die Startposition dieses Streckenabschnitts. Dieser Standort kann sich vom angegebenen origin unterscheiden. Wenn sich die angegebene origin beispielsweise nicht in der Nähe einer Straße befindet, ist dies ein Punkt auf der Straße.

end_location

Location

Der Endstandort dieses Abschnitts. Dieser Standort kann sich vom angegebenen destination unterscheiden. Wenn sich die angegebene 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 angeben. Jeder Schritt stellt eine Navigationsanweisung dar.

travel_advisory

RouteLegTravelAdvisory

Enthält die zusätzlichen Informationen, über die der Nutzer auf einem Streckenabschnitt informiert werden sollte, z. B. mögliche Einschränkungen einer Verkehrszone.

localized_values

RouteLegLocalizedValues

Textdarstellungen von Attributen von RouteLeg.

steps_overview

StepsOverview

Übersicht über die Schritte in diesem RouteLeg. Dieses Feld wird nur bei TRANSIT-Routen ausgefüllt.

RouteLegLocalizedValues

Textdarstellungen bestimmter Eigenschaften.

Felder
distance

LocalizedText

In Textform dargestellte Reisestrecke.

duration

LocalizedText

Im Textformat dargestellte Dauer unter Berücksichtigung der Verkehrsbedingungen. Hinweis: Wenn Sie keine Verkehrsinformationen angefordert haben, entspricht dieser Wert dem Wert von static_duration.

static_duration

LocalizedText

Dauer ohne Berücksichtigung der Verkehrslage, dargestellt in Textform.

StepsOverview

Bietet eine Übersicht über eine Liste von RouteLegSteps.

Felder
multi_modal_segments[]

MultiModalSegment

Zusammengefasste Informationen zu verschiedenen multimodalen Segmenten des 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 des RouteLeg.steps. Ein multimodales Segment wird als eine 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

Die Mobilitätsform des multimodalen Segments.

step_start_index

int32

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

step_end_index

int32

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

RouteLegStep

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

Felder
distance_meters

int32

Die Strecke dieses Schritts in Metern. Unter bestimmten Umständen enthält dieses Feld keinen Wert.

static_duration

Duration

Die Dauer der Reise für diesen Schritt ohne Berücksichtigung der Verkehrslage. Unter bestimmten Umständen enthält dieses Feld keinen Wert.

polyline

Polyline

Die mit diesem Schritt verknüpfte Polylinie.

start_location

Location

Die Startposition dieses Schritts.

end_location

Location

Der Endstandort dieses Schritts.

navigation_instruction

NavigationInstruction

Navigationsanweisungen

travel_advisory

RouteLegStepTravelAdvisory

Enthält die zusätzlichen Informationen, über die der Nutzer bei einem Etappenschritt informiert werden muss, z. B. mögliche Einschränkungen in einer Verkehrszone.

localized_values

RouteLegStepLocalizedValues

Textdarstellungen von Attributen von RouteLegStep.

transit_details

RouteLegStepTransitDetails

Details zu diesem Schritt, wenn die Mobilitätsform TRANSIT ist.

travel_mode

RouteTravelMode

Die für diesen Schritt verwendete Mobilitätsform.

RouteLegStepLocalizedValues

Textdarstellungen bestimmter Eigenschaften.

Felder
distance

LocalizedText

In Textform dargestellte Reisestrecke.

static_duration

LocalizedText

Dauer ohne Berücksichtigung der Verkehrslage, dargestellt in Textform.

RouteLegStepTransitDetails

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

Felder
stop_details

TransitStopDetails

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

localized_values

TransitDetailsLocalizedValues

Textdarstellungen von Attributen von RouteLegStepTransitDetails.

headsign

string

Gibt die Fahrtrichtung auf dieser Linie an, die auf dem Fahrzeug oder an der Abfahrtshaltestelle angegeben ist. Die Richtung entspricht oft der Endhaltestelle.

headway

Duration

Gibt die erwartete Zeit als Dauer zwischen Abfahrten von derselben Haltestelle zu diesem Zeitpunkt an. Bei einem Taktsekundenwert von 600 wäre beispielsweise mit einer Wartezeit von zehn Minuten zu rechnen, wenn Sie Ihren Bus verpassen sollten.

transit_line

TransitLine

Informationen zu der ÖPNV-Linie, die in diesem Schritt verwendet wird.

stop_count

int32

Die Anzahl der Haltestellen von der Abfahrt bis zur Ankunftshaltestelle. Die Anzahl umfasst die Ankunftshaltestelle, die Starthaltestelle aber nicht. Wenn Ihre Route beispielsweise an Haltestelle A abfährt, über die Haltestellen B und C führt und an Haltestelle D ankommt, wird für „stop_count“ der Wert 3 zurückgegeben.

trip_short_text

string

Der Text, der in Fahrplänen und Schildern angezeigt wird, um Fahrgästen eine Fahrt mit öffentlichen Verkehrsmitteln zu kennzeichnen. Mit dem Text sollte eine Fahrt innerhalb eines Betriebstages eindeutig gekennzeichnet werden. Beispiel: „538“ ist die trip_short_text des Amtrak-Zug, der an Wochentagen um 15:10 Uhr von San Jose, Kalifornien, nach Sacramento, Kalifornien fährt.

TransitDetailsLocalizedValues

Lokalisierte Beschreibungen der Werte für RouteTransitDetails.

Felder
arrival_time

LocalizedTime

Zeit in der formatierten Textdarstellung mit einer entsprechenden Zeitzone.

departure_time

LocalizedTime

Zeit in der 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 geschätzte 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 in einer Verkehrszone bei einem Beinschritt.

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 Etappenschritt informiert werden sollte, z. B. mögliche Einschränkungen in einer Verkehrszone.

Felder
toll_info

TollInfo

Enthält Informationen zu Mautgebühren für die jeweilige RouteLeg. Dieses Feld wird nur ausgefüllt, wenn wir davon ausgehen, dass auf der RouteLeg Mautstraßen anfallen. Wenn für dieses Feld ein Wert festgelegt ist, das Unterfeld „estimated_price“ nicht ausgefüllt ist, gehen wir davon aus, dass die Straße mautpflichtig ist, aber uns ist kein geschätzter Preis bekannt. Wenn dieses Feld nicht vorhanden ist, fallen für RouteLeg keine Gebühren an.

speed_reading_intervals[]

SpeedReadingInterval

Geschwindigkeitsleseintervalle zur detaillierten Verkehrsdichte. Anwendbar bei den Routingeinstellungen TRAFFIC_AWARE und TRAFFIC_AWARE_OPTIMAL. Die Intervalle decken die gesamte Polylinie von RouteLeg ohne Überschneidung ab. Der Startpunkt eines angegebenen Intervalls ist mit dem Endpunkt des vorhergehenden 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. Wegpunkt (Ziel)

RouteMatrixElement

Enthält Routeninformationen, die für ein Start-/Zielort-Paar in der ComputeRouteMatrix API berechnet wurden. Dieses Proto kann zum 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 Entfernung der Route in Metern.

duration

Duration

Die für die Navigation der Route erforderliche Zeit. Wenn Sie routing_preference auf TRAFFIC_UNAWARE festlegen, ist dieser Wert derselbe wie static_duration. Wenn Sie für routing_preference entweder TRAFFIC_AWARE oder TRAFFIC_AWARE_OPTIMAL festlegen, wird dieser Wert unter Berücksichtigung der Verkehrslage berechnet.

static_duration

Duration

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

travel_advisory

RouteTravelAdvisory

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

fallback_info

FallbackInfo

Wenn der Server die Route nicht mit den angegebenen Präferenzen für dieses bestimmte Start-/Zielort-Paar berechnen kann, greift er unter Umständen auf einen anderen Berechnungsmodus zurück. 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 von RouteMatrixElement.

origin_index

int32

Nullbasierter Index des Ursprungs in der Anfrage.

destination_index

int32

Nullbasierter Index des Ziels in der Anfrage.

LocalizedValues

Textdarstellungen bestimmter Eigenschaften.

Felder
distance

LocalizedText

In Textform dargestellte Reisestrecke.

duration

LocalizedText

In Textform dargestellte Dauer unter Berücksichtigung der Verkehrsbedingungen. Hinweis: Wenn keine Verkehrsinformationen angefordert wurden, entspricht dieser Wert dem Wert von static_duration.

static_duration

LocalizedText

In Textform dargestellte Dauer ohne Berücksichtigung der Verkehrslage.

transit_fare

LocalizedText

Fahrpreis in Textform

RouteMatrixElementCondition

Die Bedingung der zurückgegebenen Route.

Enums
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Wird nur verwendet, wenn der status des Elements nicht zulässig ist.
ROUTE_EXISTS Es wurde eine Route gefunden und die entsprechenden Informationen für das Element wurden eingegeben.
ROUTE_NOT_FOUND Es wurde keine Route gefunden. 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. Startwegpunkt

route_modifiers

RouteModifiers

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

RouteModifiers

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

Felder
avoid_tolls

bool

Wenn dieser Wert auf „true“ gesetzt ist, werden mautpflichtige Straßen in angemessenem Umfang vermieden und Routen ohne Mautstraßen bevorzugt. Gilt nur für die RouteTravelMode DRIVE und TWO_WHEELER.

avoid_highways

bool

Wenn diese Richtlinie auf „true“ gesetzt ist, werden Autobahnen in angemessener Weise vermieden, sodass Routen, die keine Autobahnen enthalten, bevorzugt werden. Gilt nur für die RouteTravelMode DRIVE und TWO_WHEELER.

avoid_ferries

bool

Ist die Richtlinie auf „true“ gesetzt, werden Fähren in angemessenem Umfang vermieden und Routen bevorzugt, die keine Fähren enthalten. Gilt nur für die RouteTravelMode DRIVE und TWO_WHEELER.

avoid_indoor

bool

Wenn diese Richtlinie auf „true“ gesetzt ist, wird das Fahren in Innenräumen vermieden, sofern dies sinnvoll ist. Routen, die keine solche Navigation umfassen, werden bevorzugt. Gilt nur für WALK-RouteTravelMode.

vehicle_info

VehicleInfo

Gibt die Fahrzeuginformationen an.

toll_passes[]

TollPass

Zusammenfassung von Informationen zu Mautkarten. Wenn Mautpässe angegeben werden, versucht die API, den Preis der Karte bzw. des Tickets zurückzugeben. Wenn keine Mautkarten angegeben werden, behandelt die API die Mautkarte als unbekannt und versucht, den Barpreis zurückzugeben. Gilt nur für die RouteTravelMode DRIVE und TWO_WHEELER.

RouteTravelAdvisory

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

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 zu erwarten sind. Wenn für dieses Feld eine Einstellung festgelegt ist, das Unterfeld estimatedPrice aber nicht ausgefüllt ist, enthält die Route Mautgebühren, der geschätzte Preis ist jedoch unbekannt. Ist dieses Feld nicht konfiguriert, werden auf der Route keine Mautgebühren erwartet.

speed_reading_intervals[]

SpeedReadingInterval

Geschwindigkeitsleseintervalle zur detaillierten Verkehrsdichte. Anwendbar bei den Routingeinstellungen TRAFFIC_AWARE und TRAFFIC_AWARE_OPTIMAL. Die Intervalle decken die gesamte Polylinie der Route ohne Überschneidung ab. Der Startpunkt eines angegebenen Intervalls ist mit dem Endpunkt des vorhergehenden 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 prognostizierte Kraftstoffverbrauch in Mikroliter.

route_restrictions_partially_ignored

bool

Für die zurückgegebene Route gelten möglicherweise Einschränkungen, die für das angeforderte Verkehrsmittel oder Routenmodifikatoren nicht geeignet sind.

transit_fare

Money

Enthält den Gesamtfahrpreis oder die Ticketkosten für diese Route. Diese Eigenschaft wird nur bei TRANSIT-Anfragen und nur für Routen zurückgegeben, auf denen Preisinformationen für alle Schritte mit öffentlichen Verkehrsmitteln verfügbar sind.

RouteTravelMode

Eine Reihe von Werten zur Angabe der Mobilitätsform. HINWEIS: WALK-, BICYCLE- und TWO_WHEELER-Routen befinden sich in der Betaphase und haben möglicherweise keine freien Bürgersteige, Fußgänger- oder Fahrradwege. Sie müssen diese Warnung für alle Fußgänger-, Fahrrad- und Motorradrouten anzeigen, die Sie in Ihrer App anzeigen.

Enums
TRAVEL_MODE_UNSPECIFIED Keine Mobilitätsform angegeben. Die Standardeinstellung ist DRIVE.
DRIVE Mit Pkw.
BICYCLE Sie fahren mit dem Fahrrad.
WALK Geh zu Fuß.
TWO_WHEELER Motorisiertes Fahrzeug mit zwei Rädern. Beispiel: Motorrad. Hinweis: Diese Angabe unterscheidet sich von der Mobilitätsform BICYCLE, die den von Menschen betriebenen Modus umfasst.
TRANSIT Sie können mit öffentlichen Verkehrsmitteln fahren, sofern verfügbar.

RoutingPreference

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

Enums
ROUTING_PREFERENCE_UNSPECIFIED Keine Routingeinstellung angegeben. Standardeinstellung ist TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Berechnet Routen ohne Berücksichtigung der aktuellen Verkehrslage. Geeignet, wenn die Verkehrslage keine Rolle spielt oder nicht. Die Verwendung dieses Werts führt zur niedrigsten Latenz. Hinweis: Für RouteTravelMode DRIVE und TWO_WHEELER basieren die gewählte Route und die Dauer auf dem Straßennetz und der durchschnittlichen zeitunabhängigen Verkehrslage, nicht auf den aktuellen Straßenverhältnissen. Daher können Routen vorübergehend gesperrte Straßen umfassen. Die Ergebnisse für eine bestimmte Anfrage können im Laufe der Zeit aufgrund von Änderungen im Straßennetz, aktualisierten durchschnittlichen Verkehrsbedingungen und verteilten Services variieren. Außerdem können die Ergebnisse zwischen nahezu 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 erheblich zu reduzieren.
TRAFFIC_AWARE_OPTIMAL Bei der Berechnung der Routen werden die aktuellen Verkehrsbedingungen berücksichtigt, ohne dass die meisten Leistungsoptimierungen angewendet werden. Die Verwendung dieses Werts führt zur höchsten Latenz.

SpeedReadingInterval

Verkehrsdichteanzeige für ein zusammenhängendes Segment einer Polylinie oder eines Pfads Bei einem Pfad mit den Punkten P_0, P_1, ... , P_N (nullbasierter Index) definiert SpeedReadingInterval ein Intervall und beschreibt den Traffic anhand der 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

Verkehrsgeschwindigkeit in diesem Intervall.

Geschwindigkeit

Die Klassifizierung der Polyliniengeschwindigkeit auf Grundlage von Verkehrsdaten.

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

TollInfo

Verkapselt mautpflichtige Informationen in einem Route oder RouteLeg.

Felder
estimated_price[]

Money

Der Geldbetrag der Mautgebühren für die entsprechende Route oder RouteLeg. Diese Liste enthält für jede Währung einen Geldbetrag, der voraussichtlich von den Mautstationen berechnet wird. Für Routen mit Mautgebühren in derselben Währung enthält diese Liste normalerweise nur einen Eintrag. Für internationale Reisen kann diese Liste mehrere Positionen enthalten, um Mautgebühren in verschiedenen Währungen widerzuspiegeln.

TollPass

Liste der weltweit unterstützten Mautpässe.

Enums
TOLL_PASS_UNSPECIFIED Nicht verwendet. Wenn dieser Wert verwendet wird, schlägt die Anfrage fehl.
AU_ETOLL_TAG Sydney-Mautpass. Weitere Informationen finden Sie unter https://www.myetoll.com.au.
AU_EWAY_TAG Sydney-Mautpass. Weitere Informationen finden Sie unter https://www.tollpay.com.au.
AU_LINKT Australien-weite Mautpass. Weitere Informationen finden Sie unter https://www.linkt.com.au/.
AR_TELEPASE argentinischer Mautpass. Weitere Informationen finden Sie unter https://telepase.com.ar.
BR_AUTO_EXPRESO Brasilien Mautpass. Weitere Informationen finden Sie unter https://www.autoexpreso.com.
BR_CONECTCAR Brasilien Mautpass. Weitere Informationen finden Sie unter https://conectcar.com.
BR_MOVE_MAIS Brasilien Mautpass. Weitere Informationen finden Sie unter https://movemais.com.
BR_PASSA_RAPIDO Brasilien Mautpass. Weitere Informationen finden Sie unter https://pasorapido.gob.do/.
BR_SEM_PARAR Brasilien Mautpass. Weitere Informationen finden Sie unter https://www.semparar.com.br.
BR_TAGGY Brasilien Mautpass. Weitere Informationen finden Sie unter https://taggy.com.br.
BR_VELOE Brasilien Mautpass. 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 Bezahlung von Mautgebühren bereitgestellt wird. Alle E-Cards über Banken werden gleich berechnet, sodass nur ein enum-Wert erforderlich ist. Beispiel: – 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: Ausnahmeregelung für HP-Staaten
JP_ETC Japan usw. Elektronisches Funksystem zur Erfassung von Mautgebühren. https://www.go-etc.jp/
JP_ETC2 Japan ETC2.0. Neue Version von ETC mit weiteren Rabatten und bidirektionaler Kommunikation zwischen Geräten an Fahrzeugen und Antennen auf der Straße. https://www.go-etc.jp/etc2/index.html
MX_IAVE Mautpass 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 Mautpassanbieter in Mexiko. Eines von vielen, die in Mexiko-Stadt tätig sind. Weitere Informationen finden Sie unter https://www.televia.com.mx.
MX_TELEVIA Mautpassanbieter in Mexiko. Eines von vielen, die in Mexiko-Stadt tätig sind. 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 Alabama, USA.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, USA.
US_CA_FASTRAK Kalifornien, USA.
US_CA_FASTRAK_CAV_STICKER Gibt an, dass der Fahrer zusätzlich zum von der DMV ausgestellten Aufkleber für saubere Luftfahrzeuge (CAV) einen FasTrak-Plakette hat. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, USA.
US_CO_GO_PASS CO, USA.
US_DE_EZPASSDE Deutschland, USA.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS Florida, USA.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD Florida, USA.
US_FL_EPASS Florida, USA.
US_FL_GIBA_TOLL_PASS Florida, USA.
US_FL_LEEWAY Florida, USA.
US_FL_SUNPASS Florida, USA.
US_FL_SUNPASS_PRO Florida, 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 Massachusetts, USA.
US_MD_EZPASSMD MD, USA.
US_ME_EZPASSME ME, USA.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD Michigan, USA.
US_MI_BCPASS Michigan, USA.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG Michigan, USA.
US_MI_IQ_PROX_CARD

Michigan, USA. Eingestellt, da dieser Karten-/Tickettyp nicht mehr vorhanden ist.

US_MI_IQ_TAG Michigan, USA.
US_MI_MACKINAC_BRIDGE_MAC_PASS Michigan, USA.
US_MI_NEXPRESS_TOLL Michigan, USA.
US_MN_EZPASSMN MN, USA.
US_NC_EZPASSNC North Carolina, USA.
US_NC_PEACH_PASS North Carolina, USA.
US_NC_QUICK_PASS North Carolina, 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 Ohio, USA.
US_PA_EZPASSPA PA, USA.
US_RI_EZPASSRI Rhode Island, USA
US_SC_PALPASS SC, USA.
US_TX_AVI_TAG Texas, USA.
US_TX_BANCPASS Texas, USA.
US_TX_DEL_RIO_PASS Texas, USA.
US_TX_EFAST_PASS Texas, USA.
US_TX_EAGLE_PASS_EXPRESS_CARD Texas, USA.
US_TX_EPTOLL Texas, USA.
US_TX_EZ_CROSS Texas, USA.
US_TX_EZTAG Texas, USA.
US_TX_FUEGO_TAG Texas, USA.
US_TX_LAREDO_TRADE_TAG Texas, USA.
US_TX_PLUSPASS Texas, USA.
US_TX_TOLLTAG Texas, USA.
US_TX_TXTAG Texas, USA.
US_TX_XPRESS_CARD Texas, USA.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD Utah, USA.
US_VA_EZPASSVA Virginia, USA.
US_WA_BREEZEBY Washington, USA
US_WA_GOOD_TO_GO Washington, 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 aus, der in der Antwort im Feld duration zurückgegeben wird. Er enthält die vorhergesagte Zeit im Traffic basierend auf historischen Durchschnittswerten.

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, wenn anhand der bisherigen Daten zur Verkehrslage und zur aktuellen Verkehrslage die beste Schätzung ermittelt wird. Die aktuelle Verkehrslage wird umso stärker gewichtet, je näher die departure_time rückt.
PESSIMISTIC Gibt an, dass die zurückgegebene Dauer länger sein sollte als die tatsächliche Reisezeit an den meisten Tagen. An Tagen mit besonders schlechter Verkehrslage kann dieser Wert jedoch überschritten werden.
OPTIMISTIC Gibt an, dass die zurückgegebene Dauer kürzer sein sollte als die tatsächliche Reisezeit an den meisten Tagen. 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 formatierte Telefonnummer des Verkehrsverbunds.

uri

string

Der URI des Verkehrsverbunds.

TransitLine

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

Felder
agencies[]

TransitAgency

Der oder die Betreiber der ÖPNV-Linie.

name

string

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

uri

string

URI für diese ÖPNV-Linie, wie sie vom Betreiber bereitgestellt wurde.

color

string

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

icon_uri

string

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

name_short

string

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

text_color

string

Die übliche Farbe, die im Text auf Beschilderungen 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. Die Standardeinstellung ist alle unterstützten Mobilitätsformen.

routing_preference

TransitRoutingPreference

Eine Routingeinstellung, die, sofern angegeben, die zurückgegebene Route TRANSIT beeinflusst.

TransitRoutingPreference

Gibt Routeneinstellungen für Routen mit öffentlichen Verkehrsmitteln an.

Enums
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED Keine Einstellung angegeben.
LESS_WALKING Gibt an, dass die berechnete Route möglichst wenige Gehstrecken enthalten soll.
FEWER_TRANSFERS Gibt an, dass für die berechnete Route eine begrenzte Anzahl von Umstiegen bevorzugt werden soll.

TransitTravelMode

Eine Reihe von Werten zur Angabe der Mobilitätsform.

Enums
TRANSIT_TRAVEL_MODE_UNSPECIFIED Keine Mobilitätsform angegeben.
BUS und mit dem Bus.
SUBWAY U-Bahn.
TRAIN Reisen Sie mit dem Zug.
LIGHT_RAIL Mit der Stadtbahn oder Straßenbahn fahren.
RAIL Zugreisen. 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 in Breiten- und Längengraden.

TransitVehicle

Informationen zu einem Fahrzeug, das auf Routen mit öffentlichen Verkehrsmitteln verwendet wird.

Felder
name

LocalizedText

Der Name dieses Fahrzeugs in Großbuchstaben.

type

TransitVehicleType

Der Typ des verwendeten Fahrzeugs.

icon_uri

string

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

local_icon_uri

string

Der URI für das Symbol, das diesem Fahrzeugtyp zugeordnet ist, basierend auf der Beschilderung für lokale Verkehrsmittel.

TransitVehicleType

Der Fahrzeugtyp für Routen mit öffentlichen Verkehrsmitteln.

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 Die Maßeinheiten sind nicht angegeben. Die Standardeinstellung ist die aus der Anfrage abgeleitete Maßeinheit.
METRIC Metrische Maßeinheiten.
IMPERIAL Angloamerikanische Maßeinheiten.

VehicleEmissionType

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

Enums
VEHICLE_EMISSION_TYPE_UNSPECIFIED Keine Emissionstyp angegeben. Standardeinstellung ist GASOLINE.
GASOLINE Fahrzeug mit Benzin/Benzin.
ELECTRIC Ein strombetriebenes Fahrzeug.
HYBRID Fahrzeug mit Hybridantrieb, z. B. Benzin und Elektro.
DIESEL Fahrzeug mit Dieselkraftstoff.

VehicleInfo

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

Felder
emission_type

VehicleEmissionType

Beschreibt die Emissionsart des Fahrzeugs. Gilt nur für DRIVE-RouteTravelMode.

Zwischenstopp

Schließt einen Wegpunkt ein. Wegpunkte markieren sowohl den Anfang als auch das Ende einer Route und beinhalten Zwischenstopps.

Felder
via

bool

Markiert diesen Wegpunkt als Meilenstein und nicht als Stopppunkt Für jeden Wegpunkt, der keine Wegbeschreibung in der Anfrage ist, wird in der Antwort ein Eintrag an das Array legs angehängt, um die Details zu Aufenthalten auf diesem Abschnitt der Fahrt anzugeben. Setzen Sie diesen Wert auf "true", wenn die Route diesen Wegpunkt passieren soll, ohne anzuhalten. Via-Wegpunkte bewirken nicht, dass dem Array legs ein Eintrag hinzugefügt wird, aber sie führen die Reise über den Wegpunkt. Sie können diesen Wert nur für Wegpunkte festlegen, die Zwischenpunkte sind. Die Anfrage schlägt fehl, wenn Sie dieses Feld auf Wegpunkte der Endstation festlegen. Wenn ComputeRoutesRequest.optimize_waypoint_order auf „true“ gesetzt ist, kann dieses Feld nicht auf „true“ festgelegt werden. Andernfalls schlägt die Anfrage fehl.

vehicle_stopover

bool

Gibt an, dass der Wegpunkt für Fahrzeuge vorgesehen ist, an denen Fahrzeuge ein- oder aussteigen sollen. Wenn Sie diesen Wert festlegen, enthält die berechnete Route keine Wegpunkte außerhalb von via auf Straßen, die für das Ein- und Aussteigen nicht geeignet sind. Diese Option funktioniert nur für die Mobilitätsform DRIVE und TWO_WHEELER und nur dann, wenn die location_type Location ist.

side_of_road

bool

Gibt an, dass der Standort dieses Wegpunkts das Fahrzeug bevorzugt an einer bestimmten Straßenseite halten soll. Wenn Sie diesen Wert festlegen, verläuft die Route durch den Standort, sodass das Fahrzeug an der Straßenseite anhalten kann, zu der der Standort gewichtet ist. Diese Option funktioniert nur für DRIVE und TWO_WHEELER RouteTravelMode.

Union-Feld location_type. Verschiedene Möglichkeiten zur Darstellung eines Standorts Für location_type ist nur einer der folgenden Werte zulässig:
location

Location

Ein Punkt, der mithilfe geografischer Koordinaten angegeben wird, einschließlich einer optionalen Richtung.

place_id

string

Die mit dem Wegpunkt verknüpfte POI-Orts-ID.

address

string

Eine visuell lesbare Adresse oder ein Plus Code Weitere Informationen finden Sie unter https://plus.codes.