Route

Umfasst eine Route, die aus einer Reihe verbundener Straßensegmente besteht, die Start-, End- und Zwischenwegpunkte 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)

Eine Reihe von Abschnitten (Pfadsegmente zwischen Wegpunkten), aus denen die Route besteht. Jeder Abschnitt entspricht der Fahrt zwischen zwei Wegpunkten, die keine via sind. Eine Route ohne Zwischenziele hat beispielsweise nur einen Abschnitt. Eine Route, die einen Wegpunkt (nicht via) enthält, hat zwei Streckenabschnitte. Eine Route mit einem via-Wegpunkt hat einen Abschnitt. Die Reihenfolge der Streckenabschnitte entspricht der Reihenfolge der Wegpunkte von origin über intermediates bis 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 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 Polylinie der gesamten Route. Diese Polylinie ist die kombinierte Polylinie aller legs.
description

string

Eine Beschreibung der Route.
warnings[]

string

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

object (Viewport)

Der Begrenzungsrahmen des Darstellungsbereichs der Polylinie.
travelAdvisory

object (RouteTravelAdvisory)

Zusätzliche Informationen zur Route.
optimizedIntermediateWaypointIndex[]

integer

Wenn ComputeRoutesRequest.optimize_waypoint_order auf „wahr“ gesetzt ist, enthält dieses Feld die optimierte Reihenfolge der Zwischenwegpunkte. Andernfalls ist dieses Feld leer. Angenommen, die Eingabe lautet: Start: Los Angeles; Zwischenstationen: Dallas, Bangor, Phoenix; Ziel: New York. Die optimierte Reihenfolge der Zwischenstopps ist: Phoenix, Dallas, Bangor. Dieses Feld enthält dann 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 zurückgelegte 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 mit staticDuration identisch. 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 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)

Die Gesamtpolylinie für dieses Teilstück. Dazu gehört auch die Polylinie jedes step.
startLocation

object (Location)

Die Startposition dieses Streckenabschnitts. Dieser 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. Dieser 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 in diesem Abschnitt angeben. Jeder Schritt stellt eine Navigationsanweisung dar.
travelAdvisory

object (RouteLegTravelAdvisory)

Enthält zusätzliche Informationen, über die der Nutzer informiert werden sollte, z. B. mögliche Einschränkungen für eine 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 des Polyliniens 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 zur Codierung der Polylinie.
geoJsonLinestring

object (Struct format)

Hiermit wird eine Polylinie im GeoJSON-LineString-Format angegeben.

RouteLegStep

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

integer

Die zurückgelegte Strecke dieses Schritts in Metern. Unter bestimmten Umständen enthält dieses Feld keinen Wert.
staticDuration

string (Duration format)

Die Dauer der Fahrt durch diesen Abschnitt 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 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 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)

HINWEIS: Dieses Feld ist derzeit nicht ausgefüllt.

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)

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 Mautgebühren 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, gibt es keine Maut für die RouteLeg.
speedReadingIntervals[]

object (SpeedReadingInterval)

Geschwindigkeitsleseintervalle zur detaillierten Verkehrsdichte. Anwendbar bei den Routingeinstellungen TRAFFIC_AWARE und TRAFFIC_AWARE_OPTIMAL. Die Intervalle müssen die gesamte Polylinie des RouteLeg ohne Überschneidung abdecken. 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).