Method: computeRoutes

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

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

Zum Beispiel in dieser Methode:

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

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

  • Indem Sie nur die Felder auswählen, die Sie benötigen, spart unser Server Berechnungszyklen, sodass wir das Ergebnis mit einer geringeren Latenz an Sie zurückgeben können.
  • Wenn Sie nur die Felder auswählen, die Sie für Ihren Produktionsjob benötigen, wird eine stabile Latenzleistung sichergestellt. Möglicherweise fügen wir in Zukunft weitere Antwortfelder hinzu und diese neuen Felder erfordern möglicherweise zusätzliche Rechenzeit. Wenn Sie alle Felder oder alle Felder auf der obersten Ebene auswählen, kann es zu Leistungseinbußen kommen, da jedes neu hinzugefügte Feld automatisch in die Antwort aufgenommen wird.
  • Wenn Sie nur die Felder auswählen, die Sie benötigen, führt dies zu einer kleineren Antwortgröße und damit zu einem höheren Netzwerkdurchsatz.

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

destination

object (Waypoint)

Erforderlich. Zielwegpunkt.

intermediates[]

object (Waypoint)

Optional. Eine Gruppe von Wegpunkten entlang der Route (mit Ausnahme von Endpunkten), die an einem Zwischenstopp stehen oder an einem vorbeigehen. Es werden bis zu 25 Wegpunkte unterstützt.

travelMode

enum (RouteTravelMode)

Optional. Gibt die Mobilitätsform an.

routingPreference

enum (RoutingPreference)

Optional. Gibt an, wie die Route berechnet wird. Der Server versucht, die Route anhand der ausgewählten Routingeinstellung zu berechnen. Wenn die Routingeinstellung zu einem Fehler oder zu einer sehr langen Latenz führt, wird ein Fehler zurückgegeben. Sie können diese Option nur angeben, wenn travelMode den Wert DRIVE oder TWO_WHEELER hat. Andernfalls schlägt die Anfrage fehl.

polylineQuality

enum (PolylineQuality)

Optional. Gibt die 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 der Zeitpunkt der Anfrage verwendet. HINWEIS: Sie können nur einen departureTime in der Vergangenheit angeben, wenn RouteTravelMode auf TRANSIT gesetzt ist. Fahrten mit öffentlichen Verkehrsmitteln sind für bis zu 7 Tage in der Vergangenheit oder bis zu 100 Tage in der Zukunft verfügbar.

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. Ankunftszeit HINWEIS: Kann nur festgelegt werden, wenn RouteTravelMode auf TRANSIT gesetzt ist. Sie können entweder departureTime oder arrivalTime angeben, aber nicht beides. Fahrten mit öffentlichen Verkehrsmitteln sind für bis zu 7 Tage in der Vergangenheit oder bis zu 100 Tage in der Zukunft verfügbar.

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

regionCode

string

Optional. Der Regionscode, angegeben als zweistelliger ccTLD-Wert ("top-level domain"). Weitere Informationen finden Sie unter Ländercode-Top-Level-Domains.

units

enum (Units)

Optional. Gibt die Maßeinheiten für die Anzeigefelder an. Zu diesen Feldern gehört das Feld instruction in NavigationInstruction. Die Maßeinheiten, die für Route, Streckenabschnitt, Schrittstrecke und Dauer verwendet werden, sind von diesem Wert nicht betroffen. Wenn Sie diesen Wert nicht angeben, werden die Anzeigeeinheiten vom Standort des ersten Startorts abgeleitet.

optimizeWaypointOrder

boolean

Optional. Wenn dieser Wert auf „true“ gesetzt ist, versucht der Dienst, die Gesamtkosten der Route durch eine Neuanordnung der angegebenen Zwischenwegpunkte zu minimieren. Die Anfrage schlägt fehl, wenn einer der Wegzwischenpunkte ein via-Wegpunkt ist. Verwenden Sie ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index, um die neue Reihenfolge zu finden. Wenn ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index nicht im X-Goog-FieldMask-Header angefordert wird, schlägt die Anfrage fehl. Wenn optimizeWaypointOrder auf „false“ gesetzt ist, ist ComputeRoutesResponse.optimized_intermediate_waypoint_index leer.

requestedReferenceRoutes[]

enum (ReferenceRoute)

Optional. Gibt an, welche Referenzrouten zusätzlich zur Standardroute als Teil der Anfrage berechnet werden sollen. Eine Referenzroute ist eine Route, deren Berechnungsziel von der Standardroute abweicht. Bei der Berechnung einer FUEL_EFFICIENT-Referenzroute werden beispielsweise verschiedene Parameter berücksichtigt, die eine optimale spritsparende Route generieren würden.

extraComputations[]

enum (ExtraComputation)

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

trafficModel

enum (TrafficModel)

Optional. Gibt die Annahmen an, die bei der Berechnung der Reisezeit verwendet werden sollen. Diese Einstellung wirkt sich auf den Wert aus, der im Feld „Dauer“ in Route und RouteLeg zurückgegeben wird. Dieser Wert enthält die vorhergesagte Zeit im Traffic basierend auf historischen Durchschnittswerten. TrafficModel ist nur für Anfragen verfügbar, bei denen RoutingPreference auf TRAFFIC_AWARE_OPTIMAL und RouteTravelMode auf DRIVE festgelegt wurde. Die Standardeinstellung ist BEST_GUESS, wenn Traffic angefordert wird, und TrafficModel ist nicht angegeben.

transitPreferences

object (TransitPreferences)

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

Antworttext

v2.computeRoute leitet die Antwortnachricht weiter.

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

fallbackInfo

object (FallbackInfo)

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

geocodingResults

object (GeocodingResults)

Enthält Geocoding-Antwortinformationen für als Adressen angegebene Wegpunkte.

PolylineQuality

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

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

PolylineEncoding

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

Enums
POLYLINE_ENCODING_UNSPECIFIED Keine Einstellung für Polylinientyp angegeben. Die Standardeinstellung ist ENCODED_POLYLINE.
ENCODED_POLYLINE Gibt eine Polylinie an, die mithilfe des Codierungsalgorithmus für Polylinien codiert wurde.
GEO_JSON_LINESTRING Gibt eine Polylinie im GeoJSON-LineString-Format an

ReferenceRoute

Eine unterstützte Referenzroute in ComputeRoutesRequest.

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

ExtraComputation

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

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

Route

Enthält eine Route, die aus einer Reihe verbundener Straßenabschnitte besteht, die Wegpunkte am Anfang, Ende und in der Mitte 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
}
Felder
routeLabels[]

enum (RouteLabel)

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

legs[]

object (RouteLeg)

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

distanceMeters

integer

Die Entfernung der Route in Metern.

duration

string (Duration format)

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

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

staticDuration

string (Duration format)

Die Dauer der Fahrt 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 gesamte Polylinie der Route. Diese Polylinie ist die kombinierte Polylinie aller legs.

description

string

Eine Beschreibung der Route.

warnings[]

string

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

viewport

object (Viewport)

Der Markierungsrahmen des Darstellungsbereichs der Polylinie.

travelAdvisory

object (RouteTravelAdvisory)

Zusätzliche Informationen zur Route.

optimizedIntermediateWaypointIndex[]

integer

Wenn Sie optimizeWaypointOrder auf „true“ setzen, enthält dieses Feld die optimierte Reihenfolge der Wegpunkte. Andernfalls ist dieses Feld leer. Wenn Sie beispielsweise Origin: LA; Wegpunkte mittlerer Stufe: Dallas, Bangor, Phoenix Zielort: New York; und die optimierte Wegpunktreihenfolge Phoenix, Dallas, Bangor ist, enthält dieses Feld die Werte [2, 0, 1]. Der Index beginnt für den ersten in der Eingabe angegebenen Zwischenwegpunkt mit 0.

localizedValues

object (RouteLocalizedValues)

Textdarstellungen von Attributen von Route.

routeToken

string

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

RouteLabel

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

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

RouteLeg

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

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 Strecke des Streckenabschnitts in Metern.

duration

string (Duration format)

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

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

polyline

object (Polyline)

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

startLocation

object (Location)

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

endLocation

object (Location)

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

steps[]

object (RouteLegStep)

Ein Array von Schritten, die Segmente innerhalb dieses Abschnitts angeben. Jeder Schritt stellt eine Navigationsanweisung dar.

travelAdvisory

object (RouteLegTravelAdvisory)

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

localizedValues

object (RouteLegLocalizedValues)

Textdarstellungen von Attributen von RouteLeg.

stepsOverview

object (StepsOverview)

Übersicht über die Schritte in diesem RouteLeg. Dieses Feld wird nur bei TRANSIT-Routen 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. Kapselt den Typ der Polylinie ein. Die Standardeinstellung ist encoded_polyline. Für polyline_type ist nur einer der folgenden Werte zulässig:
encodedPolyline

string

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

geoJsonLinestring

object (Struct format)

Gibt eine Polylinie im GeoJSON-LineString-Format an.

RouteLegStep

Enthält ein Segment eines RouteLeg. Ein Schritt entspricht einer einzelnen Navigationsanweisung. Streckenabschnitte 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 Schrittes in Metern. Unter bestimmten Umständen enthält dieses Feld keinen Wert.

staticDuration

string (Duration format)

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

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

polyline

object (Polyline)

Die mit diesem Schritt verknüpfte Polylinie.

startLocation

object (Location)

Die Startposition dieses Schritts.

endLocation

object (Location)

Der Endstandort dieses Schritts.

navigationInstruction

object (NavigationInstruction)

Navigationsanweisungen

travelAdvisory

object (RouteLegStepTravelAdvisory)

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

localizedValues

object (RouteLegStepLocalizedValues)

Textdarstellungen von Attributen von RouteLegStep.

transitDetails

object (RouteLegStepTransitDetails)

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

travelMode

enum (RouteTravelMode)

Die für diesen Schritt verwendete Mobilitätsform.

Manöver

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

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

RouteLegStepTravelAdvisory

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

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

object (SpeedReadingInterval)

HINWEIS: Dieses Feld ist derzeit nicht ausgefüllt.

RouteLegStepLocalizedValues

Textdarstellungen bestimmter Eigenschaften.

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

object (LocalizedText)

In Textform dargestellte Reisestrecke.

staticDuration

object (LocalizedText)

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

RouteLegStepTransitDetails

Zusätzliche Informationen für RouteLegStep in Bezug auf 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 Abfahrtsorten für den Schritt.

localizedValues

object (TransitDetailsLocalizedValues)

Textdarstellungen von Attributen von RouteLegStepTransitDetails.

headsign

string

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

headway

string (Duration format)

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

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

transitLine

object (TransitLine)

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

stopCount

integer

Die Anzahl der Haltestellen von der Abfahrt bis zur Ankunftshaltestelle. Die Anzahl umfasst die Ankunftshaltestelle, die Starthaltestelle aber nicht. Wenn Ihre Route beispielsweise an Haltestelle A abfährt, über die Haltestellen B und C führt und an Haltestelle D ankommt, gibt stopCount 3 zurück.

tripShortText

string

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

TransitStopDetails

Details zu den Haltestellen für die 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 geschätzte 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)

Die Position der Haltestelle in Breiten- und Längengraden.

TransitDetailsLocalizedValues

Lokalisierte Beschreibungen der Werte für RouteTransitDetails.

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

object (LocalizedTime)

Zeit in der formatierten Textdarstellung mit einer entsprechenden Zeitzone.

departureTime

object (LocalizedTime)

Zeit in der formatierten Textdarstellung mit einer entsprechenden Zeitzone.

LocalizedTime

Lokalisierte Beschreibung der Zeit.

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

object (LocalizedText)

Die als String in einer bestimmten Zeitzone angegebene Zeit.

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 zu der ÖPNV-Linie, die in diesem Schritt verwendet wird.

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 oder die Betreiber der ÖPNV-Linie.

name

string

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

uri

string

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

color

string

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

iconUri

string

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

nameShort

string

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

textColor

string

Die übliche Farbe, die im Text auf Beschilderungen dieser Linie verwendet wird. 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 formatierte Telefonnummer des Verkehrsverbunds.

uri

string

Der URI des Verkehrsverbunds.

TransitVehicle

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

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

object (LocalizedText)

Der Name dieses Fahrzeugs in Großbuchstaben.

type

enum (TransitVehicleType)

Der Typ des verwendeten Fahrzeugs.

iconUri

string

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

localIconUri

string

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

TransitVehicleType

Der Fahrzeugtyp für Routen mit öffentlichen Verkehrsmitteln.

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

RouteLegTravelAdvisory

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

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

object (TollInfo)

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

speedReadingIntervals[]

object (SpeedReadingInterval)

Geschwindigkeitsleseintervalle zur detaillierten Verkehrsdichte. Anwendbar bei den Routingeinstellungen TRAFFIC_AWARE und TRAFFIC_AWARE_OPTIMAL. Die Intervalle decken die gesamte Polylinie von RouteLeg ohne Überschneidung ab. Der Startpunkt eines angegebenen Intervalls ist mit dem Endpunkt des vorhergehenden Intervalls identisch.

Beispiel:

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

RouteLegLocalizedValues

Textdarstellungen bestimmter Eigenschaften.

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

object (LocalizedText)

In Textform dargestellte Reisestrecke.

duration

object (LocalizedText)

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

staticDuration

object (LocalizedText)

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

StepsOverview

Bietet eine Übersicht über eine Liste von RouteLegSteps.

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

object (MultiModalSegment)

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

MultiModalSegment

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

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

object (NavigationInstruction)

NavigationInstruction für das multimodale Segment.

travelMode

enum (RouteTravelMode)

Die Mobilitätsform des multimodalen Segments.

stepStartIndex

integer

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

stepEndIndex

integer

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

Darstellungsbereich

Ein Darstellungsbereich für Breiten- und Längengrad, dargestellt als zwei diagonal gegenüberliegende low- und high-Punkte Ein Darstellungsbereich gilt als geschlossener Bereich, d.h. er enthält seine Begrenzung. Die Breitengradgrenzen müssen zwischen -90 und einschließlich 90 Grad und die Längengradgrenzen zwischen -180 und 180 Grad liegen. Es gibt verschiedene Fälle:

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

  • Wenn low.longitude > high.longitude wird der Längengradbereich umgekehrt (der Darstellungsbereich kreuzt die 180-Grad-Längenlinie).

  • 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, der Breitengradbereich ist leer.

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

Dieser Darstellungsbereich schließt beispielsweise New York City vollständig ein:

{ "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 Tiefstpunkt des Darstellungsbereichs.

high

object (LatLng)

Erforderlich. Der höchste Punkt des Darstellungsbereichs.

RouteLocalizedValues

Textdarstellungen bestimmter Eigenschaften.

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

object (LocalizedText)

In Textform dargestellte Reisestrecke.

duration

object (LocalizedText)

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

staticDuration

object (LocalizedText)

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

transitFare

object (LocalizedText)

Fahrpreis in Textform

GeocodingResults

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

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

object (GeocodedWaypoint)

Geocodierter Startwegpunkt.

destination

object (GeocodedWaypoint)

Geocodierter Wegpunkt für das Ziel.

intermediates[]

object (GeocodedWaypoint)

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

GeocodedWaypoint

Details zu den Standorten, die als Wegpunkte verwendet werden Wird nur für Wegpunkte der Adresse ausgefüllt. Enthält Details über die Geocoding-Ergebnisse, um zu bestimmen, für welche Adresse 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

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

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