Route

Es handelt sich um eine Route, die aus einer Reihe verbundener Straßensegmente besteht, die Start-, End- und Zwischenwegpunkte miteinander 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 Gruppe von Streckenabschnitten (Pfadsegmenten zwischen Wegpunkten), die die Route bilden. Jeder Abschnitt entspricht der Fahrt zwischen zwei Nicht-via-Wegpunkten. Eine Route ohne Wegpunkte hat beispielsweise nur einen Streckenabschnitt. Eine Route mit einem Nicht-via-Wegpunkt hat zwei Streckenabschnitte. Eine Route mit einem via-Wegpunkt hat einen Streckenabschnitt. Die Reihenfolge der Streckenabschnitte entspricht der Reihenfolge der Wegpunkte von origin über intermediates bis destination.
distanceMeters

integer

Die Strecke der Route in Metern.
duration

string (Duration format)

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

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".
staticDuration

string (Duration format)

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

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".
polyline

object (Polyline)

Polylinie der gesamten Route Diese Polylinie wird dann aus allen legs kombiniert.
description

string

Eine Beschreibung der Route.
warnings[]

string

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

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 von Wegpunkten. Andernfalls ist dieses Feld leer. Angenommen, die Eingabe lautet "Origin: LA", "Fortgeschritten: Dallas, Bangor, Phoenix", "Destination: New York" und die optimierte dazwischenliegende Wegpunktreihenfolge lautet: Phoenix, Dallas, Bangor. Dieses Feld enthält dann die Werte [2, 0, 1]. Der Index beginnt für den ersten Zwischenwegpunkt mit „0“.

RouteLeg

Kapselt ein Segment zwischen Nicht-via-Wegpunkten.

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 durch das 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 Verkehrslage berechnet.

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".
staticDuration

string (Duration format)

Die Reisedauer für diesen Abschnitt, berechnet ohne Berücksichtigung der Verkehrslage.

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".
polyline

object (Polyline)

Die gesamte Polylinie für diesen Streckenabschnitt. Dazu gehört auch die Polylinie der einzelnen step.
startLocation

object (Location)

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

object (Location)

Die Endposition dieses Streckenabschnitts. Diese kann vom angegebenen destination abweichen. Wenn sich der angegebene destination beispielsweise nicht in der Nähe einer Straße befindet, ist dies ein Punkt auf der Straße.
steps[]

object (RouteLegStep)

Ein Array mit Schritten, die Segmente in diesem Abschnitt angeben. Jeder Schritt steht für eine Navigationsanweisung.
travelAdvisory

object (RouteLegTravelAdvisory)

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

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 mit dem Algorithmus für codierte Polylinien.
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. 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 Strecke dieses Schritts in Metern. Unter Umständen enthält dieses Feld keinen Wert.
staticDuration

string (Duration format)

Die Reisedauer für diesen Schritt, ohne die Verkehrslage zu berücksichtigen. Unter Umständen enthält dieses Feld keinen Wert.

Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".
polyline

object (Polyline)

Die mit diesem Schritt verknüpfte Polylinie.
startLocation

object (Location)

Der Startort 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. mögliche Einschränkungen durch eine Verkehrszone bei einem Streckenabschnitt.

RouteLegStepTravelAdvisory

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

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

object (SpeedReadingInterval)

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

Beispiel:

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

RouteLegTravelAdvisory

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

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

object (TollInfo)

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

object (SpeedReadingInterval)

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

Beispiel:

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