Eine Route Matrix-Anfrage verwendet als Eingabe ein Array von Ursprungs- und Ziel-Wegpunkten. Die Routes API berechnet dann die Route von jedem Ausgangs-Wegpunkt zu jedem Ziel-Wegpunkt. 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 Ursprungswegpunkt 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.
Mithilfe der Antwort können Sie Ihren Kunden verschiedene Routenoptionen zur Verfügung stellen 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 mit zurückgegebenen Feldern. Wenn Sie diese Liste auslassen, geben die Methoden einen Fehler zurück.
Die Beispiele in diesem Dokument zeigen das gesamte Antwortobjekt, ohne Feldmasken zu berücksichtigen. In einer Produktionsumgebung würde Ihre Antwort nur die Felder enthalten, die Sie in der Feldmaske explizit angeben.
Weitere Informationen finden Sie unter Auswählen, welche Informationen zurückgegeben werden sollen.
Informationen zum Anzeigen von Urheberrechten
Wenn Sie Ihren Nutzern die Ergebnisse anzeigen, müssen Sie die folgenden Urheberrechtshinweise 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 der eingegebenen origin- und der eingegebenen destination-Wegpunkte, die zum Berechnen der Route verwendet werden. Das bedeutet, dass sich der erste Wegpunkt (Start) und der erste Wegpunkt (Ziel) in der Anfrage im Arrayindex 0 befinden.
Eine Route in der Antwort enthält beispielsweise Folgendes:
"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 Ausgangswegpunkt an Index 4 im Eingabearray und vom Zielwegpunkt an Index 1 im Eingabearray berechnet.
Informationen zur Antwort
Das JSON-Objekt, das die API-Antwort darstellt, enthält ein Array, wobei jedes Array-Element die Route von einem Ursprungswegpunkt zu einem Zielwegpunkt 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 folgende Form:
[
// 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)
}
}
…
]