Eine Route Matrix-Anfrage verwendet als Eingabe ein Array von Ursprungs- und Ziel-Wegpunkten. 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 Startwegpunkt 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 definiert, 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 würde Ihre Antwort nur die Felder enthalten, die Sie in der Feldmaske explizit angeben.
Weitere Informationen finden Sie unter Zurückzugebende Informationen auswählen.
Urheberrechtshinweise
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 Attribute geben an, dass die Route vom Ausgangswegpunkt an Index 1 im Eingabearray und vom Zielwegpunkt an 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.
Zusammen mit den Attributen originIndex und destinationIndex enthält jede Route spezifische Informationen für diese Route, 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)
}
}
…
]