Routenmatrix-Antwort ansehen

Für eine Routenmatrixanfrage ist ein Array von Start- und Ziel-Waypoints erforderlich. Die Routes API berechnet dann die Route von jedem Start-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, in dem jedes Arrayelement der Route von einem Start- zu einem Zielwegpunkt entspricht. Wenn Sie also zwei Wegpunkte für den Startort und zwei Wegpunkte für den Zielort 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 den Nutzer dann die für seine Anforderungen passende 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 explizit in der Feldmaske angeben.

Weitere Informationen finden Sie unter Auswählen, welche Informationen zurückgegeben werden sollen.

Urheberrechtsangaben anzeigen

Wenn Sie die Ergebnisse Ihren Nutzern anzeigen, müssen Sie die folgende Urheberrechtserklärung einfügen:

Powered by Google, ©YEAR Google

Beispiel:

Powered by Google, ©2023 Google

Route in der Antwort identifizieren

Verwenden Sie die Antwort-Properties originIndex und destinationIndex, um die einzelnen Routen in der Antwort zu identifizieren. Diese Eigenschaften enthalten den nullbasierten Index der Wegpunkte für den Startort und das Ziel, die zur Berechnung der Route verwendet werden. Das bedeutet, dass sich der erste Wegpunkt für den Startort und der erste Wegpunkt für den Zielort in der Anfrage am Arrayindex 0 befinden.

Beispiel: Eine Route in der Antwort enthält:

"originIndex": 1,
"destinationIndex": 0

Diese Eigenschaften geben an, dass die Route vom Start-Wegpunkt mit dem Index 1 im Eingabearray und vom Ziel-Wegpunkt mit dem Index 0 berechnet wurde.

Für die nächste Route:

"originIndex": 4,
"destinationIndex": 1

Die Route wurde vom Ausgangswegpunkt bei Index 4 im Eingabearray und vom Zielwegpunkt bei Index 1 im Eingabearray berechnet.

Informationen zur Route in der Antwort

Die API-Antwort enthält ein Array, in dem jedes Arrayelement die Route von einem Start- zu einem Zielwegpunkt definiert. Diese Elemente sind RouteMatrixElements in der gRPC-Methode oder im Antworttext in der HTTP-Antwort.

Neben den Eigenschaften originIndex und destinationIndex enthält jedes Element nur grundlegende Informationen, die für die jeweilige Route spezifisch sind, z. B. distanceMeters, duration und travelAdvisory. Wenn Sie detailliertere Informationen zu einer Route, z. B. eine Polylinie, abrufen möchten, verwenden Sie computeRoutes.

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)
    }
  }
  …
]