Eine Route Matrix-Anfrage verwendet als Eingabe ein Array von Start- und Ziel-Wegpunkten. Die Routes API berechnet dann die Route von jedem Start- zu jedem Ziel-Wegpunkt. Wenn Sie beispielsweise zwei Start- und zwei Ziel-Wegpunkte angeben, berechnet die API vier separate Routen.
Die API-Antwort enthält ein Array, wobei jedes Array-Element der Route von einem Ausgangs-Wegpunkt zu einem Ziel-Wegpunkt entspricht. Wenn Sie also zwei Start-Wegpunkte und zwei Ziel-Wegpunkte angeben, enthält das Antwortarray vier Elemente, eines für jede berechnete Route.
Mithilfe der Antwort kannst du deinen Kunden verschiedene Routenoptionen anbieten und sie dann entscheiden lassen, welche Route für sie am besten geeignet ist.
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 auslassen, geben die Methoden einen Fehler zurück.
Die Beispiele in diesem Dokument zeigen das gesamte Antwortobjekt ohne Berücksichtigung von Feldmasken. In einer Produktionsumgebung würde Ihre Antwort nur die Felder enthalten, die Sie explizit in der Feldmaske angeben.
Weitere Informationen finden Sie unter Auswählen, welche Informationen zurückgegeben werden sollen.
Informationen zum Anzeigen von Urheberrechten
Beim Anzeigen der Ergebnisse für Ihre Nutzer müssen Sie die folgende Urheberrechtserklärung angeben:
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 des Eingabe-origin und der Eingabe-destination-Wegpunkte, die zur Berechnung der Route verwendet werden. Das bedeutet, dass sich der erste Start-Wegpunkt und der erste Ziel-Wegpunkt in der Anfrage am Array-Index 0 befinden.
Eine Route in der Antwort enthält beispielsweise Folgendes:
"originIndex": 1, "destinationIndex": 0
Diese Attribute geben an, dass die Route vom Ausgangs-Wegpunkt bei Index 1 im Eingabearray und vom Ziel-Wegpunkt an Index 0 berechnet wurde.
Für die nächste Route:
"originIndex": 4, "destinationIndex": 1
Die Route wurde ausgehend vom Ausgangs-Wegpunkt bei Index 4 im Eingabearray und vom Ziel-Wegpunkt bei Index 1 im Eingabearray berechnet.
Informationen zur Antwort
Das JSON-Objekt, das die API-Antwort darstellt, enthält ein Array, in dem jedes Arrayelement die Route von einem Ursprungs-Wegpunkt zu einem Ziel-Wegpunkt definiert.
Neben den Attributen originIndex und destinationIndex enthält jede Route spezifische Informationen zur jeweiligen Route, z. B. distanceMeters, duration und travelAdvisory.
Die Antwort hat das folgende 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)
}
}
…
]