Method: computeRoutes

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

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

Beispiel für diese Methode:

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

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

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

HTTP-Anfrage

POST https://routes.googleapis.com/directions/v2:computeRoutes

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "arrivalTime": string,
  "computeAlternativeRoutes": boolean,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "languageCode": string,
  "regionCode": string,
  "units": enum (Units),
  "optimizeWaypointOrder": boolean,
  "requestedReferenceRoutes": [
    enum (ReferenceRoute)
  ],
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "trafficModel": enum (TrafficModel),
  "transitPreferences": {
    object (TransitPreferences)
  }
}
Felder
origin

object (Waypoint)

Erforderlich. Startpunkt.

destination

object (Waypoint)

Erforderlich. Ziel-Wegpunkt

intermediates[]

object (Waypoint)

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

travelMode

enum (RouteTravelMode)

Optional. Gibt die Mobilitätsform an.

routingPreference

enum (RoutingPreference)

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

polylineQuality

enum (PolylineQuality)

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

polylineEncoding

enum (PolylineEncoding)

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

departureTime

string (Timestamp format)

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

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

arrivalTime

string (Timestamp format)

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

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

computeAlternativeRoutes

boolean

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

routeModifiers

object (RouteModifiers)

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

languageCode

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.

regionCode

string

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

units

enum (Units)

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

optimizeWaypointOrder

boolean

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

requestedReferenceRoutes[]

enum (ReferenceRoute)

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

extraComputations[]

enum (ExtraComputation)

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

trafficModel

enum (TrafficModel)

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

transitPreferences

object (TransitPreferences)

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

Antworttext

v2.computeRoutes die Antwortnachricht.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "routes": [
    {
      object (Route)
    }
  ],
  "fallbackInfo": {
    object (FallbackInfo)
  },
  "geocodingResults": {
    object (GeocodingResults)
  }
}
Felder
routes[]

object (Route)

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

fallbackInfo

object (FallbackInfo)

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

geocodingResults

object (GeocodingResults)

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

PolylineQuality

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

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

PolylineEncoding

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

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

ReferenceRoute

Eine unterstützte Referenzroute in der ComputeRoutesRequest.

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

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

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

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

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

ExtraComputation

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

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

Route

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

JSON-Darstellung
{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string,
  "polylineDetails": {
    object (PolylineDetails)
  }
}
Felder
routeLabels[]

enum (RouteLabel)

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

legs[]

object (RouteLeg)

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

distanceMeters

integer

Die zurückgelegte Strecke der Route in Metern.

duration

string (Duration format)

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

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

staticDuration

string (Duration format)

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

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

polyline

object (Polyline)

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

description

string

Eine Beschreibung der Route.

warnings[]

string

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

viewport

object (Viewport)

Der Begrenzungsrahmen des Darstellungsbereichs der Polylinie.

travelAdvisory

object (RouteTravelAdvisory)

Zusätzliche Informationen zur Route.

optimizedIntermediateWaypointIndex[]

integer

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

localizedValues

object (RouteLocalizedValues)

Textdarstellungen von Properties der Route.

routeToken

string

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

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

polylineDetails

object (PolylineDetails)

Enthält Informationen zu Details entlang der Polylinie.

RouteLabel

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

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

RouteLeg

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

JSON-Darstellung
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}
Felder
distanceMeters

integer

Die zurückgelegte Strecke des Streckenabschnitts in Metern.

duration

string (Duration format)

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

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

staticDuration

string (Duration format)

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

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

polyline

object (Polyline)

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

startLocation

object (Location)

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

endLocation

object (Location)

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

steps[]

object (RouteLegStep)

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

travelAdvisory

object (RouteLegTravelAdvisory)

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

localizedValues

object (RouteLegLocalizedValues)

Textdarstellungen von Properties der RouteLeg.

stepsOverview

object (StepsOverview)

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

Polyline

Kapselt eine codierte Polylinie ein.

JSON-Darstellung
{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}
Felder
Union-Feld polyline_type. Der Typ des Polyliniens. Standardeinstellung ist „encoded_polyline“. Für polyline_type ist nur einer der folgenden Werte zulässig:
encodedPolyline

string

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

geoJsonLinestring

object (Struct format)

Gibt eine Polylinie im GeoJSON-LineString-Format an.

RouteLegStep

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

JSON-Darstellung
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}
Felder
distanceMeters

integer

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

staticDuration

string (Duration format)

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

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

polyline

object (Polyline)

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

startLocation

object (Location)

Der Startort dieses Schritts.

endLocation

object (Location)

Der Endpunkt dieses Schritts.

navigationInstruction

object (NavigationInstruction)

Navigationsanleitung

travelAdvisory

object (RouteLegStepTravelAdvisory)

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

localizedValues

object (RouteLegStepLocalizedValues)

Textdarstellungen von Properties der RouteLegStep.

transitDetails

object (RouteLegStepTransitDetails)

Details zu diesem Schritt, wenn der Reisemodus TRANSIT ist.

travelMode

enum (RouteTravelMode)

Der für diesen Schritt verwendete Verkehrsmitteltyp.

Manöver

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

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

RouteLegStepTravelAdvisory

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

JSON-Darstellung
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Felder
speedReadingIntervals[]

object (SpeedReadingInterval)

HINWEIS: Dieses Feld ist derzeit nicht ausgefüllt.

RouteLegStepLocalizedValues

Textdarstellungen bestimmter Properties.

JSON-Darstellung
{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
Felder
distance

object (LocalizedText)

Die zurückgelegte Strecke in Textform.

staticDuration

object (LocalizedText)

Dauer ohne Berücksichtigung der Verkehrslage, in Textform

RouteLegStepTransitDetails

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

JSON-Darstellung
{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}
Felder
stopDetails

object (TransitStopDetails)

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

localizedValues

object (TransitDetailsLocalizedValues)

Textdarstellungen von Properties der RouteLegStepTransitDetails.

headsign

string

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

headway

string (Duration format)

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

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s". Beispiel: "3.5s".

transitLine

object (TransitLine)

Informationen zur in diesem Schritt verwendeten ÖPNV-Linie.

stopCount

integer

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

stopCount

gibt 3 zurück.

tripShortText

string

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

TransitStopDetails

Details zu den Haltestellen der RouteLegStep.

JSON-Darstellung
{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}
Felder
arrivalStop

object (TransitStop)

Informationen zur Ankunftshaltestelle für den Schritt.

arrivalTime

string (Timestamp format)

Die voraussichtliche Ankunftszeit für den Schritt.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

departureStop

object (TransitStop)

Informationen zur Abfahrtshaltestelle für den Schritt.

departureTime

string (Timestamp format)

Die geschätzte Abfahrtszeit für den Schritt.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

TransitStop

Informationen zu einer Haltestelle.

JSON-Darstellung
{
  "name": string,
  "location": {
    object (Location)
  }
}
Felder
name

string

Der Name der Haltestelle.

location

object (Location)

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

TransitDetailsLocalizedValues

Lokalisierte Beschreibungen von Werten für RouteTransitDetails.

JSON-Darstellung
{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}
Felder
arrivalTime

object (LocalizedTime)

Die Uhrzeit in der formatierten Textdarstellung mit einer entsprechenden Zeitzone.

departureTime

object (LocalizedTime)

Die Uhrzeit in der formatierten Textdarstellung mit einer entsprechenden Zeitzone.

LocalizedTime

Lokalisierte Zeitbeschreibung.

JSON-Darstellung
{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}
Felder
time

object (LocalizedText)

Die als String angegebene Zeit in einer bestimmten Zeitzone.

timeZone

string

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

TransitLine

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

JSON-Darstellung
{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}
Felder
agencies[]

object (TransitAgency)

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

name

string

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

uri

string

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

color

string

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

iconUri

string

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

nameShort

string

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

textColor

string

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

vehicle

object (TransitVehicle)

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

TransitAgency

Ein Betreiber, der eine ÖPNV-Linie betreibt.

JSON-Darstellung
{
  "name": string,
  "phoneNumber": string,
  "uri": string
}
Felder
name

string

Der Name des Betreibers.

phoneNumber

string

Die länderspezifische Telefonnummer des Betreibers.

uri

string

Der URI des Betreibers.

TransitVehicle

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

JSON-Darstellung
{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}
Felder
name

object (LocalizedText)

Der Name dieses Fahrzeugs, großgeschrieben.

type

enum (TransitVehicleType)

Der verwendete Fahrzeugtyp.

iconUri

string

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

localIconUri

string

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

TransitVehicleType

Der Fahrzeugtyp für ÖPNV-Routen.

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

RouteLegTravelAdvisory

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

JSON-Darstellung
{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Felder
tollInfo

object (TollInfo)

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

speedReadingIntervals[]

object (SpeedReadingInterval)

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

Beispiel:

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

RouteLegLocalizedValues

Textdarstellungen bestimmter Properties.

JSON-Darstellung
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
Felder
distance

object (LocalizedText)

Die zurückgelegte Strecke in Textform.

duration

object (LocalizedText)

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

staticDuration

object (LocalizedText)

Dauer ohne Berücksichtigung der Verkehrslage, in Textform

StepsOverview

Bietet eine Übersicht über eine Liste von RouteLegSteps.

JSON-Darstellung
{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}
Felder
multiModalSegments[]

object (MultiModalSegment)

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

MultiModalSegment

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

JSON-Darstellung
{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}
Felder
navigationInstruction

object (NavigationInstruction)

Navigationsanleitung für das multimodale Segment.

travelMode

enum (RouteTravelMode)

Die Mobilitätsform des multimodalen Abschnitts.

stepStartIndex

integer

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

stepEndIndex

integer

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

Darstellungsbereich

Ein Breiten- und Längengrad-Darstellungsbereich, dargestellt als zwei diagonal gegenüberliegende Punkte low und high. Ein Darstellungsbereich gilt als geschlossene Region, d.h., er schließt seine Begrenzung ein. Die Breitengradgrenzen müssen zwischen -90 und 90 Grad liegen und die Längengradgrenzen zwischen -180 und 180 Grad. Beispiele für verschiedene Fälle:

  • Wenn low = high ist, besteht der Darstellungsbereich aus diesem einzelnen Punkt.

  • Wenn low.longitude > high.longitude ist, ist der Längengradbereich umgekehrt (der Darstellungsbereich schneidet den Längengrad 180).

  • Wenn low.longitude = -180 Grad und high.longitude = 180 Grad ist, enthält der Darstellungsbereich alle Längengrade.

  • Wenn low.longitude = 180 Grad und high.longitude = -180 Grad ist, ist der Längengradbereich leer.

  • Wenn low.latitude > high.latitude ist, ist der Breitengradbereich leer.

Sowohl low als auch high müssen ausgefüllt sein und das dargestellte Feld darf nicht leer sein (wie in den Definitionen oben angegeben). Ein leerer Darstellungsbereich führt zu einem Fehler.

Dieser Ansichtsbereich umschließt beispielsweise vollständig New York City:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON-Darstellung
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Felder
low

object (LatLng)

Erforderlich. Der tiefste Punkt des Darstellungsbereichs.

high

object (LatLng)

Erforderlich. Der höchste Punkt des Darstellungsbereichs.

RouteLocalizedValues

Textdarstellungen bestimmter Properties.

JSON-Darstellung
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}
Felder
distance

object (LocalizedText)

Die zurückgelegte Strecke in Textform.

duration

object (LocalizedText)

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

staticDuration

object (LocalizedText)

Dauer ohne Berücksichtigung der Verkehrslage, in Textform

transitFare

object (LocalizedText)

Preis für öffentliche Verkehrsmittel in Textform.

PolylineDetails

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

JSON-Darstellung
{
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ]
}
Felder
flyoverInfo[]

object (FlyoverInfo)

Details zur Überflugsstrecke entlang der Polylinie.

narrowRoadInfo[]

object (NarrowRoadInfo)

Details zu schmalen Straßen entlang der Polylinie.

FlyoverInfo

Enthält Informationen zu Flyovers entlang der Polylinie.

JSON-Darstellung
{
  "flyoverPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Felder
flyoverPresence

enum (RoadFeatureState)

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

polylinePointIndex

object (PolylinePointIndex)

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

RoadFeatureState

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

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

PolylinePointIndex

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

JSON-Darstellung
{
  "startIndex": integer,
  "endIndex": integer
}
Felder
startIndex

integer

Der Startindex dieses Details in der Polylinie.

endIndex

integer

Der Endindex dieses Details in der Polylinie.

NarrowRoadInfo

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

JSON-Darstellung
{
  "narrowRoadPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Felder
narrowRoadPresence

enum (RoadFeatureState)

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

polylinePointIndex

object (PolylinePointIndex)

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

GeocodingResults

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

JSON-Darstellung
{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}
Felder
origin

object (GeocodedWaypoint)

Geocodierter Startpunkt.

destination

object (GeocodedWaypoint)

Geocodierter Wegpunkt für das Ziel.

intermediates[]

object (GeocodedWaypoint)

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

GeocodedWaypoint

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

JSON-Darstellung
{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}
Felder
geocoderStatus

object (Status)

Gibt den Statuscode des Geocoding-Vorgangs an.

type[]

string

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

partialMatch

boolean

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.

placeId

string

Die Orts-ID für dieses Ergebnis.

intermediateWaypointRequestIndex

integer

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