Eine Routenmatrixanfrage nimmt ein Array von Start- und Ziel-Wegpunkten als Eingabe an. Die Routes API berechnet dann die Route von jedem Start- zu jedem Zielwegpunkt. Wenn Sie beispielsweise zwei Start- und zwei Zielwegpunkte angeben, berechnet die API vier separate Routen.
Die API-Antwort enthält ein Array, wobei jedes Arrayelement der Route von einem Start- zu einem Zielwegpunkt entspricht. Wenn Sie also zwei Start- und zwei Zielwegpunkte angeben, enthält das Antwortarray vier Elemente, eines für jede berechnete Route.
Mit der Antwort können Sie Ihren Kunden verschiedene Routenoptionen anbieten und sie dann die für ihre Anforderungen geeignete Route auswählen lassen.
Feldmasken
Wenn Sie eine Methode zum Berechnen einer Route aufrufen, müssen Sie eine Feldmaske angeben, die festlegt, welche Felder in der Antwort zurückgegeben werden sollen. Es gibt keine Standardliste der zurückgegebenen Felder. Wenn Sie diese Liste weglassen, geben die Methoden einen Fehler zurück.
In den Beispielen in diesem Dokument wird das gesamte Antwortobjekt ohne Berücksichtigung von Feldmasken dargestellt. In einer Produktionsumgebung enthält die Antwort nur die Felder, die Sie in der Feldmaske explizit angeben.
Weitere Informationen finden Sie unter Zurückzugebende Informationen auswählen.
Urheberrechtshinweise anzeigen
Wenn Sie den Nutzern die Ergebnisse anzeigen, müssen Sie die folgende Urheberrechtserklärung hinzufügen:
Powered by Google, ©YEAR Google
Beispiel:
Powered by Google, ©2023 Google
Route in der Antwort identifizieren
Verwenden Sie die Antworteigenschaften originIndex und destinationIndex, um jede Route in der Antwort zu identifizieren. Diese Eigenschaften enthalten den nullbasierten Index der eingegebenen Wegpunkte Start und Ziel, die zur Berechnung der Route verwendet werden. Das bedeutet, dass sich der erste Start- und Zielpunkt in der Anfrage am Arrayindex 0 befinden.
Eine Route in der Antwort enthält beispielsweise:
"originIndex": 1, "destinationIndex": 0
Diese Eigenschaften geben an, dass die Route vom Startpunkt (Index 1 im Eingabearray) und vom Zielpunkt (Index 0) berechnet wurde.
Für die nächste Route:
"originIndex": 4, "destinationIndex": 1
Die Route wurde vom Startpunkt mit dem Index 4 im Eingabearray und vom Zielpunkt mit dem Index 1 im Eingabearray berechnet.
Antwort
Das JSON-Objekt, das die API-Antwort darstellt, enthält ein Array, in dem jedes Arrayelement die Route von einem Start- zu einem Ziel-Wegpunkt definiert.
Neben den Properties originIndex und destinationIndex enthält jede Route spezifische Informationen, z. B. distanceMeters, duration und travelAdvisory.
Die Antwort hat folgendes Format:
[
// One array element for each combination of origin and destination waypoints.
{
// The route for source waypoint 0 and destination waypoint 0.
"originIndex": 0,
"destinationIndex": 0,
"status": {
object (Status)
},
"condition": enum (RouteMatrixElementCondition),
"distanceMeters": integer,
"duration": string,
"staticDuration": string,
"travelAdvisory": {
object (RouteTravelAdvisory)
},
"fallbackInfo": {
object (FallbackInfo)
}
}
{
// The route for source waypoint 0 and destination waypoint 1.
"originIndex": 0,
"destinationIndex": 1,
"status": {
object (Status)
},
"condition": enum (RouteMatrixElementCondition),
"distanceMeters": integer,
"duration": string,
"staticDuration": string,
"travelAdvisory": {
object (RouteTravelAdvisory)
},
"fallbackInfo": {
object (FallbackInfo)
}
}
…
]