Die Routes Preferred API ist derzeit nur für ausgewählte Kunden verfügbar. Weitere Informationen erhalten Sie vom Vertrieb.

Diese Seite wurde von der Cloud Translation API übersetzt.

Package google.maps.routes.v1

Index

RoutesPreferred (Benutzeroberfläche)
ComputeCustomRoutesRequest (Meldung)
ComputeCustomRoutesResponse (Meldung)
ComputeCustomRoutesResponse.FallbackInfo (Meldung)
ComputeCustomRoutesResponse.FallbackInfo.FallbackRouteObjective (Aufzählung)
ComputeRouteMatrixRequest (Meldung)
ComputeRoutesRequest (Meldung)
ComputeRoutesResponse (Meldung)
CustomRoute (Meldung)
FallbackInfo (Meldung)
FallbackReason (enum)
FallbackRoutingMode (enum)
Location (Meldung)
Maneuver (Aufzählung)
NavigationInstruction (Meldung)
Polyline (Meldung)
PolylineEncoding (enum)
PolylineQuality (enum)
Route (Meldung)
RouteLeg (Meldung)
RouteLegStep (Meldung)
RouteLegStepTravelAdvisory (Meldung)
RouteLegTravelAdvisory (Meldung)
RouteMatrixDestination (Meldung)
RouteMatrixElement (Meldung)
RouteMatrixElementCondition (Aufzählung)
RouteMatrixOrigin (Meldung)
RouteModifiers (Meldung)
RouteObjective (Meldung)
RouteObjective.RateCard (Meldung)
RouteObjective.RateCard.MonetaryCost (Meldung)
RouteTravelAdvisory (Meldung)
RouteTravelMode (enum)
RoutingPreference (enum)
SpeedReadingInterval (Meldung)
SpeedReadingInterval.Speed (Aufzählung)
TollInfo (Meldung)
TollPass (enum)
Units (enum)
VehicleEmissionType (enum)
VehicleInfo (Meldung)
Waypoint (Meldung)

RoutesPreferred

Die Routes Preferred API

ComputeCustomRoutes

ComputeCustomRoutes
`rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)` Mit einer Reihe von Terminal- und Zwischen-Wegpunkten und einem Routenziel wird die beste Route für das Routenziel berechnet. Gibt auch die schnellste und die kürzeste Route als Referenzrouten zurück. HINWEIS:Bei dieser Methode müssen Sie in der Eingabe eine Antwortfeldmaske angeben. Sie können die Antwortfeldmaske mit dem URL-Parameter `$fields` oder `fields` oder mit dem HTTP/gRPC-Header `X-Goog-FieldMask` angeben. 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 diesem Artikel. Beispiel: Feldmaske aller verfügbaren Felder (zur manuellen Überprüfung): `X-Goog-FieldMask: ` Feldmaske mit Entfernungen, Dauer, Tokens und Mautinformationen auf der Route: `X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo` Google rät von der Verwendung der Platzhalterantwortfeldmaske (``) ab oder der Angabe der Feldmaske auf oberster Ebene (`routes`), weil: 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 für Ihren 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. Autorisierungsbereiche Erfordert den folgenden OAuth-Bereich: `https://www.googleapis.com/auth/maps-platform.routespreferred` Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

Mit einer Reihe von Terminal- und Zwischen-Wegpunkten und einem Routenziel wird die beste Route für das Routenziel berechnet. Gibt auch die schnellste und die kürzeste Route als Referenzrouten zurück.

HINWEIS:Bei dieser Methode müssen Sie in der Eingabe eine Antwortfeldmaske angeben. Sie können die Antwortfeldmaske mit dem URL-Parameter $fields oder fields oder mit dem HTTP/gRPC-Header X-Goog-FieldMask angeben. 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 diesem Artikel.

Beispiel:

Feldmaske aller verfügbaren Felder (zur manuellen Überprüfung): X-Goog-FieldMask: *
Feldmaske mit Entfernungen, Dauer, Tokens und Mautinformationen auf der Route: X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

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

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 für Ihren 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.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

https://www.googleapis.com/auth/maps-platform.routespreferred

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

ComputeRouteMatrix

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 mit dem 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 in diesem Artikel. 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 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 Platzhalterantwortfeldmaske (``) 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 für Ihren 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. Autorisierungsbereiche Erfordert den folgenden OAuth-Bereich: `https://www.googleapis.com/auth/maps-platform.routespreferred` Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

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.

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 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 Platzhalterantwortfeldmaske (*) 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 für Ihren 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.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

https://www.googleapis.com/auth/maps-platform.routespreferred

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

ComputeRoutes

ComputeRoutes
`rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)` Gibt die primäre Route zusammen mit optionalen alternativen Routen für einen Satz von Terminal- und Zwischen-Wegpunkten 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 mithilfe eines 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. Weitere Informationen finden Sie in der Dokumentation zum Erstellen der Feldpfade. 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 Produktionseinrichtung): `X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline` Google rät davon ab, die Platzhalterantwortfeldmaske (``) zu verwenden oder die Feldmaske auf oberster Ebene (`routes`) anzugeben, weil: 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 für Ihren 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. Autorisierungsbereiche Erfordert den folgenden OAuth-Bereich: `https://www.googleapis.com/auth/maps-platform.routespreferred` Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Gibt die primäre Route zusammen mit optionalen alternativen Routen für einen Satz von Terminal- und Zwischen-Wegpunkten 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 mithilfe eines 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. Weitere Informationen finden Sie in der Dokumentation zum Erstellen der Feldpfade.

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 Produktionseinrichtung): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google rät davon ab, die Platzhalterantwortfeldmaske (*) zu verwenden oder die Feldmaske auf oberster Ebene (routes) anzugeben, weil:

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 für Ihren 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.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

https://www.googleapis.com/auth/maps-platform.routespreferred

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

ComputeCustomRoutesRequest

ComputeCustomRoutes-Anfragenachricht.

Felder
`origin`	`Waypoint` Erforderlich. Wegpunkt des Ursprungsortes
`destination`	`Waypoint` Erforderlich. Wegpunkt des Ziels.
`intermediates[]`	`Waypoint` Optional. Gruppe von Wegpunkten entlang der Route (ohne Endpunktpunkte), um an einem Ort zu bleiben oder vorbeizufahren. Es werden bis zu 25 Wegpunkte unterstützt.
`travel_mode`	`RouteTravelMode` Optional. Gibt die Mobilitätsform an. Derzeit wird nur DRIVE unterstützt.
`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 einer extrem langen Latenz führt, wird ein Fehler zurückgegeben. In Zukunft werden wir möglicherweise einen Fallback-Mechanismus implementieren, um eine andere Option zu verwenden, wenn die bevorzugte Option kein gültiges Ergebnis liefert. 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. Wenn Sie diesen Wert auf eine bereits vergangene Zeit festlegen, schlägt die Anfrage fehl.
`route_modifiers`	`RouteModifiers` Optional. Eine Reihe von Bedingungen, die erfüllt sein müssen und die die Art und Weise beeinflussen, wie Routen berechnet werden.
`route_objective`	`RouteObjective` Erforderlich. Ein Routenziel für die Optimierung.
`language_code`	`string` Optional. Der BCP-47-Sprachcode, z. B. „en-US“ oder „sr-Latn“. Weitere Informationen finden Sie unter http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. 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.
`units`	`Units` Optional. Gibt die Maßeinheiten für die Anzeigefelder an. Dazu gehört auch das Feld `instruction` in `NavigationInstruction`. Die für die Route, Streckenabschnitt, Schrittstrecke und Dauer verwendeten Maßeinheiten werden von diesem Wert nicht beeinflusst. Wenn Sie diesen Wert nicht angeben, werden die Anzeigeeinheiten vom Standort der Anfrage abgeleitet.

ComputeCustomRoutesResponse

ComputeCustomRoutes-Antwortnachricht.

Felder
`routes[]`	`CustomRoute` Die „besten“ Routen für das Eingaberoutenziel.
`fastest_route`	`CustomRoute` Die schnellste Referenzroute.
`shortest_route`	`CustomRoute` Die kürzeste Referenzroute.
`fallback_info`	`FallbackInfo` Fallback-Informationen für benutzerdefinierte Routen.

FallbackInfo

Kapselt Fallback-Informationen für ComputeCustomRoutes. ComputeCustomRoutes führt zwei Arten von Fallbacks aus:

Wenn es die Route nicht mit der vom Kunden angeforderten „routing_preference“ berechnen kann, wird ein Fallback auf einen anderen Routingmodus ausgeführt. In diesem Fall werden „fallback_routing_mode“ und „routing_mode_fallback_reason“ verwendet, um den verwendeten Fallback-Routingmodus und den Grund für das Fallback anzugeben.
Wenn für das vom Kunden angegebene Routenziel keine „beste“ Route berechnet werden kann, kann ein Fallback auf ein anderes Ziel ausgeführt werden. „fallback_route_objective“ wird verwendet, um das Fallback-Routenziel zu kommunizieren.

Felder

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.
`routing_mode_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.
`route_objective`	`FallbackRouteObjective` Das für die Antwort verwendete Routenziel. Wenn das Fallback ausgelöst wurde, kann das Ziel vom Routingziel abweichen, das in der ursprünglichen Clientanfrage angegeben wurde.

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.

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

route_objective

FallbackRouteObjective

Das für die Antwort verwendete Routenziel. Wenn das Fallback ausgelöst wurde, kann das Ziel vom Routingziel abweichen, das in der ursprünglichen Clientanfrage angegeben wurde.

FallbackRouteObjective

Für die Antwort verwendete RouteObjective.

Enums
`FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED`	Ziel der Fallback-Route nicht angegeben.
`FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA`	Wenn ein Kunde RateCard anfordert und include_tolls auf „true“ setzt und Google keine Daten zu den Mautgebühren für die Route hat, greift die API auf RateCard zurück, ohne die Mautgebühr zu berücksichtigen.

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 Anzahl der Elemente (Startorte × Ziele) darf in jedem Fall 625 nicht überschreiten. Die Anzahl der Elemente (Startorte × Ziele) darf nicht größer als 100 sein, wenn „routing_preference“ auf `TRAFFIC_AWARE_OPTIMAL` festgelegt ist. Die Anzahl der als `place_id` angegebenen Wegpunkte (Startorte + Ziele) darf 50 nicht überschreiten.
`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 einer extrem langen Latenz führt, wird ein Fehler zurückgegeben. In Zukunft werden wir möglicherweise einen Fallback-Mechanismus implementieren, um eine andere Option zu verwenden, wenn die bevorzugte Option kein gültiges Ergebnis liefert. 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. Wenn Sie diesen Wert auf einen bereits aufgetretenen Zeitpunkt festlegen, schlägt die Anfrage fehl.

ComputeRoutesRequest

ComputeRoutes-Anfragenachricht.

Felder
`origin`	`Waypoint` Erforderlich. Wegpunkt des Ursprungsortes
`destination`	`Waypoint` Erforderlich. Wegpunkt des Ziels.
`intermediates[]`	`Waypoint` Optional. Gruppe von Wegpunkten entlang der Route (ohne Endpunktpunkte), um an einem Ort zu bleiben oder vorbeizufahren. 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 einer extrem langen Latenz führt, wird ein Fehler zurückgegeben. In Zukunft werden wir möglicherweise einen Fallback-Mechanismus implementieren, um eine andere Option zu verwenden, wenn die bevorzugte Option kein gültiges Ergebnis liefert. 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. Wenn Sie diesen Wert auf eine bereits vergangene Zeit festlegen, schlägt die Anfrage fehl.
`compute_alternative_routes`	`bool` Gibt an, ob zusätzlich zur Route alternative Routen berechnet werden sollen.
`route_modifiers`	`RouteModifiers` Optional. Eine Reihe von Bedingungen, die erfüllt sein müssen und die die Art und Weise beeinflussen, wie Routen berechnet werden.
`language_code`	`string` Optional. Der BCP-47-Sprachcode, z. B. „en-US“ oder „sr-Latn“. Weitere Informationen finden Sie unter http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. 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.
`units`	`Units` Optional. Gibt die Maßeinheiten für die Anzeigefelder an. Dazu gehört auch das Feld `instruction` in `NavigationInstruction`. Die für die Route, Streckenabschnitt, Schrittstrecke und Dauer verwendeten Maßeinheiten werden von diesem Wert nicht beeinflusst. Wenn Sie diesen Wert nicht angeben, werden die Anzeigeeinheiten vom Standort der Anfrage abgeleitet.
`optimize_waypoint_order`	`bool` Ist „optimizeWaypointOrder“ auf „true“ gesetzt, wird versucht, die angegebenen Wegpunkte neu anzuordnen, um die Gesamtkosten der Route zu minimieren. Wenn einer der Wegpunkte über einen Wegpunkt liegt, schlägt die Anfrage fehl. Verwenden Sie ComputeRoutesResponse.Routes.Optimized_intermediate_waypoint_index, um die neue Reihenfolge zu finden. Wenn „routes.Optimized_intermediate_waypoint_index“ nicht im Header `X-Goog-FieldMask` angefordert wird, schlägt die Anfrage fehl. Wenn optimWaypointOrder auf "false" gesetzt ist, ist ComputeRoutesResponse.Optimized_intermediate_waypoint_index leer.

ComputeRoutesResponse

ComputeRoute leitet die Antwortnachricht weiter.

Felder

Felder
`routes[]`	`Route` Enthält ein Array von berechneten Routen (bis zu drei), wenn Sie „compute_alternatives_routes“ angeben, und enthält nur eine Route, wenn dies nicht der Fall ist. 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 wurde.
`fallback_info`	`FallbackInfo` Wenn der Server nicht in der Lage ist, die Routenergebnisse mit allen Eingabeeinstellungen zu berechnen, kann er auf eine andere Berechnungsmethode zurückgreifen. Wenn der Fallback-Modus verwendet wird, enthält dieses Feld detaillierte Informationen zur Fallback-Antwort. Andernfalls ist dieses Feld nicht festgelegt.

routes[]

Route

Enthält ein Array von berechneten Routen (bis zu drei), wenn Sie „compute_alternatives_routes“ angeben, und enthält nur eine Route, wenn dies nicht der Fall ist. 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 wurde.

fallback_info

FallbackInfo

Wenn der Server nicht in der Lage ist, die Routenergebnisse mit allen Eingabeeinstellungen zu berechnen, kann er auf eine andere Berechnungsmethode zurückgreifen. Wenn der Fallback-Modus verwendet wird, enthält dieses Feld detaillierte Informationen zur Fallback-Antwort. Andernfalls ist dieses Feld nicht festgelegt.

CustomRoute

Kapselt eine benutzerdefinierte Route ein, die anhand des vom Kunden angegebenen Routenziels berechnet wird. CustomRoute enthält eine Route und ein Routentoken, die an das NavSDK übergeben werden können, um die benutzerdefinierte Route für die detaillierte Routenführung zu rekonstruieren.

Felder

Felder
`route`	`Route` Die Route, die für das Eingaberoutenziel als „am besten“ eingestuft wird.
`token`	`string` Websicheres, mit Base64 codiertes Routentoken, das an das NavSDK übergeben werden kann. Damit kann das NavSDK die Route während der Navigation rekonstruieren. Bei einer Neuberechnung der Route wird die ursprüngliche Absicht berücksichtigt, wenn „RoutesPreferred ComputeCustomRoutes“ aufgerufen wird. Kunden sollten dieses Token als intransparenten Blob behandeln.

route

Route

Die Route, die für das Eingaberoutenziel als „am besten“ eingestuft wird.

token

string

Websicheres, mit Base64 codiertes Routentoken, das an das NavSDK übergeben werden kann. Damit kann das NavSDK die Route während der Navigation rekonstruieren. Bei einer Neuberechnung der Route wird die ursprüngliche Absicht berücksichtigt, wenn „RoutesPreferred ComputeCustomRoutes“ aufgerufen wird. Kunden sollten dieses Token als intransparenten Blob behandeln.

FallbackInfo

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

Felder

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.

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

FallbackReason

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

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

FallbackRoutingMode

Tatsächlich verwendeter Routingmodus für die zurückgegebene Fallback-Antwort.

Enums
`FALLBACK_ROUTING_MODE_UNSPECIFIED`	Nicht verwendet.
`FALLBACK_TRAFFIC_UNAWARE`	Gibt an, dass der Routingmodus „TRAFFIC_UNAWARE“ zum Berechnen der Antwort verwendet wurde.
`FALLBACK_TRAFFIC_AWARE`	Gibt an, dass der Routingmodus „TRAFFIC_AWARE“ zum Berechnen der Antwort verwendet wurde.

Standort

Schließt einen Standort ein (ein geografischer Punkt und eine optionale Richtung).

Felder

Felder
`lat_lng`	`LatLng` Die geografischen Koordinaten des Wegpunkts.
`heading`	`Int32Value` Die Kompassrichtung, die der Verkehrsrichtung entspricht. Mit diesem Wert wird die Straßenseite angegeben, die als Start- und Zielpunkt verwendet werden soll. Die Richtungswerte können zwischen 0 und 360 liegen, wobei 0 die Richtung Norden angibt, 90 eine Richtung nach Osten usw. Sie können dieses Feld nur für die Mobilitätsformen `DRIVE` und `TWO_WHEELER` verwenden.

lat_lng

LatLng

Die geografischen Koordinaten des Wegpunkts.

heading

Int32Value

Die Kompassrichtung, die der Verkehrsrichtung entspricht. Mit diesem Wert wird die Straßenseite angegeben, die als Start- und Zielpunkt verwendet werden soll. Die Richtungswerte können zwischen 0 und 360 liegen, wobei 0 die Richtung Norden angibt, 90 eine Richtung nach Osten usw. Sie können dieses Feld nur für die Mobilitätsformen DRIVE und TWO_WHEELER verwenden.

Manöver

Eine Reihe von Werten, die die Navigationsaktion für den aktuellen Schritt angeben (z.B. links abbiegen, verbinden, geradeaus usw.).

Enums
`MANEUVER_UNSPECIFIED`	Nicht verwendet.
`TURN_SLIGHT_LEFT`	Biegen Sie leicht nach links ab.
`TURN_SHARP_LEFT`	Biegen Sie scharf nach links ab.
`UTURN_LEFT`	Nach links wenden.
`TURN_LEFT`	Biegen Sie nach links ab.
`TURN_SLIGHT_RIGHT`	Biegen Sie leicht nach rechts ab.
`TURN_SHARP_RIGHT`	Biegen Sie scharf nach rechts ab.
`UTURN_RIGHT`	Nach rechts wenden.
`TURN_RIGHT`	Biegen Sie nach rechts ab.
`STRAIGHT`	Geradeaus.
`RAMP_LEFT`	Nimm die linke Auffahrt.
`RAMP_RIGHT`	Nimm die rechte Auffahrt.
`MERGE`	Mehr Zugriffe erzielen
`FORK_LEFT`	Nimm die linke Gabel.
`FORK_RIGHT`	Nehmen Sie die rechte Gabel.
`FERRY`	Nimm die Fähre.
`FERRY_TRAIN`	Nehmen Sie den Zug, der auf die Fähre führt.
`ROUNDABOUT_LEFT`	Beim Kreisverkehr links abbiegen.
`ROUNDABOUT_RIGHT`	Im Kreisverkehr rechts abbiegen.

NavigationInstruction

Felder

maneuver

Maneuver

Fasst die Navigationsanweisungen für den aktuellen Schritt zusammen, z. B. „Nach links abbiegen“, „Zusammenführung“ oder „Gerade“. Dieses Feld bestimmt, welches Symbol angezeigt werden soll.

instructions

string

Anleitung zum Navigieren in diesem Schritt.

Polyline

Kapselt eine codierte Polylinie ein.

Felder

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 mit dem Algorithmus für codierte Polylinien.
`geo_json_linestring`	`Struct` Gibt eine Polylinie im GeoJSON-LineString-Format an

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 mit dem Algorithmus für codierte Polylinien.

geo_json_linestring

Struct

Gibt eine Polylinie im GeoJSON-LineString-Format an

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 die Qualität von Polylinien 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 eine höhere Genauigkeit benötigen.
`OVERVIEW`	Gibt eine Übersichtspolygone an, die aus einer kleinen Anzahl von Punkten besteht. Verwenden Sie diesen Wert, wenn eine Übersicht der Route angezeigt wird. Diese Option hat eine geringere Anfragelatenz als die Option `HIGH_QUALITY`.

Route

Es handelt sich um eine Route, die aus einer Reihe verbundener Straßensegmente besteht, die Start-, End- und Zwischenwegpunkte miteinander verbinden.

Felder
`legs[]`	`RouteLeg` Eine Gruppe von Streckenabschnitten (Pfadsegmenten zwischen Wegpunkten), die die Route bilden. Jeder Abschnitt entspricht der Fahrt zwischen zwei Nicht-`via`-Wegpunkten. Eine Route ohne Wegpunkte hat beispielsweise nur einen Streckenabschnitt. Eine Route mit einem Nicht-`via`-Wegpunkt hat zwei Streckenabschnitte. Eine Route mit einem `via`-Wegpunkt hat einen Streckenabschnitt. Die Reihenfolge der Streckenabschnitte entspricht der Reihenfolge der Wegpunkte von `origin` über `intermediates` bis `destination`.
`distance_meters`	`int32` Die Strecke 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 dieser Wert unter Berücksichtigung der Verkehrslage berechnet.
`static_duration`	`Duration` Die Reisedauer auf der Route ohne Berücksichtigung der Verkehrslage.
`polyline`	`Polyline` Polylinie der gesamten Route Diese Polylinie wird dann aus allen `legs` kombiniert.
`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 ComputeRoutesRequest.optimize_waypoint_order auf „true“ gesetzt ist, enthält dieses Feld die optimierte Reihenfolge von Wegpunkten. Andernfalls ist dieses Feld leer. Angenommen, die Eingabe lautet "Origin: LA", "Fortgeschritten: Dallas, Bangor, Phoenix", "Destination: New York" und die optimierte dazwischenliegende Wegpunktreihenfolge lautet: Phoenix, Dallas, Bangor. Dieses Feld enthält dann die Werte [2, 0, 1]. Der Index beginnt für den ersten Zwischenwegpunkt mit „0“.

RouteLeg

Kapselt ein Segment zwischen Nicht-via-Wegpunkten.

Felder
`distance_meters`	`int32` Die Strecke des Streckenabschnitts in Metern.
`duration`	`Duration` Die Zeit, die zum Navigieren durch das Bein benötigt wird. Wenn `route_preference` auf `TRAFFIC_UNAWARE` gesetzt ist, ist dieser Wert mit `static_duration` identisch. Wenn `route_preference` entweder `TRAFFIC_AWARE` oder `TRAFFIC_AWARE_OPTIMAL` ist, 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. Dazu gehört auch die Polylinie der einzelnen `step`.
`start_location`	`Location` Die Startposition dieses Streckenabschnitts. Diese kann vom angegebenen `origin` abweichen. Wenn sich der 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 Streckenabschnitts. Diese kann vom angegebenen `destination` abweichen. Wenn sich der angegebene `destination` beispielsweise nicht in der Nähe einer Straße befindet, ist dies ein Punkt auf der Straße.
`steps[]`	`RouteLegStep` Ein Array mit Schritten, die Segmente in diesem Abschnitt angeben. Jeder Schritt steht für eine Navigationsanweisung.
`travel_advisory`	`RouteLegTravelAdvisory` Enthält die zusätzlichen Informationen, über die der Nutzer informiert werden sollte, z. B. eine mögliche Einschränkung der Verkehrslage usw. auf einem Routenabschnitt.

RouteLegStep

Kapselt ein Segment einer RouteLeg ein. Ein Schritt entspricht einer einzelnen Navigationsanweisung. Routenabschnitte bestehen aus Schritten.

Felder
`distance_meters`	`int32` Die Strecke dieses Schritts in Metern. Unter Umständen enthält dieses Feld keinen Wert.
`static_duration`	`Duration` Die Reisedauer für diesen Schritt, ohne die Verkehrslage zu berücksichtigen. Unter Umständen enthält dieses Feld keinen Wert.
`polyline`	`Polyline` Die mit diesem Schritt verknüpfte Polylinie.
`start_location`	`Location` Der Startort 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 informiert werden sollte, z. B. mögliche Einschränkungen durch eine Verkehrszone bei einem Streckenabschnitt.

RouteLegStepTravelAdvisory

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

Felder

Felder
`speed_reading_intervals[]`	`SpeedReadingInterval` Intervalle für Geschwindigkeitsmessungen, die Angaben zur Verkehrsdichte machen. Gilt bei Routeneinstellungen für `TRAFFIC_AWARE` und `TRAFFIC_AWARE_OPTIMAL`. Die Intervalle decken die gesamte Polylinie des RouteLegStep ohne Überschneidung ab. Der Startpunkt eines angegebenen Intervalls ist mit dem Endpunkt des vorherigen Intervalls identisch. Beispiel: `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

speed_reading_intervals[]

SpeedReadingInterval

Intervalle für Geschwindigkeitsmessungen, die Angaben zur Verkehrsdichte machen. Gilt bei Routeneinstellungen für TRAFFIC_AWARE und TRAFFIC_AWARE_OPTIMAL. Die Intervalle decken die gesamte Polylinie des RouteLegStep ohne Überschneidung ab. Der Startpunkt eines angegebenen Intervalls ist mit dem Endpunkt des vorherigen Intervalls identisch.

Beispiel:

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

RouteLegTravelAdvisory

Enthält die zusätzlichen Informationen, über die der Nutzer informiert werden sollte, z. B. eine mögliche Einschränkung der Verkehrslage usw. auf einem Routenabschnitt.

Felder

Felder
`toll_info`	`TollInfo` Enthält Informationen zu Mautgebühren auf dem jeweiligen RouteLeg. Dieses Feld wird nur ausgefüllt, wenn auf dem RouteLeg Mautgebühren zu erwarten sind. Wenn dieses Feld festgelegt ist, das Unterfeld "estimated_price" jedoch nicht ausgefüllt ist, gehen wir davon aus, dass die Straße Mautstraßen enthält, uns jedoch kein geschätzter Preis bekannt ist. Wenn dieses Feld nicht vorhanden ist, fallen keine Mautgebühren für das RouteLeg an.
`speed_reading_intervals[]`	`SpeedReadingInterval` Intervalle für Geschwindigkeitsmessungen, die Angaben zur Verkehrsdichte machen. Gilt bei Routeneinstellungen für `TRAFFIC_AWARE` und `TRAFFIC_AWARE_OPTIMAL`. Die Intervalle decken die gesamte Polylinie der RouteLg ohne Überschneidung ab. Der Startpunkt eines angegebenen Intervalls ist mit dem Endpunkt des vorherigen Intervalls identisch. Beispiel: `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

toll_info

TollInfo

Enthält Informationen zu Mautgebühren auf dem jeweiligen RouteLeg. Dieses Feld wird nur ausgefüllt, wenn auf dem RouteLeg Mautgebühren zu erwarten sind. Wenn dieses Feld festgelegt ist, das Unterfeld "estimated_price" jedoch nicht ausgefüllt ist, gehen wir davon aus, dass die Straße Mautstraßen enthält, uns jedoch kein geschätzter Preis bekannt ist. Wenn dieses Feld nicht vorhanden ist, fallen keine Mautgebühren für das RouteLeg an.

speed_reading_intervals[]

SpeedReadingInterval

Intervalle für Geschwindigkeitsmessungen, die Angaben zur Verkehrsdichte machen. Gilt bei Routeneinstellungen für TRAFFIC_AWARE und TRAFFIC_AWARE_OPTIMAL. Die Intervalle decken die gesamte Polylinie der RouteLg ohne Überschneidung ab. Der Startpunkt eines angegebenen Intervalls ist mit dem Endpunkt des vorherigen Intervalls identisch.

Beispiel:

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

RouteMatrixDestination

Ein einzelnes Ziel für ComputeRouteMatrixRequest

Felder

Felder
`waypoint`	`Waypoint` Erforderlich. Wegpunkt des Ziels

waypoint

Waypoint

Erforderlich. Wegpunkt des Ziels

RouteMatrixElement

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

Felder
`origin_index`	`int32` Nullbasierter Index des Ursprungs in der Anfrage.
`destination_index`	`int32` Nullbasierter Index des Ziels in der Anfrage.
`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 Strecke 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 dieser Wert unter Berücksichtigung der Verkehrslage berechnet.
`static_duration`	`Duration` Die Reisedauer auf der Route ohne Berücksichtigung der Verkehrslage.
`travel_advisory`	`RouteTravelAdvisory` Zusätzliche Informationen zur Route. Beispiel: Informationen zu Einschränkungen und Mautgebühren
`fallback_info`	`FallbackInfo` Wenn der Server die Route mit den angegebenen Einstellungen für dieses spezielle Start-/Zielpaar nicht berechnen kann, wird unter Umständen ein anderer Berechnungsmodus verwendet. Wenn der Fallback-Modus verwendet wird, enthält dieses Feld detaillierte Informationen zur Fallback-Antwort. Andernfalls ist dieses Feld nicht festgelegt.

RouteMatrixElementCondition

Die Bedingung der Route, die zurückgegeben wird.

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

Felder
`waypoint`	`Waypoint` Erforderlich. Start-Wegpunkt
`route_modifiers`	`RouteModifiers` Optional. Modifikatoren für jede Route, die dies als Startpunkt verwendet

waypoint

Waypoint

Erforderlich. Start-Wegpunkt

route_modifiers

RouteModifiers

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

RouteModifiers

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

Felder
`avoid_tolls`	`bool` Gibt an, ob Mautstraßen vermieden werden sollen, wenn sie angemessen sind. Routen ohne Mautstraßen haben Vorrang. Gilt nur für die Mobilitätsformen `DRIVE` und `TWO_WHEELER`.
`avoid_highways`	`bool` Gibt an, ob Autobahnen vermieden werden sollen, wo es sinnvoll ist. Routen ohne Autobahnen haben Vorrang. Gilt nur für die Mobilitätsformen `DRIVE` und `TWO_WHEELER`.
`avoid_ferries`	`bool` Gibt an, ob Fähren vermieden werden, wenn es sinnvoll ist. Routen ohne Fährverbindungen haben Vorrang. Gilt nur für die Mobilitätsformen `DRIVE` und `TWO_WHEELER`.
`avoid_indoor`	`bool` Gibt an, ob die Navigation in Innenräumen vermieden werden soll, wenn dies sinnvoll ist. Routen ohne Indoor-Navigationselemente haben Vorrang. Gilt nur für die Mobilitätsform `WALK`.
`vehicle_info`	`VehicleInfo` Gibt die Fahrzeuginformationen an.
`toll_passes[]`	`TollPass` Enthält Informationen zu Mautkarten. Wenn Mautkarten angegeben werden, versucht die API, den Preis der Karte bzw. des Tickets zurückzugeben. Wenn keine Mautpässe angegeben werden, behandelt die API sie als unbekannt und versucht, den Barpreis zurückzugeben. Gilt nur für die Mobilitätsformen DRIVE und TWO_WHEELER.

RouteObjective

Kapselt ein Ziel ein, für das ComputeCustomRoutes optimiert werden soll.

Felder

Felder
`rate_card`	`RateCard` Das Preislistenziel.

rate_card

RateCard

Das Preislistenziel.

RateCard

Kapselt ein Preislistenroutenziel.

Felder

Felder
`cost_per_minute`	`MonetaryCost` Optional. Kosten pro Minute.
`cost_per_km`	`MonetaryCost` Optional. Kosten pro Kilometer.
`include_tolls`	`bool` Optional. Gibt an, ob Mautgebühren in die Gesamtkosten einbezogen werden sollen.

cost_per_minute

MonetaryCost

Optional. Kosten pro Minute.

cost_per_km

MonetaryCost

Optional. Kosten pro Kilometer.

include_tolls

bool

Optional. Gibt an, ob Mautgebühren in die Gesamtkosten einbezogen werden sollen.

MonetaryCost

Zusammenfassung der in der Preisliste verwendeten Kosten.

Felder

Felder
`value`	`double` Erforderlich. Der aus der Anfrage abgeleitete Kostenwert in der lokalen Währung.

value

double

Erforderlich. Der aus der Anfrage abgeleitete Kostenwert in der lokalen Währung.

RouteTravelAdvisory

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

Felder

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 dieses Feld festgelegt ist, das Unterfeld "estimated_price" jedoch nicht ausgefüllt ist, gehen wir davon aus, dass die Straße Mautstraßen enthält, uns jedoch kein geschätzter Preis bekannt ist. Wenn dieses Feld nicht festgelegt ist, erwarten wir keine Mautgebühren auf der Route.
`speed_reading_intervals[]`	`SpeedReadingInterval` Intervalle für Geschwindigkeitsmessungen, die Angaben zur Verkehrsdichte machen. Gilt bei Routeneinstellungen für `TRAFFIC_AWARE` und `TRAFFIC_AWARE_OPTIMAL`. Die Intervalle decken die gesamte Polylinie der Route ohne Überlappung ab. Der Startpunkt eines angegebenen Intervalls ist mit dem Endpunkt des vorherigen Intervalls identisch. Beispiel: `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

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 dieses Feld festgelegt ist, das Unterfeld "estimated_price" jedoch nicht ausgefüllt ist, gehen wir davon aus, dass die Straße Mautstraßen enthält, uns jedoch kein geschätzter Preis bekannt ist. Wenn dieses Feld nicht festgelegt ist, erwarten wir keine Mautgebühren auf der Route.

speed_reading_intervals[]

SpeedReadingInterval

Intervalle für Geschwindigkeitsmessungen, die Angaben zur Verkehrsdichte machen. Gilt bei Routeneinstellungen für TRAFFIC_AWARE und TRAFFIC_AWARE_OPTIMAL. Die Intervalle decken die gesamte Polylinie der Route ohne Überlappung ab. Der Startpunkt eines angegebenen Intervalls ist mit dem Endpunkt des vorherigen Intervalls identisch.

Beispiel:

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

RouteTravelMode

Eine Reihe von Werten zur Angabe der Mobilitätsform.

Enums
`TRAVEL_MODE_UNSPECIFIED`	Keine Mobilitätsform angegeben. Die Standardeinstellung ist `DRIVE`.
`DRIVE`	Pkw
`BICYCLE`	Mit dem Fahrrad unterwegs
`WALK`	Gehen Sie zu Fuß.
`TWO_WHEELER`	Zweirädrige Kraftfahrzeuge Beispiel: Motorrad. Beachten Sie, dass sich dies von der Mobilitätsform `BICYCLE` unterscheidet, die die Mobilitätsform menschlich bedient.
`TAXI`	Eine Fahrt mit einem zugelassenen Taxi, das in einigen Gebieten auf bestimmten Taxispuren fahren darf. Der TAXI-Modus ist eine experimentelle Funktion. Wenn ein Kunde eine TAXI-Route in einer Stadt anfordert, für die keine Daten zu Taxispuren verfügbar sind, wird eine DRIVE-Route zurückgegeben.

RoutingPreference

Eine Reihe von Werten, die Faktoren angeben, die bei der Berechnung der Route zu berücksichtigen sind.

Enums
`ROUTING_PREFERENCE_UNSPECIFIED`	Keine Routingeinstellung angegeben. Standardeinstellung ist `TRAFFIC_AWARE`.
`TRAFFIC_UNAWARE`	Berechnet Routen ohne Berücksichtigung der Verkehrslage. Geeignet, wenn die Verkehrslage keine Rolle spielt. Die Verwendung dieses Werts erzeugt die niedrigste Latenz.
`TRAFFIC_AWARE`	Berechnet Routen unter Berücksichtigung der Verkehrslage. Im Gegensatz zu `TRAFFIC_AWARE_OPTIMAL` werden einige Optimierungen angewendet, um die Latenz erheblich zu verringern.
`TRAFFIC_AWARE_OPTIMAL`	Berechnet die Routen unter Berücksichtigung der Verkehrslage, ohne die meisten Leistungsoptimierungen anzuwenden. Die Verwendung dieses Werts erzeugt die höchste Latenz.

SpeedReadingInterval

Die 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 SpeedReadingInterval ein Intervall und beschreibt den Traffic mithilfe der folgenden Kategorien.

Felder

Felder
`start_polyline_point_index`	`int32` Der Startindex dieses Intervalls in der Polylinie. Wenn der Index in JSON 0 ist, scheint das Feld leer zu sein.
`end_polyline_point_index`	`int32` Der Endindex dieses Intervalls in der Polylinie. Wenn der Index in JSON 0 ist, scheint das Feld leer zu sein.
`speed`	`Speed` Verkehrsgeschwindigkeit in diesem Intervall.

start_polyline_point_index

int32

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

end_polyline_point_index

int32

Der Endindex dieses Intervalls in der Polylinie. Wenn der Index in JSON 0 ist, scheint das Feld leer zu sein.

speed

Speed

Verkehrsgeschwindigkeit in diesem Intervall.

Geschwindigkeit

Klassifizierung der Geschwindigkeit von Polylinien auf Grundlage von Verkehrsdaten.

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

TollInfo

Umfasst Mautinformationen auf einer Route oder einer RouteLeg.

Felder

Felder
`estimated_price[]`	`Money` Der Geldbetrag an Mautgebühren für die entsprechende Route oder RouteLeg. Diese Liste enthält einen Geldbetrag für jede Währung, die voraussichtlich von den Mautstationen in Rechnung gestellt wird. Normalerweise enthält diese Liste nur einen Eintrag für Routen mit Mautgebühren in einer Währung. Bei Auslandsreisen kann diese Liste mehrere Einträge für Mautgebühren in verschiedenen Währungen enthalten.

estimated_price[]

Money

Der Geldbetrag an Mautgebühren für die entsprechende Route oder RouteLeg. Diese Liste enthält einen Geldbetrag für jede Währung, die voraussichtlich von den Mautstationen in Rechnung gestellt wird. Normalerweise enthält diese Liste nur einen Eintrag für Routen mit Mautgebühren in einer Währung. Bei Auslandsreisen kann diese Liste mehrere Einträge für Mautgebühren in verschiedenen Währungen enthalten.

TollPass

Liste der von uns unterstützten Mautpässe weltweit.

Enums
`TOLL_PASS_UNSPECIFIED`	Nicht verwendet. Wenn dieser Wert verwendet wird, schlägt die Anfrage fehl.
`AU_ETOLL_TAG`	Einer von vielen Anbietern von Mautpass-Karten in Sydney. https://www.myetoll.com.au
`AU_EWAY_TAG`	Einer von vielen Anbietern von Mautpass-Karten in Sydney. 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`	Brasilianischer Mautpass. Weitere Informationen finden Sie unter https://www.autoexpreso.com.
`BR_CONECTCAR`	Brasilianischer Mautpass. Weitere Informationen finden Sie unter https://conectcar.com.
`BR_MOVE_MAIS`	Brasilianischer Mautpass. Weitere Informationen finden Sie unter https://movemais.com.
`BR_PASSA_RAPIDO`	Brasilianischer Mautpass. Weitere Informationen finden Sie unter https://pasorapido.gob.do/.
`BR_SEM_PARAR`	Brasilianischer Mautpass. Weitere Informationen finden Sie unter https://www.semparar.com.br.
`BR_TAGGY`	Brasilianischer Mautpass. Weitere Informationen finden Sie unter https://taggy.com.br.
`BR_VELOE`	Brasilianischer Mautpass. Weitere Informationen finden Sie unter https://veloe.com.br/site/onde-usar.
`CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD`	Grenzübergang von Kanada nach USA.
`CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD`	Grenzübergang von Kanada nach USA.
`CA_US_BLUE_WATER_EDGE_PASS`	Grenzübergang von Ontario, Kanada nach Michigan, USA.
`CA_US_CONNEXION`	Grenzübergang von Ontario, Kanada nach Michigan, USA.
`CA_US_NEXUS_CARD`	Grenzübergang von Kanada nach USA.
`ID_E_TOLL`	Indonesien. Von mehreren Banken für die Bezahlung von Mautgebühren verwendete E-Karte. Alle E-Karten von Banken werden auf dieselbe Weise 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: Steuerbefreiung für das HP-US-amerikanische Kennzeichen.
`MX_TAG_IAVE`	Mexikanischer Mautpass.
`MX_TAG_TELEVIA`	in Mexiko. Eine von vielen Unternehmen, die in Mexiko-Stadt tätig sind. Weitere Informationen finden Sie unter 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`	Alaska, USA.
`US_CA_FASTRAK`	Kalifornien, USA.
`US_CA_FASTRAK_CAV_STICKER`	Gibt an, dass der Fahrer neben dem von der DMV ausgestellten CAV-Wert (Clean Air Vehicle) einen FasTrak-Pass hat. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
`US_CO_EXPRESSTOLL`	CO, USA.
`US_CO_GO_PASS`	CO, USA.
`US_DE_EZPASSDE`	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_KY_RIVERLINK`	KY, USA.
`US_LA_GEAUXPASS`	Los Angeles, USA.
`US_LA_TOLL_TAG`	Los Angeles, USA.
`US_MA_EZPASSMA`	Massachusetts, USA.
`US_MD_EZPASSMD`	Maryland, USA.
`US_ME_EZPASSME`	ME, USA.
`US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD`	Michigan, USA.
`US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG`	Michigan, USA.
`US_MI_IQ_PROX_CARD`	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`	Rhode Island, USA.
`US_SC_PALPASS`	South Carolina, 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_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`	VA, 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_NEWELL_TOLL_BRIDGE_TICKET`	WV, USA.

Einheiten

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

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

VehicleEmissionType

Ein Satz von Werten, die den Emissionstyp des Fahrzeugs beschreiben. Gilt nur für die Mobilitätsform DRIVE.

Enums
`VEHICLE_EMISSION_TYPE_UNSPECIFIED`	Kein Emissionstyp angegeben. Die Standardeinstellung ist GASOLINE.
`GASOLINE`	Fahrzeug mit Benzin-/Benzinantrieb.
`ELECTRIC`	Elektrisch betriebenes Fahrzeug
`HYBRID`	Hybridfahrzeug (z. B. Benzin und Elektro)

VehicleInfo

Enthält die Fahrzeuginformationen, z. B. das letzte Zeichen des Kfz-Kennzeichens.

Felder

Felder
`emission_type`	`VehicleEmissionType` Beschreibt den Emissionstyp des Fahrzeugs. Gilt nur für die Mobilitätsform DRIVE.

emission_type

VehicleEmissionType

Beschreibt den Emissionstyp des Fahrzeugs. Gilt nur für die Mobilitätsform DRIVE.

Zwischenstopp

Schließt einen Wegpunkt ein. Wegpunkte kennzeichnen den Anfang und das Ende einer Route und umfassen Zwischenhalte entlang der Route.

Felder
`via`	`bool` Kennzeichnet diesen Wegpunkt als Meilenstein und nicht als Haltepunkt. Für jeden Wegpunkt in der Anfrage, bei dem es sich nicht um einen Wegpunkt handelt, wird in der Antwort ein Eintrag an das Array `legs` angehängt, um Details zu Zwischenstopps an diesem Abschnitt der Fahrt bereitzustellen. Setzen Sie diesen Wert auf „true“, wenn die Route diesen Wegpunkt ohne Zwischenstopp passieren soll. Via-Wegpunkte bewirken nicht, dass dem Array `legs` ein Eintrag hinzugefügt wird, sie leiten jedoch die Reise über den Wegpunkt. Dieser Wert kann nur für Wegpunkte festgelegt werden, 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 Stopps zwischen Fahrzeugen und zum Ein- oder Aussteigen bestimmt ist. Wenn Sie diesen Wert festlegen, enthält die berechnete Route keine Wegpunkte, die nicht `via` sind, auf Straßen, die nicht für ein Ein- und Aussteigen geeignet sind. Diese Option funktioniert nur für die Mobilitätsformen `DRIVE` und `TWO_WHEELER` und wenn `location_type` den Wert `location` hat.
`side_of_road`	`bool` Gibt an, dass der Standort dieses Wegpunkts vorzugsweise an einer bestimmten Straßenseite halten soll. Wenn Sie diesen Wert festlegen, wird die Route so durch den Ort geführt, dass das Fahrzeug an der Straßenseite anhalten kann, die von der Straßenmitte aus geneigt ist. Diese Option funktioniert nur für die Mobilitätsformen „DRIVE“ und „TWO_WHEELER“ und nur, wenn „location_type“ auf „location“ festgelegt ist.
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 einschließlich einer optionalen Richtung angegeben wird.
`place_id`	`string` Die mit dem Wegpunkt verknüpfte POI-Orts-ID