Routenmatrix-Antwort ansehen

Eine Route Matrix-Anfrage verwendet ein Array von Start- und Zielwegpunkten als Eingabe. 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, in dem jedes Arrayelement der Route von einem Start- 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 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 gezeigt. 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.

Urheberrechtshinweise 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 Attribute enthalten den nullbasierten Index der Wegpunkte für den Startort und das Ziel, die zur Berechnung der Route verwendet werden. Das bedeutet, dass der erste Wegpunkt des Startorts und der erste Wegpunkt des Zielorts in der Anfrage den Array-Index 0 haben.

Eine Route in der Antwort enthält beispielsweise Folgendes:

"originIndex": 1,
"destinationIndex": 0

Diese Properties geben an, dass die Route vom Ausgangswegpunkt bei Index 1 im Eingabearray und vom Zielwegpunkt bei Index 0 berechnet wurde.

Für die nächste Route:

"originIndex": 4,
"destinationIndex": 1

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

Routeninformationen 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 Attributen originIndex und destinationIndex enthält jedes Element nur grundlegende Informationen, die für diese Route spezifisch sind, z. B. distanceMeters, duration und travelAdvisory. Wenn Sie detailliertere Informationen zu einer Route erhalten möchten, z. B. eine Polylinie, 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)
    }
  }
  …
]