Routenmatrix-Antwort ansehen

Für eine Anfrage für eine Routenmatrix ist ein Array von Start- und Ziel-Waypoints erforderlich. 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 Startwegpunkte 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 den Nutzer dann die für seine 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 dargestellt. In einer Produktionsumgebung würde Ihre Antwort nur die Felder enthalten, die Sie explizit in der Feldmaske angeben.

Weitere Informationen finden Sie unter Zurückzugebende Informationen auswählen.

Urheberrechtsvermerke anzeigen

Wenn Sie die Ergebnisse Ihren Nutzern präsentieren, 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 Antwort-Properties originIndex und destinationIndex, um die einzelnen Routen in der Antwort zu identifizieren. Diese Eigenschaften enthalten den nullbasierten Index der Start- und Ziel-Wegpunkte, die zum Berechnen der Route verwendet wurden. Das bedeutet, dass sich der erste Start- und der erste Ziel-Waypoint in der Anfrage am Array-Index 0 befinden.

Eine Route in der Antwort enthält beispielsweise:

"originIndex": 1,
"destinationIndex": 0

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

Für die nächste Route:

"originIndex": 4,
"destinationIndex": 1

Die Route wurde vom Start-Waypoint mit dem Index 4 im Eingabearray und vom Ziel-Waypoint mit dem Index 1 im Eingabearray berechnet.

Über die Antwort

Das JSON-Objekt, das die API-Antwort darstellt, enthält ein Array, in dem jedes Array-Element die Route von einem Ursprungs-Waypoint zu einem Ziel-Waypoint definiert.

Neben den Attributen originIndex und destinationIndex enthält jede Route spezifische Informationen wie 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)
    }
  }
  …
]