Route

Schließt eine Route ein, die aus einer Folge von miteinander verbundenen Straßensegmenten besteht, die Wegpunkte am Anfang, Ende und in der Mitte verbinden.

JSON-Darstellung
{
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ]
}
Felder
legs[]

object (RouteLeg)

Mehrere Abschnitte der Route, d. h. Pfadsegmente zwischen Wegpunkten. Jeder Abschnitt entspricht der Fahrt zwischen zwei Wegpunkten, die keine via sind. 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 ComputeRoutesRequest.optimize_waypoint_order auf „true“ gesetzt ist, enthält dieses Feld die optimierte Reihenfolge der Wegpunkte. Andernfalls ist dieses Feld leer. Angenommen, die Eingabe lautet Origin: LA; Fortgeschrittene Anfänger: Dallas, Bangor, Phoenix Zielort: New York; und die optimierte Wegpunktreihenfolge ist: Phoenix, Dallas, Bangor. Dann enthält dieses Feld die Werte [2, 0, 1]. Der Index beginnt für den ersten Wegpunkt mit 0.

RouteLeg

Schließt ein Segment zwischen Wegpunkten ein, 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)
  }
}
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 Fahrtdauer eines Abschnitts, bei der die Verkehrslage nicht berücksichtigt 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 Streckenabschnitt. Dies schließt die Polylinie jeder step ein.

startLocation

object (Location)

Die Startposition dieses Streckenabschnitts. Diese kann sich von der 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. Diese kann sich von der 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)

Sammelt die zusätzlichen Informationen, über die der Nutzer informiert werden soll, z. B. die Beschränkung der Verkehrszone auf einem Streckenabschnitt.

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

Kapselt ein Segment einer RouteLeg ein. 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)
  }
}
Felder
distanceMeters

integer

Die Strecke dieses Schritts 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 informiert werden sollte, z. B. die Beschränkung eines Abschnitts eines Abschnitts auf eine bestimmte Verkehrszone.

RouteLegStepTravelAdvisory

Enthält die zusätzlichen Informationen, über die der Nutzer informiert werden sollte, z. B. die Beschränkung eines Abschnitts eines Abschnitts auf eine bestimmte Verkehrszone.

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

object (SpeedReadingInterval)

Geschwindigkeitsleseintervalle zur detaillierten Verkehrsdichte. Anwendbar bei den Routingeinstellungen 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 vorhergehenden Intervalls identisch.

Beispiel:

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

RouteLegTravelAdvisory

Sammelt die zusätzlichen Informationen, über die der Nutzer informiert werden soll, z. B. die Beschränkung der Verkehrszone auf einem Streckenabschnitt.

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

object (TollInfo)

Kapselt Informationen zu Mautgebühren des spezifischen RouteLeg-Objekts. Dieses Feld wird nur ausgefüllt, wenn wir davon ausgehen, dass auf dem 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. Ist dieses Feld nicht vorhanden, fallen für das RouteLeg keine Mautgebü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 der RouteLg 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).