Package google.maps.routing.v2 (Automotive)

Index

DynamicAttributeService

Der Dynamic Attribute Service, der die AnnotatePaths API enthält.

AnnotatePaths

rpc AnnotatePaths(AnnotatePathsRequest) returns (AnnotatePathsResponse)

Gibt die segmentbasierten Eingabepfade mit Anmerkungen für dynamische Attribute entlang der Pfade zurück.

Routes

Routes API

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Ruft 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 mit dem URL-Parameter $fields oder fields oder mithilfe des HTTP-/gRPC-Headers X-Goog-FieldMask angeben. Weitere Informationen zu verfügbaren URL-Parametern und -Headern Der Wert ist eine durch Kommas getrennte Liste von Feldpfaden. Ausführliche Informationen zum Erstellen der Feldpfade finden Sie in dieser Dokumentation.

Beispiel:

  • Feldmaske aller verfügbaren Felder (zur manuellen Überprüfung): X-Goog-FieldMask: *
  • Feldmaske mit Routendauer, Entfernungen, Elementstatus, Bedingung und Elementindexen (Beispiel für eine 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 erscheinen. Google rät von der Verwendung der Platzhalterantwortfeldmaske (*) ab, und zwar aus folgenden Gründen:

  • Wenn Sie nur die Felder auswählen, die Sie benötigen, spart unser Server Rechenzyklen, sodass wir Ihnen das Ergebnis mit einer geringeren Latenz zurückgeben können.
  • Wenn Sie nur die Felder auswählen, die Sie in Ihrem Produktionsjob benötigen, wird eine stabile Latenzleistung sichergestellt. Möglicherweise werden in Zukunft weitere Antwortfelder hinzugefügt, die möglicherweise zusätzliche Rechenzeit erfordern. 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 benötigten Felder auswählen, verringert sich die Antwortgröße und damit der Netzwerkdurchsatz.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Gibt die primäre Route zusammen mit optionalen alternativen Routen für eine Reihe von Terminal- und Zwischenwegpunkten zurück.

HINWEIS:Bei dieser Methode müssen Sie in der Eingabe eine Antwortfeldmaske angeben. Sie können die Antwortfeldmaske über den URL-Parameter $fields oder fields oder einen HTTP-/gRPC-Header X-Goog-FieldMask angeben. Weitere Informationen zu verfügbaren URL-Parametern und -Headern Der Wert ist eine durch Kommas getrennte Liste von Feldpfaden. Ausführliche Informationen zum Erstellen der Feldpfade finden Sie hier.

Beispiel:

  • Feldmaske aller verfügbaren Felder (zur manuellen Überprü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 von der Verwendung der Platzhalterantwortfeldmaske (*) oder der Angabe der Feldmaske auf oberster Ebene (routes) ab, da:

  • Wenn Sie nur die Felder auswählen, die Sie benötigen, spart unser Server Rechenzyklen, sodass wir Ihnen das Ergebnis mit einer geringeren Latenz zurückgeben können.
  • Wenn Sie nur die Felder auswählen, die Sie in Ihrem Produktionsjob benötigen, wird eine stabile Latenzleistung sichergestellt. Möglicherweise werden in Zukunft weitere Antwortfelder hinzugefügt, die möglicherweise zusätzliche Rechenzeit erfordern. 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 benötigten Felder auswählen, verringert sich die Antwortgröße und damit der Netzwerkdurchsatz.

AnnotatePathsRequest

Eine Anfrage an die AnnotatePaths API. Die Pfade werden so mit Anmerkungen versehen, als würde ein Fahrzeug die einzelnen Pfade zum aktuellen Zeitpunkt befahren.

Anmerkungen zu einem Segment können je nach Pfad variieren. So kann beispielsweise in Pfad 1 und Pfad 2 dasselbe Segment A vorhanden sein. In Pfad 1 folgt Segment A von Segment B und in Pfad 2 Segment A gefolgt von Segment C. In Segment A werden möglicherweise unterschiedliche dynamische Attribute für Pfad 1 und Pfad 2 zurückgegeben, basierend auf der Differenz in nachfolgenden Segmenten.

Felder
paths[]

Path

Erforderlich. Die angeforderten Routen, die mit dynamischen Attributdaten gefüllt werden sollen. Alle Pfade sollten dasselbe Startsegment haben, also das Segment, in dem sich das Fahrzeug gerade befindet. Es wird angenommen, dass sich das Fahrzeug am Anfang des ersten Abschnitts befindet. Wenn Pfade nicht bei demselben Segment beginnen, wird ein Fehler zurückgegeben.

annotation_options

AnnotationOptions

Erforderlich. Die angeforderten dynamischen Datenattribute, die den Eingabepfaden hinzugefügt werden sollen. Wenn das Feld leer ist, wird die Anfrage nicht annotiert.

AnnotatePathsResponse

AnnotatePathsResponse enthält die Eingabepfade mit zusätzlichen Daten, die für alle angeforderten Annotationen hinzugefügt wurden.

Felder
annotated_paths[]

AnnotatedPath

Pfade aus der Eingabe, die mit angeforderten Attributen annotiert wurden.

AnnotatedPath

Eine Kopie eines Eingabepfads, der mit vorhergesagten Attributen zurückgegeben wurde.

Felder
annotated_segments[]

AnnotatedSegment

Eine geordnete Liste von Segmenten, die den Hauptpfad bilden und mit angeforderten Attributen versehen sind.

AnnotatedSegment

Ein Segment, das einen Pfad aufbaut und mit dynamischen Datenattributen gekennzeichnet ist.

Felder
segment

Segment

Segmentdetails, die zur Unterscheidung von anderen Segmenten dienen.

segment_span_attributes[]

SegmentSpanAttribute

Dem Segment zugewiesene Attribute. Diese Attribute können sich je nach Pfad unterscheiden, in dem sich ein Segment befindet. Eine Spanne kann das gesamte Segment abdecken. Attribut-Spans sind in der Reihenfolge vom Fahrzeugstandort bis zum Ende des Pfads angeordnet.

AnnotationOptions

Angeforderte Annotationen für die Eingabepfade.

Felder
include_level_of_service

bool

Optional. Ist die Richtlinie auf „true“ gesetzt, werden die Segmente in der Antwort mit prognostizierten Traffic-Werten versehen. „Servicelevel“ ist ein allgemein verwendeter Begriff, um die Kategorisierung des Trafficflusses zu beschreiben, aber die Ebene der Dienstdefinitionen in dieser API gehört allein zu dieser API.

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 Anzahl der Startorte und der Anzahl der Zielorte, die als place_id oder address angegeben sind, darf nicht größer als 50 sein.
  • Das Produkt aus Anzahl der Startorte × Anzahl der Zielorte darf in keinem Fall größer als 625 sein.
  • Das Produkt aus Anzahl der Startorte × Anzahl der Ziele darf nicht größer als 100 sein, wenn „routing_preference“ auf TRAFFIC_AWARE_OPTIMAL festgelegt ist.
  • Das Produkt aus Anzahl der Start- und 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 werden soll. Der Server versucht, die ausgewählte Routingeinstellung zur Berechnung der Route zu verwenden. Wenn die Routingeinstellung zu einem Fehler oder zu einer extrem 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: Du kannst ein departure_time in der Vergangenheit nur 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 Sprache der Benutzeroberfläche vom Standort des ersten Ursprungs 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 zum Ausführen der Anfrage verwendet werden können. Hinweis: Diese zusätzlichen Berechnungen geben möglicherweise zusätzliche Felder für die Antwort zurück. 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. Es enthält die vorhergesagte Reisezeit basierend auf den bisherigen Durchschnittswerten. RoutingPreference zu TRAFFIC_AWARE_OPTIMAL und RouteTravelMode zu DRIVE. Wenn Traffic angefordert und TrafficModel nicht angegeben wird, wird standardmäßig BEST_GUESS verwendet.

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

ExtraComputation

Zusätzliche Berechnungen, die während der Ausführung 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. Wegpunkt des Startorts.

destination

Waypoint

Erforderlich. Wegpunkt des Ziels.

intermediates[]

Waypoint

Optional. Eine Reihe von Wegpunkten entlang der Route (ohne Startpunkte), um an einem Ort zu halten oder an diesem vorbeizukommen. 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 ausgewählte Routingeinstellung zur Berechnung der Route zu verwenden. Wenn die Routingeinstellung zu einem Fehler oder zu einer extrem 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: Du kannst ein departure_time in der Vergangenheit nur angeben, wenn RouteTravelMode auf TRANSIT festgelegt ist. Fahrten mit öffentlichen Verkehrsmitteln 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: 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 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 die Art und Weise der Routenberechnung beeinflussen.

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 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 die Route, den Streckenabschnitt, die Schrittstrecke und die 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 die Richtlinie auf „true“ gesetzt ist, versucht der Dienst, die Gesamtkosten der Route durch eine Neuanordnung der angegebenen Wegpunkte zu minimieren. Die Anfrage schlägt fehl, wenn einer der Wegpunkte 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. Ist optimize_waypoint_order auf „false“ gesetzt, ist ComputeRoutesResponse.optimized_intermediate_waypoint_index leer.

requested_reference_routes[]

ReferenceRoute

Optional. Gibt an, welche Referenzrouten als Teil der Anfrage zusätzlich zur Standardroute berechnet werden sollen. Eine Referenzroute ist eine Route mit einem anderen Routenberechnungsziel als die Standardroute. Bei einer Berechnung der FUEL_EFFICIENT-Referenzroute werden beispielsweise verschiedene Parameter berücksichtigt, die eine optimale spritsparende Route generieren.

extra_computations[]

ExtraComputation

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

route_token
(deprecated)

string

Optional. Eingestellt: Verwenden Sie stattdessen route_token_options.route_token.

route_token_options

RouteTokenOptions

Optional. Mithilfe von Routentokens kann eine Anfrage von einer zuvor ausgewählten Route abhängig sein.

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. Dieses Feld enthält die voraussichtliche Reisezeit basierend auf den bisherigen Durchschnittswerten. TrafficModel ist nur für Anfragen verfügbar, in denen RoutingPreference auf TRAFFIC_AWARE_OPTIMAL und RouteTravelMode auf DRIVE festgelegt wurde. Wenn Traffic angefordert und TrafficModel nicht angegeben wird, wird standardmäßig BEST_GUESS verwendet.

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

navigation_session_id

string

Optional. Die vom Client generierte Navigationssitzungs-ID, die zum Verknüpfen dieser Routenanfrage mit Navigationsprotokollen des Clients für die Navigationsanalyse verwendet wird. Dabei sollte es sich um eine zufällig generierte RFC 4122-konforme UUID handeln, die für eine bestimmte Navigationssitzung eindeutig ist.

ExtraComputation

Zusätzliche Berechnungen, die während der Ausführung 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, bei denen der Datenverkehr berücksichtigt wird, 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. Er dient nur zur Anzeige. Parsen Sie ihn nicht programmatisch.
PREDICTED_SPEED_ON_POLYLINE_20KPH_BUCKETS Voraussichtliche Geschwindigkeit: 20 km/h Eimer.
PREDICTED_SPEED_ON_POLYLINE_10KPH_BUCKETS Voraussichtliche Geschwindigkeit: 10 km/h Eimer.

ReferenceRoute

Eine unterstützte Referenzroute in der ComputeRoutesRequest.

Enums
REFERENCE_ROUTE_UNSPECIFIED Nicht verwendet. Anfragen mit diesem Wert schlagen fehl.
FUEL_EFFICIENT Spritsparende Route. Routen, die mit diesem Wert gekennzeichnet sind, sind im Hinblick auf Parameter wie den Kraftstoffverbrauch optimiert.

ComputeRoutesResponse

ComputeRoute leitet die Antwortnachricht weiter.

Felder
routes[]

Route

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

fallback_info

FallbackInfo

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

geocoding_results

GeocodingResults

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

FallbackInfo

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

Felder
routing_mode

FallbackRoutingMode

Für die Antwort verwendeter Routingmodus. 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 eine Fallback-Antwort anstelle der ursprünglichen Antwort verwendet wurde. Dieses Feld wird nur gefü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 Bei der Berechnung von Routen mit Ihrem bevorzugten Routingmodus ist ein Serverfehler aufgetreten, wir konnten jedoch ein Ergebnis zurückgeben, das von einem anderen Modus berechnet wurde.
LATENCY_EXCEEDED Wir konnten die Berechnung nicht pünktlich mit deinem bevorzugten Routingmodus abschließen, aber wir konnten ein Ergebnis zurückgeben, das von einem anderen 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 Orten, die als Wegpunkte verwendet wurden Wird nur für Wegpunkte in Adressen ausgefüllt. Enthält Details zu den Geocoding-Ergebnissen, anhand derer die Adresse ermittelt werden kann, in der 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 Tag-Typen. 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

Index des entsprechenden Wegpunkts in der Anfrage Dieses Feld wird nur ausgefüllt, wenn der entsprechende Wegpunkt ein Zwischenwegpunkt ist.

GeocodingResults

Enthält GeocodedWaypoints für Start- und Zielort und Wegpunkte. Wird nur für Wegpunkte in Adressen ausgefüllt.

Felder
origin

GeocodedWaypoint

Vom Startort geocodierter Wegpunkt.

destination

GeocodedWaypoint

Geocodierter Wegpunkt des Ziels.

intermediates[]

GeocodedWaypoint

Eine Liste geocodierter Zwischenwegpunkte mit jeweils einem Indexfeld, das der nullbasierten Position des Wegpunkts in der Reihenfolge entspricht, in der sie in der Anfrage angegeben wurden.

LevelOfService

Vorhergesagte Traffic-Bucket-Werte zur Verwendung für die ADAS-Funktionalität, die dem allgemeinen Traffic entsprechen. Die von dieser API zurückgegebenen Werte sind unabhängig und sollten nicht als Werte anderer APIs herangezogen werden.

Enums
LEVEL_OF_SERVICE_UNSPECIFIED Standardwert. Dieser Wert bedeutet, dass kein prognostizierter Traffic-Wert verfügbar ist.
LEVEL_OF_SERVICE_STOPPED Der Verkehr wurde angehalten.
LEVEL_OF_SERVICE_STOP_AND_GO Stop-and-drop.
LEVEL_OF_SERVICE_SLOW Es wird ein Stau erwartet, es werden aber keine Staus vorhergesagt.
LEVEL_OF_SERVICE_NORMAL Normale Geschwindigkeit, es wird keine Verlangsamung vorhergesagt.

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

Zusammenfassung eines Standorts (ein geografischer Punkt und eine optionale Ausrichtung)

Felder
lat_lng

LatLng

Die geografischen Koordinaten des Wegpunkts

heading

Int32Value

Die Kompassrichtung, die der Verkehrsrichtung zugeordnet ist. Dieser Wert gibt die Straßenseite für Abholung und Ausstieg an. Die Richtung kann zwischen 0 und 360 liegen, wobei 0 eine Richtung nach Norden, 90 eine Richtung nach Osten usw. angibt. Sie können dieses Feld nur für DRIVE und TWO_WHEELER RouteTravelMode verwenden.

Manövrieren

Eine Reihe von Werten, die die Navigationsaktion für den aktuellen Schritt angeben, z. B. „Nach links abbiegen“, „Zusammenführung“ oder „Geradeaus“.

Enums
MANEUVER_UNSPECIFIED Nicht verwendet.
TURN_SLIGHT_LEFT Biegen Sie leicht nach links ab.
TURN_SHARP_LEFT Scharf nach links abbiegen.
UTURN_LEFT Nach links wenden.
TURN_LEFT Biegen Sie nach links ab.
TURN_SLIGHT_RIGHT Biegen Sie leicht nach rechts ab.
TURN_SHARP_RIGHT Scharf nach rechts abbiegen.
UTURN_RIGHT Nach rechts wenden.
TURN_RIGHT Biegen Sie nach rechts ab.
STRAIGHT Geradeaus.
RAMP_LEFT Nehmen Sie die linke Auffahrt.
RAMP_RIGHT Nehmen Sie die rechte Auffahrt.
MERGE In Verkehrslage integrieren
FORK_LEFT Nehmen Sie die linke Gabelung.
FORK_RIGHT Nehmen Sie die richtige Gabel.
FERRY Nehmen Sie die Fähre.
FERRY_TRAIN Nehmen Sie den Zug, der zur Fähre führt.
ROUNDABOUT_LEFT Beim Kreisverkehr links abbiegen.
ROUNDABOUT_RIGHT Biegen Sie beim Kreisverkehr rechts ab.
DEPART Erste Vorgehensweise
NAME_CHANGE Wird verwendet, um eine Änderung des Straßennamens anzuzeigen.

Kapselt die Navigationsanweisungen für eine RouteLegStep.

Felder
maneuver

Maneuver

Enthält die Navigationsanweisungen für den aktuellen Schritt (z. B. „Nach links abbiegen“, „Zusammenführung“ oder „Geradeaus“). Dieses Feld bestimmt, welches Symbol angezeigt werden soll.

instructions

string

Anleitung zum Navigieren in diesem Schritt.

Pfad

Ein Pfad, für den dynamische Attribute angefordert werden.

Ein Pfad sollte miteinander verbundene und befahrbare Segmente enthalten. Es wird angenommen, dass die Segmente eines Pfads einer logischen Route folgen. Wenn in den Eingabesegmenten keine Route gefunden werden kann, wird ein Fehler zurückgegeben. Wenn beispielsweise Segmente in einem Pfad keine Verbindungsendpunkte haben oder ein Pfad leer ist, wird ein Fehler ausgegeben.

Eine Strecke ist derzeit auf 15 km Länge beschränkt. Die Strecke wird vom Anfang des ersten Abschnitts aus gemessen, also vom angenommenen Fahrzeugstandort. Ein Fehler wird zurückgegeben, wenn ein Segment in einem Pfad weiter als 15 km vom Anfang des ersten Abschnitts entfernt beginnt. Es ist zulässig, dass der letzte Abschnitt vor 15 km beginnt und über 15 km endet. Es werden keine Teilantworten zurückgegeben.

Ein Pfad kann dieselben Segmente wie ein anderer Pfad enthalten. Die Segmentanmerkungen können jedoch aufgrund von Unterschieden in anderen Teilen des Pfads unterschiedliche Antworten enthalten.

Felder
segments[]

Segment

Erforderlich. Eine geordnete Liste von Segmenten, die den Pfad bildet.

Polyline

Kapselt eine codierte Polylinie ein.

Felder
Union-Feld polyline_type. Zusammenfassung des Polylinientyps. Die Standardeinstellung ist Encrypted_polyline. Für polyline_type ist nur einer der folgenden Werte zulässig:
encoded_polyline

string

Die Stringcodierung der Polylinie mit dem Algorithmus zur Codierung von Polylinien.

geo_json_linestring

Struct

Gibt eine Polylinie im GeoJSON-LineString-Format 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) definiert PolylineDetails ein Intervall und zugehörige Metadaten.

Felder
altitude_info[]

AltitudeInfo

Höhendetails entlang der Polylinie

incident_info[]

IncidentInfo

Details zu Vorfällen entlang der Polylinie

segment_info[]

SegmentInfo

Segmentdetails entlang der Polylinie.

ferry_info[]

FerryInfo

Fährendetails entlang der Polylinie Dieses Feld wird nur gefüllt, wenn in einer Anfrage der Routenmodifikator avoid_ferries angegeben ist und die resultierende Route nicht vermieden werden kann. Andernfalls wird dieses Feld nicht verwendet.

highway_info[]

HighwayInfo

Autobahndetails entlang der Polylinie. Dieses Feld wird nur gefüllt, wenn in einer Anfrage der Routenmodifikator avoid_highways angegeben ist und die resultierende Route nicht vermieden werden kann. Andernfalls wird dieses Feld nicht verwendet.

toll_info[]

TollInfo

Mautdetails entlang der Polylinie. Dieses Feld wird nur gefüllt, wenn in einer Anfrage der Routenmodifikator avoid_tolls angegeben ist und die resultierende Route nicht vermieden werden kann. Andernfalls wird dieses Feld nicht verwendet.

tunnel_info[]

TunnelInfo

Tunneldetails entlang der Polylinie. Dieses Feld wird nur gefüllt, wenn in einer Anfrage der Routenmodifikator avoid_tunnels angegeben ist und die resultierende Route nicht vermieden werden kann. Andernfalls wird dieses Feld nicht verwendet.

vignette_info[]

VignetteInfo

Vignettendetails entlang der Polylinie. Dieses Feld wird nur gefüllt, wenn in einer Anfrage der Routenmodifikator avoid_vignettes angegeben ist und die resultierende Route nicht vermieden werden kann. Andernfalls wird dieses Feld nicht verwendet.

hov_info[]

HovInfo

Hov-Details entlang der Polylinie Dieses Feld wird nur ausgefüllt, wenn in einer Anfrage der Routenmodifikator allow_hov angegeben ist und die resultierende Route ihn enthält. Andernfalls wird dieses Feld nicht verwendet.

restriction_info[]

RestrictionInfo

Details zur Einschränkung entlang der Polylinie. Dieses Feld wird nur gefüllt, wenn in einer Anfrage der Routenmodifikator vehicle_info angegeben ist und die resultierende Route eine entsprechende Einschränkung enthält. Andernfalls wird dieses Feld nicht verwendet.

predicted_speeds[]

PredictedSpeedInfo

Buckets mit vorhergesagter Geschwindigkeit entlang der Polylinie

AltitudeInfo

Umfasst Informationen zur Höhe entlang der Polylinie.

Felder
polyline_point_index

PolylinePointIndex

Der Standort der Höhenmessung entlang der Polylinie.

altitude_meters

double

Höhe in Metern zum WGS-84-Ellipsoid.

FerryInfo

Kapselt Informationen zu Fähren entlang der Polylinie.

Felder
ferry_presence

RoadFeatureState

Nur Ausgabe Gibt an, ob für einen bestimmten Abschnitt der Polylinie eine Fähre vorhanden ist.

polyline_point_index

PolylinePointIndex

Der Standort der Fährinformationen entlang der Polylinie.

HighwayInfo

Umfasst Informationen zu Autobahnen entlang der Polylinie.

Felder
highway_presence

RoadFeatureState

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

polyline_point_index

PolylinePointIndex

Der Standort von Autobahninformationen entlang der Polylinie.

HovInfo

Kapselt Informationen zu Carpool-Segmenten/-spuren entlang der Polylinie.

Felder
hov_presence

RoadFeatureState

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

polyline_point_index

PolylinePointIndex

Die Position von Carpool-Informationen entlang der Polylinie.

IncidentInfo

Umfasst Informationen zu einem Vorfall entlang der Polylinie.

Felder
incident_type

IncidentType

Die Art des Vorfalls.

estimated_delay

Duration

Geschätzte Verzögerung im Verhältnis zur normalen Durchsuchungszeit. Nur für INCIDENT_JAM zurückgegeben.

polyline_point_index

PolylinePointIndex

Der Standort des Vorfalls entlang der Polylinie.

IncidentType

Die Arten von Vorfällen.

Enums
INCIDENT_TYPE_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
INCIDENT_ROAD_CLOSED Eine Straßensperrung.
INCIDENT_CRASH Ein Unfall.
INCIDENT_CONSTRUCTION Bau
INCIDENT_JAM Stau.

PolylinePointIndex

Kapselt die Start- und Endindexe für ein Polyliniendetail ein. 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.

PredictedSpeedInfo

Kapselt Informationen zu vorhergesagten Geschwindigkeiten entlang der Polylinie auf.

Felder
predicted_speed_interval

PredictedSpeedInterval

Der für diesen Teil der Polylinie vorhergesagte Geschwindigkeitsbereich.

polyline_point_index

PolylinePointIndex

Der Ort des vorhergesagten Geschwindigkeitsintervalls entlang der Polylinie.

PredictedSpeedInterval

Flexibles Intervall für vorhergesagte Geschwindigkeit. Wenn die Obergrenze nicht ausgefüllt ist, umfasst das Intervall alle Werte, die größer als die Untergrenze für dieses Intervall sind. Bei Verwendung von Bucket-Optionen mit 20 km/h betragen die Intervalle: [0, 10) kph [10, 30) kph [30, 50) kmph [50, 70) kmph [70, 90) kmph [90, 110) kmph [110, 130) kmph [130“ kmph) inf)

Felder
lower_bound_kph_inclusive

int32

Dieses Intervall stellt Geschwindigkeiten in [lower_bound_kph_inclusive, upper_bound_kph_exclusive) dar.

upper_bound_kph_exclusive

int32

Siehe oben.

RestrictionInfo

Umfasst Informationen zu verschiedenen Einschränkungen entlang der Polylinie.

Felder
restriction_presence

RoadFeatureState

Nur Ausgabe Gibt an, ob für einen bestimmten Abschnitt der Polylinie eine Einschränkung gilt.

polyline_point_index

PolylinePointIndex

Der Ort der Einschränkungsinformationen entlang der Polylinie.

Union-Feld restriction. Kapselt die Arten von Einschränkungen ein, die auf eine bestimmte Streckenabschnittsweise der Polylinie angewendet werden können. Für restriction ist nur einer der folgenden Werte zulässig:
restricted_height_mm

int64

Das Höhenlimit in Millimetern. Dieses Feld wird nur in Fällen gefüllt, in denen ein Fahrer aufgrund der eingeschränkten Höhe einen Straßenabschnitt mit geringer Straßenfreiheit überqueren muss.

RoadFeatureState

Zusammenfassung der Bundesstaaten von Straßenelementen (z. B. Autobahnen oder Fähren) entlang eines Polylinienbereichs.

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

SegmentInfo

Umfasst Informationen zu Segmenten entlang der Polylinie.

Felder
place_id

string

Orts-ID für diesen Straßenabschnitt

polyline_point_index

PolylinePointIndex

Die Position des Segments entlang der Polylinie.

TollInfo

Enthält Informationen zu Mautgebühren entlang der Polylinie.

Felder
toll_presence

RoadFeatureState

Nur Ausgabe Gibt an, ob für einen bestimmten Abschnitt der Polylinie eine Maut erhoben wird.

polyline_point_index

PolylinePointIndex

Die Position von mautpflichtigen Informationen entlang der Polylinie.

TunnelInfo

Umfasst Informationen über Tunnel entlang der Polylinie.

Felder
tunnel_presence

RoadFeatureState

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

polyline_point_index

PolylinePointIndex

Der Standort von Tunnelinformationen entlang der Polylinie.

VignetteInfo

Kapselt Informationen zu Vignetten entlang der Polylinie ein.

Felder
vignette_presence

RoadFeatureState

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

polyline_point_index

PolylinePointIndex

Die Position von Informationen zu Vignetten entlang der Polylinie.

PolylineEncoding

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

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

PolylineQuality

Ein Satz von Werten, die die Qualität der Polylinie angeben.

Enums
POLYLINE_QUALITY_UNSPECIFIED Keine Einstellung für Polylinienqualität angegeben. Die Standardeinstellung ist OVERVIEW.
HIGH_QUALITY Gibt eine Polylinie von hoher Qualität an, die aus mehr Punkten als OVERVIEW besteht, allerdings auf Kosten einer größeren Antwortgröße. Verwenden Sie diesen Wert, wenn Sie mehr Genauigkeit benötigen.
OVERVIEW Gibt eine Übersichtspolygone an, die aus einer kleinen Anzahl von Punkten besteht. Verwenden Sie diesen Wert, wenn Sie eine Übersicht der Route anzeigen möchten. Die Verwendung dieser Option hat eine geringere Anfragelatenz als die Option HIGH_QUALITY.

Route

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

Felder
route_labels[]

RouteLabel

Labels für die Route, mit denen bestimmte Attribute der Route für den Vergleich mit anderen identifiziert werden können.

legs[]

RouteLeg

Mehrere Streckenabschnitte (Pfadsegmente zwischen Wegpunkten), die die Route ausmachen. Jeder Abschnitt entspricht der Fahrt zwischen zwei Nicht-via-Waypoints. Eine Route ohne Wegpunkte hat beispielsweise nur einen Streckenabschnitt. Eine Route mit einem Zwischenwegpunkt, der kein via ist, besteht aus zwei Streckenabschnitten. Eine Route mit einem via-Wegpunkt besteht aus einem 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 auf der Route erforderliche Zeit. Wenn Sie routing_preference auf TRAFFIC_UNAWARE festlegen, ist dieser Wert mit static_duration identisch. Wenn Sie für routing_preference entweder TRAFFIC_AWARE oder TRAFFIC_AWARE_OPTIMAL festlegen, wird bei der Berechnung dieses Werts die Verkehrslage berücksichtigt.

static_duration

Duration

Die Reisezeit auf der Route ohne Berücksichtigung der Verkehrslage.

polyline

Polyline

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

description

string

Eine Beschreibung der Route.

warnings[]

string

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

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 als Eingabe Folgendes angeben: Origin: L.A.; Zwischenwegpunkte: Dallas, Bangor, Phoenix; Zielort: New York und die optimierte Zwischenwegpunktreihenfolge Phoenix, Dallas, Bangor ist, enthält dieses Feld die Werte [2, 0, 1]. Der Index beginnt mit 0 für den ersten in der Eingabe angegebenen Zwischenwegpunkt.

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 die ursprüngliche Absicht beim Erstellen der Route durch Aufrufen von ComputeRoutes berücksichtigt wird. Kunden sollten dieses Token als intransparenten Blob behandeln. Sie ist nicht zum Lesen oder Ändern gedacht. HINWEIS: Route.route_token ist nur für Anfragen verfügbar, bei denen ComputeRoutesRequest.routing_preference auf TRAFFIC_AWARE oder TRAFFIC_AWARE_OPTIMAL festgelegt wurde. Route.route_token wird für Anfragen mit Via-Wegpunkten nicht unterstützt.

route_token_update_fidelity

RouteTokenUpdateFidelity

Wenn ComputeRouteRequests einen route_token enthält, ermittelt dieses Feld die Beziehung zwischen dieser Route und dem Eingabetoken.

polyline_details

PolylineDetails

Enthält Informationen zu Details entlang der Polylinie.

RouteLocalizedValues

Textdarstellungen bestimmter Attribute.

Felder
distance

LocalizedText

Entfernung in Textform.

duration

LocalizedText

Dauer unter Berücksichtigung der Verkehrslage in Textform. Hinweis: Wenn Sie keine Verkehrsinformationen angefordert haben, ist dieser Wert derselbe Wert wie static_duration.

static_duration

LocalizedText

Dauer ohne Berücksichtigung der Verkehrslage in Textform.

transit_fare

LocalizedText

Fahrpreis in Textform.

RouteTokenUpdateFidelity

Bei Anfragen, die route_token_behavior GET_ROUTE_UPDATES verwenden, identifiziert es Routen, die aus dem zugehörigen „route_token“ konstruiert sind. (Nicht im Zusammenhang mit route_token in dieser Nachricht stehen)

Enums
ROUTE_TOKEN_UPDATE_FIDELITY_UNSPECIFIED Diese Route wurde nicht aus einem Routentoken generiert.
APPROXIMATE Diese Route wird aus einem Routentoken rekonstruiert und ist logisch äquivalent, aber die Geometrie der Route ist nicht identisch.
IDENTICAL Diese Route ist mit einem Routentoken geometrisch identisch.

RouteLabel

Labels für die Route, mit denen bestimmte Attribute der Route für den Vergleich mit anderen identifiziert werden können.

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 standardmäßigen „besten“ Route. Routen wie diese werden zurückgegeben, wenn compute_alternative_routes angegeben ist.
FUEL_EFFICIENT Spritsparende Route. Routen, die mit diesem Wert gekennzeichnet sind, sind im Hinblick auf Eco-Parameter wie den Kraftstoffverbrauch optimiert.

RouteLeg

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

Felder
distance_meters

int32

Die Entfernung des Streckenabschnitts in Metern.

duration

Duration

Die Zeit, die für die Navigation im Streckenabschnitt benötigt wird. Wenn route_preference auf TRAFFIC_UNAWARE gesetzt ist, ist dieser Wert mit static_duration identisch. Ist route_preference entweder TRAFFIC_AWARE oder TRAFFIC_AWARE_OPTIMAL, wird dieser Wert unter Berücksichtigung der Verkehrslage berechnet.

static_duration

Duration

Die Reisedauer für diesen Abschnitt, berechnet ohne Berücksichtigung der Verkehrslage.

polyline

Polyline

Die gesamte Polylinie für diesen Streckenabschnitt, die die Polylinien der einzelnen step enthält.

start_location

Location

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

end_location

Location

Die Endposition dieses Abschnitts. Dieser Standort kann sich vom angegebenen destination unterscheiden. Wenn sich das 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 in diesem Abschnitt bezeichnen. Jeder Schritt entspricht einer Navigationsanweisung.

travel_advisory

RouteLegTravelAdvisory

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

localized_values

RouteLegLocalizedValues

Textdarstellungen von Attributen von RouteLeg.

steps_overview

StepsOverview

Hier finden Sie Informationen zu den Schritten in diesem RouteLeg. Dieses Feld wird nur für TRANSIT-Routen ausgefüllt.

RouteLegLocalizedValues

Textdarstellungen bestimmter Attribute.

Felder
distance

LocalizedText

Entfernung in Textform.

duration

LocalizedText

Dauer unter Berücksichtigung der Verkehrslage in Textform. Hinweis: Wenn Sie keine Verkehrsinformationen angefordert haben, ist dieser Wert derselbe Wert wie static_duration.

static_duration

LocalizedText

Dauer ohne Berücksichtigung der Verkehrslage in Textform.

StepsOverview

Liefert Übersichtsinformationen zu einer Liste von RouteLegSteps.

Felder
multi_modal_segments[]

MultiModalSegment

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

MultiModalSegment

Bietet zusammengefasste Informationen zu verschiedenen multimodalen Segmenten von RouteLeg.steps. Ein multimodales Segment ist als eine oder mehrere zusammenhängende RouteLegStep mit derselben RouteTravelMode definiert. Dieses Feld wird nicht ausgefüllt, wenn RouteLeg in den Schritten keine multimodalen Segmente 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 von einem RouteLeg. Ein Schritt entspricht einer einzelnen Navigationsanweisung. Routenabschnitte bestehen aus Stufen.

Felder
distance_meters

int32

Die Strecke dieses Schritts in Metern. Manchmal enthält dieses Feld keinen Wert.

static_duration

Duration

Die Reisedauer für diesen Schritt, ohne die Verkehrslage zu berücksichtigen. Manchmal enthält dieses Feld keinen Wert.

polyline

Polyline

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

Navigationshinweise.

travel_advisory

RouteLegStepTravelAdvisory

Enthält die zusätzlichen Informationen, über die der Nutzer informiert werden soll, z. B. mögliche Einschränkungen in Bezug auf Zonen für einen Streckenabschnitt.

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

Felder
distance

LocalizedText

Entfernung in Textform.

static_duration

LocalizedText

Dauer ohne Berücksichtigung der Verkehrslage in Textform.

RouteLegStepTransitDetails

Zusätzliche Informationen für die RouteLegStep zu TRANSIT-Routen.

Felder
stop_details

TransitStopDetails

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

localized_values

TransitDetailsLocalizedValues

Textdarstellungen von Attributen von RouteLegStepTransitDetails.

headsign

string

Die Fahrtrichtung für diese Linie, die auf dem Fahrzeug oder an der Abfahrtshaltestelle angegeben ist. Die Richtung ist oft die Endhaltestelle.

headway

Duration

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

transit_line

TransitLine

Informationen zur in diesem Schritt verwendeten ÖPNV-Linie.

stop_count

int32

Die Anzahl der Haltestellen von der Abfahrts- bis zur Ankunftshaltestelle. Diese Zahl umfasst die Zielhaltestelle, die Starthaltestelle jedoch nicht. Wenn Ihre Route beispielsweise an Haltestelle A abfährt, die Haltestellen B und C durchquert und an Haltestelle D ankommt, gibt „stop_count“ den Wert 3 zurück.

trip_short_text

string

Der Text, der in Fahrplänen und auf Anzeigetafeln erscheint und Fahrgästen eine Fahrt mit öffentlichen Verkehrsmitteln anzeigt. Der Text sollte eine Fahrt innerhalb eines Betriebstags eindeutig identifizieren. Beispielsweise ist „538“ der trip_short_text des Amtrak-Zug, der von San Jose, CA, an Werktagen um 15:10 Uhr nach Sacramento, CA fährt.

TransitDetailsLocalizedValues

Lokalisierte Beschreibungen der Werte für RouteTransitDetails.

Felder
arrival_time

LocalizedTime

Uhrzeit in formatierter Textdarstellung mit einer entsprechenden Zeitzone.

departure_time

LocalizedTime

Uhrzeit in formatierter Textdarstellung mit einer entsprechenden Zeitzone.

TransitStopDetails

Details zu den Haltestellen öffentlicher Verkehrsmittel am 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 diesen Schritt.

departure_time

Timestamp

Die voraussichtliche Abfahrtszeit für diesen Schritt.

RouteLegStepTravelAdvisory

Enthält die zusätzlichen Informationen, über die der Nutzer informiert werden soll, z. B. mögliche Einschränkungen in Bezug auf Zonen für einen Streckenabschnitt.

Felder
speed_reading_intervals[]

SpeedReadingInterval

HINWEIS: Dieses Feld ist derzeit nicht ausgefüllt.

RouteLegTravelAdvisory

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

Felder
toll_info

TollInfo

Enthält Informationen zu Mautgebühren für das angegebene RouteLeg. Dieses Feld wird nur ausgefüllt, wenn auf der RouteLeg Mautstraßen zu erwarten sind. Wenn dieses Feld festgelegt ist, das untergeordnete Feld „estimated_price“ jedoch nicht ausgefüllt ist, gehen wir davon aus, dass die Straße Mautstraßen enthält, wir kennen aber keine geschätzten Preise. Wenn dieses Feld nicht vorhanden ist, ist die RouteLeg gebührenpflichtig.

speed_reading_intervals[]

SpeedReadingInterval

Intervalle für Geschwindigkeitslesevorgänge, in denen die Verkehrsdichte detailliert angegeben wird. 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 des Ziels

RouteMatrixElement

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

Felder
status

Status

Fehlerstatuscode für dieses Element.

condition

RouteMatrixElementCondition

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

distance_meters

int32

Die Entfernung der Route in Metern.

duration

Duration

Die für die Navigation auf der Route erforderliche Zeit. Wenn Sie routing_preference auf TRAFFIC_UNAWARE festlegen, ist dieser Wert mit static_duration identisch. Wenn Sie für routing_preference entweder TRAFFIC_AWARE oder TRAFFIC_AWARE_OPTIMAL festlegen, wird bei der Berechnung dieses Werts die Verkehrslage berücksichtigt.

static_duration

Duration

Die Reisezeit auf der Route ohne Berücksichtigung der Verkehrslage.

travel_advisory

RouteTravelAdvisory

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

fallback_info

FallbackInfo

Wenn der Server die Route mit den angegebenen Präferenzen für dieses spezielle Start-/Zielpaar nicht berechnen kann, verwendet er in einigen Fällen eventuell einen anderen Berechnungsmodus. 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 Attribute.

Felder
distance

LocalizedText

Entfernung in Textform.

duration

LocalizedText

Dauer in Textform unter Berücksichtigung der Verkehrslage. Hinweis: Wenn keine Verkehrsinformationen angefordert wurden, ist dieser Wert derselbe Wert wie static_duration.

static_duration

LocalizedText

Dauer in Textform ohne Berücksichtigung der Verkehrslage.

transit_fare

LocalizedText

Fahrpreis in Textform.

RouteMatrixElementCondition

Der Zustand der Route, die zurückgegeben wird.

Enums
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Wird nur verwendet, wenn status des Elements nicht OK ist.
ROUTE_EXISTS Eine Route wurde gefunden und die entsprechenden Informationen für das Element wurden ausgefüllt.
ROUTE_NOT_FOUND 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. Wegpunkt des Startorts

route_modifiers

RouteModifiers

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

RouteModifiers

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

Felder
avoid_tolls

bool

Wenn diese Richtlinie auf „true“ gesetzt ist, werden mautpflichtige Straßen vermieden, wo es sinnvoll ist. Routen ohne Mautstraßen werden bevorzugt. Gilt nur für die RouteTravelMode-Objekte DRIVE und TWO_WHEELER.

avoid_highways

bool

Wenn diese Richtlinie auf „true“ gesetzt ist, werden Autobahnen vermieden, wo es sinnvoll ist. Routen ohne Autobahnen werden bevorzugt. Gilt nur für die RouteTravelMode-Objekte DRIVE und TWO_WHEELER.

avoid_ferries

bool

Ist die Richtlinie auf „true“ gesetzt, werden Fähren vermieden, wo es sinnvoll ist. Routen ohne Fähren werden bevorzugt. Gilt nur für DRIVE und TWO_WHEELER für RouteTravelMode.

avoid_indoor

bool

Wenn diese Richtlinie auf „true“ gesetzt ist, wird die Navigation innerhalb von Gebäuden vermieden, wo es sinnvoll ist. Routen, die keine Navigation innerhalb von Gebäuden enthalten, werden bevorzugt. Gilt nur für WALK-RouteTravelMode.

vehicle_info

VehicleInfo

Gibt die Fahrzeuginformationen an.

toll_passes[]

TollPass

Enthält Informationen zu Mautpässen. Wenn Mautkarten angegeben sind, versucht die API, den Preis der Karte bzw. des Tickets 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 RouteTravelMode-Objekte DRIVE und TWO_WHEELER.

avoid_tunnels

bool

Wenn diese Richtlinie auf „true“ gesetzt ist, werden Tunnel vermieden, wo dies sinnvoll ist. Routen ohne Tunnel werden bevorzugt. Gilt nur für die RouteTravelMode-Objekte DRIVE und TWO_WHEELER. RoutingPreference muss auf TRAFFIC_AWARE_OPTIMAL festgelegt sein. Dieses Feld wird in ComputeRouteMatrix nicht unterstützt.

avoid_vignettes[]

string

Wenn diese Richtlinie auf „true“ gesetzt ist, werden Straßen mit Vignetten in bestimmten Ländern vermieden, wo es sinnvoll ist. Routen, auf denen diese Funktion nicht verfügbar ist, werden in Ländern bevorzugt, in denen diese Funktion unterstützt wird. Gilt nur für die RouteTravelMode-Objekte DRIVE und TWO_WHEELER. RoutingPreference muss auf TRAFFIC_AWARE_OPTIMAL festgelegt sein. Länder müssen als Unicode-CLDR-Regionscodes angegeben werden. Unterstützte Länder sind CH, AT, CZ, HU, SI, SK. Dieses Feld wird in ComputeRouteMatrix nicht unterstützt.

hov_preference

HOVPreference

Gibt an, ob die Route auf Grundlage von für Fahrgemeinschaften zulässigen Straßen geändert werden soll. Dieses Feld wird in ComputeRouteMatrix nicht unterstützt.

HOVPreference

Gibt an, ob die Route auf Grundlage von Fahrgemeinschaftsstraßen oder -spuren geändert werden soll.

Felder
allow_hov

bool

Gibt an, ob zusätzlich zu Straßenabschnitten mit gemeinsam genutzten Fahrgemeinschaftsspuren die Routenplanung für Fahrgemeinschaftsspuren zulässig ist. Standardmäßig werden Routen ohne Fahrgemeinschaftsstraßen bevorzugt. RoutingPreference muss auf TRAFFIC_AWARE_OPTIMAL festgelegt sein.

RouteTokenOptions

Optionen für Route Tokens.

Felder
route_token

string

Optional. Wenn festgelegt, wird nach Möglichkeit eine Route generiert, die der mit dem Token verknüpften Route "ähnlich" ist. Sie müssen weiterhin die ursprünglichen Suchparameter (z. B. Ursprung und Ziel) angeben.

route_token_behavior

RouteTokenBehavior

Optional. Hinweis zur Behandlung von route_token.

RouteTokenBehavior

Die unterstützten Modi für Routentokens.

Enums
ROUTE_TOKEN_BEHAVIOR_UNSPECIFIED Wird aus Kompatibilitätsgründen als GET_ROUTE_UPDATES behandelt.
GET_ROUTE_UPDATES Wenn sich |origin| auf der durch route_token dargestellten Route befindet, wird eine der resultierenden Routen durch route_token dargestellt. Die übrigen Routen haben nichts miteinander zu tun. Aktualisierungen sind am effizientesten, wenn sich |origin| dem Anfang von route_token nähert, d. h., der Nutzer hat sich nicht weit von der Stelle bewegt, an der route_token generiert wurde.
GET_SIMILAR_ROUTES Die durch route_token dargestellte Route ist nicht in der Antwort enthalten, aber die anderen Routen enthalten die Ähnlichkeit mit route_token als Gewichtungsfaktor in ihrem Ranking.

RouteTravelAdvisory

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

Felder
toll_info

TollInfo

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

vignette_info

VignetteInfo

Kapselt Datenfelder für Vignetten. Dieses Feld wird nur unter den folgenden Bedingungen ausgefüllt:

  • In der Anfrage selbst muss der Routenmodifikator avoid_vignettes angegeben werden.
  • Auf der resultierenden Route kann die Vignettierung nicht vermieden werden.

In diesem Fall enthält das Feld Details zur Vignette, z. B. das Land, in dem sich die unvermeidbare Vignette befindet.

speed_reading_intervals[]

SpeedReadingInterval

Intervalle für Geschwindigkeitslesevorgänge, in denen die Verkehrsdichte detailliert angegeben wird. 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 voraussichtliche Kraftstoffverbrauch in Mikrolitern.

route_restrictions_partially_ignored

bool

Für die zurückgegebene Route bestehen möglicherweise Einschränkungen, die für die angefragten Mobilitätsformen oder Routenmodifikatoren nicht geeignet sind.

transit_fare

Money

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

VignetteInfo

Kapselt Informationen zu Vignetten entlang einer Route

Felder
country_vignettes_used[]

string

Die Länder, in denen Vignetten verwendet werden. Länder werden als Unicode-CLDR-Regionscodes angegeben. Unterstützte Länder sind CH, AT, CZ, HU, SI und SK.

RouteTravelMode

Eine Reihe von Werten zur Angabe der Mobilitätsform. HINWEIS: WALK-, BICYCLE- und TWO_WHEELER-Routen befinden sich in der Betaphase. Bei diesen Routen fehlen gelegentlich deutlich erkennbare Bürgersteige, Fußgängerwege oder Fahrradwege. Diese Warnung muss dem Nutzer für alle Fußgänger-, Fahrrad- und Motorradrouten angezeigt werden, die Sie in Ihrer App anzeigen.

Enums
TRAVEL_MODE_UNSPECIFIED Keine Mobilitätsform angegeben. Die Standardeinstellung ist DRIVE.
DRIVE Reise mit Pkw
BICYCLE Fahrradfahren
WALK Zu Fuß unterwegs
TWO_WHEELER Zweirädrige Kraftfahrzeuge Beispiel: „motorrad“. Dies unterscheidet sich von der Mobilitätsform BICYCLE, die die Mobilitätsform mit menschlicher Antriebskraft abdeckt.
TRANSIT Fahrten mit öffentlichen Verkehrsmitteln, sofern verfügbar.

RoutingPreference

Eine Reihe von Werten, die Faktoren angeben, 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 zutreffend ist. Die Verwendung dieses Werts erzeugt die niedrigste Latenz. Hinweis: Für RouteTravelMode DRIVE und TWO_WHEELER basieren die ausgewählte Route und Reisezeit auf dem Straßennetz und der durchschnittlichen zeitunabhängigen Verkehrslage, nicht auf der aktuellen Verkehrslage. 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 der dezentralen Art des Dienstes variieren. 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 erheblich zu reduzieren.
TRAFFIC_AWARE_OPTIMAL Berechnet die Routen unter Berücksichtigung der aktuellen Verkehrslage, ohne die meisten Leistungsoptimierungen anzuwenden. Die Verwendung dieses Werts erzeugt die höchste Latenz.

Segment

Segment, das zu einem Pfad gehört

Felder
polyline

Polyline

Erforderlich. Die Polylinie des Segments. Sie kann verwendet werden, um das Segment zu identifizieren, wenn die ID nicht gefunden werden kann, und um zwischen zwei Segmenten zu unterscheiden, wenn sie dieselbe ID haben. Die Polylinie wird mit dem Standardformat für codierte Polylinien der Google Maps Platform codiert.

Union-Feld id. Wird zum Identifizieren dieses Segments innerhalb eines ID-Bereichs verwendet. Erforderlich. Für id ist nur einer der folgenden Werte zulässig:
place_id

string

Orts-ID für diesen Straßenabschnitt Wird in allen APIs verwendet.

SegmentSpan

Wird zur Trennung eines Unterabschnitts eines Segments verwendet. Wenn eine Spanne das gesamte Segment abdeckt, wäre „start_meters“ 0 und „end_meters“ die Segmentlänge.

Felder
start_meters

int32

Der Beginn der Spanne ist vom Startpunkt der Polylinie des Segments aus.

end_meters

int32

Das Ende der Spanne befindet sich dabei vom Startpunkt der Polylinie des Segments.

SegmentSpanAttribute

Ein SegmentSpanAttribute enthält die von der API zurückgegebenen Annotationen.

Felder
segment_span

SegmentSpan

Beschreibt, wo im Segment die Anmerkungen gelten.

level_of_service

LevelOfService

Die voraussichtliche Verkehrslage für die Spanne des Segments. Sie ergibt sich aus der voraussichtlichen Verkehrsgeschwindigkeit für diesen Abschnitt, wenn das Fahrzeug am Anfang des Abschnitts ankommt.

SpeedReadingInterval

Anzeige der Verkehrsdichte auf einem zusammenhängenden Segment einer Polylinie oder eines Pfades Bei einem Pfad mit den Punkten P_0, P_1, ... , P_N (nullbasierter Index) definiert der SpeedReadingInterval ein Intervall und beschreibt seinen Traffic mithilfe der folgenden Kategorien.

Felder
start_polyline_point_index

int32

Startindex dieses Intervalls in der Polylinie.

end_polyline_point_index

int32

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

Klassifizierung der Geschwindigkeit auf Polylinien basierend auf Verkehrsdaten.

Enums
SPEED_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
NORMAL Normale Geschwindigkeit, kein Verlangsamen wird erkannt.
SLOW Stau festgestellt, aber es wurde kein Stau gebildet.
TRAFFIC_JAM Stau erkannt.

TollInfo

Umfasst Mautinformationen auf einer Route oder einer 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, der voraussichtlich von den Mautstationen berechnet wird. Normalerweise enthält diese Liste nur ein Element für Routen mit Mautgebühren in einer Währung. Bei Auslandsreisen kann diese Liste mehrere Einträge enthalten, um Mautgebühren in unterschiedlichen Währungen widerzuspiegeln.

TollPass

Liste der weltweit unterstützten Mautpässe.

Enums
TOLL_PASS_UNSPECIFIED Nicht verwendet. Bei Verwendung dieses Werts 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 Australienweiter Mautpass. 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 Brasilianische Mautpass. Weitere Informationen finden Sie unter https://www.autoexpreso.com.
BR_CONECTCAR Brasilianische Mautpass. Weitere Informationen finden Sie unter https://conectcar.com.
BR_MOVE_MAIS Brasilianische Mautpass. Weitere Informationen finden Sie unter https://movemais.com.
BR_PASSA_RAPIDO Brasilianische Mautpass. Weitere Informationen finden Sie unter https://pasorapido.gob.do/.
BR_SEM_PARAR Brasilianische Mautpass. Weitere Informationen finden Sie unter https://www.semparar.com.br.
BR_TAGGY Brasilianische Mautpass. Weitere Informationen finden Sie unter https://taggy.com.br.
BR_VELOE Brasilianische 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 von Ontario, Kanada nach Michigan, USA.
CA_US_CONNEXION Grenzübergang von Ontario, Kanada nach Michigan, USA.
CA_US_NEXUS_CARD Grenzübergang zwischen Kanada und den USA.
ID_E_TOLL Indonesien. Von mehreren Banken für die Bezahlung von Mautstraßen verwendete elektronische Karte Alle E-Karten über Banken werden gleich belastet, 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 das HP-Kennzeichen.
JP_ETC Japan usw. Ein elektronisches Drahtlossystem zur Erfassung von Mautstraßen. https://www.go-etc.jp/
JP_ETC2 Japan ETC2.0. Neue Version des 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 Mexikanischer Mautpass. 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 Mexikos Mautpass-Unternehmen. Eine von vielen Unternehmen, die in Mexiko-Stadt tätig sind. Weitere Informationen finden Sie unter https://www.televia.com.mx.
MX_TELEVIA Mexikos Mautpass-Unternehmen. Eine von vielen Unternehmen, die in Mexiko-Stadt tätig sind. https://www.televia.com.mx
MX_VIAPASS Mexikanischer Mautpass. 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 Zeigt an, dass der Fahrer zusätzlich zum von der DMV ausgestellten CAV-Sticker (Clean Air Vehicle) eine FasTrak-Fahrkarte 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 Illinois, USA.
US_IL_IPASS Illinois, USA.
US_IN_EZPASSIN Indien, USA.
US_KS_BESTPASS_HORIZON Südkorea, USA.
US_KS_KTAG Südkorea, USA.
US_KS_NATIONALPASS Südkorea, USA.
US_KS_PREPASS_ELITEPASS Südkorea, USA.
US_LA_GEAUXPASS L.A., USA.
US_LA_TOLL_TAG L.A., 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 Oh, USA.
US_PA_EZPASSPA PA, USA.
US_RI_EZPASSRI R, USA.
US_SC_PALPASS South Carolina, 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 UT, 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 und die voraussichtliche Reisezeit basierend auf bisherigen Durchschnittswerten enthält.

Enums
TRAFFIC_MODEL_UNSPECIFIED nicht in Verwendung. 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 sein sollte als die tatsächliche Reisezeit. 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 sein sollte als die tatsächliche Reisezeit. 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 länderspezifische formatierte Telefonnummer des Verkehrsverbunds.

uri

string

URI des Verkehrsverbunds.

TransitLine

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

Felder
agencies[]

TransitAgency

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

name

string

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

uri

string

URI für diese ÖPNV-Linie, wie vom Betreiber angegeben.

color

string

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

icon_uri

string

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

name_short

string

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

text_color

string

Die Farbe, die üblicherweise im Text der Beschilderung dieser Linie verwendet wird. Wird in Hexadezimalzahlen dargestellt.

vehicle

TransitVehicle

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

TransitPreferences

Einstellungen für TRANSIT-basierte Routen, die die zurückgegebene Route beeinflussen.

Felder
allowed_travel_modes[]

TransitTravelMode

Eine Reihe von Mobilitätsformen, die beim Abrufen einer TRANSIT-Route verwendet werden. Die Standardeinstellung ist alle unterstützten Mobilitätsformen.

routing_preference

TransitRoutingPreference

Eine Routingeinstellung, die, sofern angegeben, die zurückgegebene TRANSIT-Route 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 die berechnete Route möglichst wenige Umstiege beinhalten soll.

TransitTravelMode

Eine Reihe von Werten zur Angabe der Mobilitätsform.

Enums
TRANSIT_TRAVEL_MODE_UNSPECIFIED Keine Mobilitätsform angegeben.
BUS Fahren Sie mit dem Bus.
SUBWAY Fahren Sie mit der U-Bahn.
TRAIN Zugreisen.
LIGHT_RAIL Nutzen Sie die Stadtbahn oder die Straßenbahn.
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 für 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

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

TransitVehicleType

Der Fahrzeugtyp für Routen mit öffentlichen Verkehrsmitteln.

Enums
TRANSIT_VEHICLE_TYPE_UNSPECIFIED nicht in Verwendung.
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

Ein Satz von Werten, die die in der Anzeige verwendete Maßeinheit angeben.

Enums
UNITS_UNSPECIFIED Keine Maßeinheiten angegeben. Die Standardeinstellung ist die Maßeinheit, die aus der Anfrage abgeleitet wird.
METRIC Metrische Maßeinheiten.
IMPERIAL Angloamerikanische Maßeinheiten.

VehicleEmissionType

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

Enums
VEHICLE_EMISSION_TYPE_UNSPECIFIED Kein Emissionstyp angegeben. Standardeinstellung ist GASOLINE.
GASOLINE Fahrzeug mit Benzin oder Benzin.
ELECTRIC Elektrisch betriebenes Fahrzeug
HYBRID Ein Fahrzeug mit Hybridantrieb (z. B. Benzin und Elektro)
DIESEL Fahrzeug mit Diesel

VehicleInfo

Enthält die Fahrzeuginformationen, z. B. die Art der Fahrzeugemission.

Felder
emission_type

VehicleEmissionType

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

total_axle_count

int32

Gesamtzahl der Achsen. Muss >= 2 sein, wenn festgelegt. Muss festgelegt sein, damit das Transportunternehmen ausgelöst wird, ist für Anhänger jedoch optional. Dieses Feld wird in ComputeRouteMatrix nicht unterstützt, wenn RouteTravelMode den Wert DRIVE hat.

total_height_mm

int64

Höhe des Fahrzeugs, einschließlich der Höhe der angehängten Anhänger. Muss festgelegt werden, damit Lkw- oder Anhängerfahrzeuge ausgelöst werden. Dieses Feld wird in ComputeRouteMatrix nicht unterstützt, wenn RouteTravelMode den Wert DRIVE hat.

total_length_mm

int64

Länge des Fahrzeugs, einschließlich der Länge der Anhänger Muss festgelegt werden, damit Lkw- oder Anhängerfahrzeuge ausgelöst werden. Dieses Feld wird in ComputeRouteMatrix nicht unterstützt, wenn RouteTravelMode den Wert DRIVE hat.

total_width_mm

int64

Breite des Fahrzeugs, einschließlich der Breite der angehängten Anhänger. Muss festgelegt werden, damit Lkw- oder Anhängerfahrzeuge ausgelöst werden. Dieses Feld wird in ComputeRouteMatrix nicht unterstützt, wenn RouteTravelMode den Wert DRIVE hat.

total_weight_kg

int64

Das Gewicht des Fahrzeugs, einschließlich der Gewichte aller angehängten Anhänger. In diesem Zusammenhang bezieht sich das Gewicht auf das tatsächliche Gewicht, nicht auf die Bewertung des Gewichts. Muss festgelegt werden, damit Lkw- oder Anhängerfahrzeuge ausgelöst werden. Dieses Feld wird in ComputeRouteMatrix nicht unterstützt, wenn RouteTravelMode den Wert DRIVE hat.

trailer_info[]

TrailerInfo

Enthält einen Eintrag für jeden Trailer. Wenn Informationen zum Anhänger angegeben werden, muss RoutingPreference auf TRAFFIC_AWARE_OPTIMAL gesetzt sein. Dieses Feld wird in ComputeRouteMatrix nicht unterstützt, wenn RouteTravelMode den Wert DRIVE hat.

TrailerInfo

Informationen zu einzelnen am Fahrzeug angebrachten Anhängern. Die Länge der Anhänger muss für Lkws angegeben werden. Andere Attribute sind optional. Das Attribut „Gesamtzahl“ muss die Attribute aller Trailer umfassen. Beispielsweise muss total_height_mm immer größer oder gleich trailer_info.height_mm sein.

Felder
height_mm

int64

Höhe des Anhängers.

length_mm

int64

Länge des Trailers.

width_mm

int64

Breite des Anhängers.

weight_kg

int64

Gewicht des Anhängers. In diesem Zusammenhang bezieht sich das Gewicht auf das tatsächliche Gewicht, nicht auf die Bewertung des Gewichts.

Zwischenstopp

Verkapselt einen Wegpunkt. Wegpunkte kennzeichnen den Anfang und das Ende einer Route und umfassen Zwischenstopps entlang der Route.

Felder
via

bool

Wegpunkt wird als Meilenstein und nicht als Zwischenstopp gekennzeichnet. Für jeden Nicht-via-Wegpunkt in der Anfrage wird in der Antwort ein Eintrag an das Array legs angehängt, um die Details für Aufenthalte an diesem Abschnitt der Fahrt bereitzustellen. Setzen Sie diesen Wert auf „true“, wenn die Route über diesen Wegpunkt verlaufen soll, ohne anzuhalten. Via-Wegpunkte bewirken nicht, dass dem legs-Array ein Eintrag hinzugefügt wird, sie leiten jedoch die Reise über den Wegpunkt weiter. Sie können diesen Wert nur für Wegpunkte festlegen, die Zwischenpunkte sind. Die Anfrage schlägt fehl, wenn Sie dieses Feld auf Terminal-Wegpunkten 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 Halten von Fahrzeugen vorgesehen ist, entweder als Ein- oder Ausstiegsziel sind. Wenn Sie diesen Wert festlegen, enthält die berechnete Route keine Wegpunkte, die nicht via sind, auf Straßen, die für die An- und Abreise nicht geeignet sind. Diese Option funktioniert nur für die Mobilitätsformen DRIVE und TWO_WHEELER und wenn für location_type der Wert Location festgelegt ist.

side_of_road

bool

Gibt an, dass das Fahrzeug an der Position dieses Wegpunkts bevorzugt an einer bestimmten Straßenseite halten soll. Wenn Sie diesen Wert festlegen, verläuft die Route so durch den Ort, dass das Fahrzeug an der Straßenseite anhalten kann, die zur Mitte der Straße hin geneigt 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 Ausrichtung.

place_id

string

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

address

string

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