Bei einer Routenmatrixanfrage wird ein Array mit Start- und Zielwegpunkten als Eingabe verwendet. Die Routes API berechnet dann die Route von jedem Startwegpunkt 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 Array-Element 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.
Anhand der Antwort können Sie Ihren Kunden verschiedene Routenoptionen anbieten und sie dann die passende Route für ihre Anforderungen 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 gezeigt. In einer Produktionsumgebung enthält die Antwort nur die Felder, die Sie explizit in der Feldmaske angeben.
Weitere Informationen finden Sie unter Auszuwählende Informationen.
Urheberrechtsvermerke anzeigen
Sie müssen die folgende Urheberrechtserklärung einfügen, wenn Sie Ihren Nutzern die Ergebnisse präsentieren:
Powered by Google, ©YEAR Google
Beispiel:
Powered by Google, ©2023 Google
Route in der Antwort identifizieren
Verwenden Sie die Antwortattribute originIndex und destinationIndex, um jede Route in der Antwort zu identifizieren. Diese Attribute enthalten den nullbasierten Index der Start - und Zielwegpunkte , die zum Berechnen der Route verwendet wurden. Das bedeutet, dass sich der erste Startwegpunkt und der erste Zielwegpunkt in der Anfrage an Array-Index 0 befinden.
Beispiel: Eine Route in der Antwort enthält:
"originIndex": 1, "destinationIndex": 0
Diese Attribute geben an, dass die Route vom Startwegpunkt mit dem Index 1 im Eingabearray und vom Zielwegpunkt mit dem Index 0 berechnet wurde.
Für die nächste Route:
"originIndex": 4, "destinationIndex": 1
Die Route wurde vom Startwegpunkt mit dem Index 4 im Eingabearray und vom Zielwegpunkt mit dem Index 1 im Eingabearray berechnet.
Antwort
Das JSON-Objekt , das die API-Antwort darstellt, enthält ein Array, wobei jedes Array-Element die Route von einem Startwegpunkt zu einem Zielwegpunkt definiert.
Neben den Attributen originIndex und destinationIndex enthält jede Route Informationen, die speziell für diese Route gelten, 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) } } … ]