Routenmatrix-Antwort ansehen

Eine Route Matrix-Anfrage akzeptiert als Eingabe ein Array mit Start- und Zielort. Wegpunkte. Die Routes API berechnet dann die Route für jeden Startpunkt. zum jeweiligen Zielwegpunkt. Wenn Sie z. B. zwei Startorte angeben, zwei Wegpunkte angeben, berechnet das API vier separate Routen planen.

Die API-Antwort enthält ein Array, wobei jedes Arrayelement dem Route von einem Ursprungswegpunkt zu einem Zielwegpunkt. Wenn Sie also zwei Ausgangs-Wegpunkte und zwei Ziel-Wegpunkte angeben, wird mit dem Antwortarray enthält vier Elemente, eines für jede berechnete Route.

Mithilfe der Antwort können Sie Ihren Kunden verschiedene Routenoptionen zur Verfügung stellen. und lassen Sie den Nutzer dann die passende Route für seine Anforderungen auswählen.

Feldmasken

Wenn Sie eine Methode zum Berechnen einer Route aufrufen, müssen Sie ein Feld angeben -Maske, die definiert, welche Felder in der Antwort zurückgegeben werden sollen. Es gibt keine Standardliste zurückgegebener Felder. Wenn Sie diese Liste auslassen, geben die Methoden ein Fehler.

Die Beispiele in diesem Dokument zeigen das gesamte Antwortobjekt, Feldmasken berücksichtigt. In einer Produktionsumgebung würde Ihre Antwort enthalten nur die Felder, 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 Antworteigenschaften originIndex und destinationIndex, um jeder Route in der Antwort. Diese Eigenschaften enthalten den nullbasierten Index der eingegebenen Wegpunkte Start und Ziel, die zum Berechnen der Route verwendet werden. Das bedeutet, dass der erste Wegpunkt (Start) und der erste Wegpunkt (Ziel) in der Anfrage beim Array-Index 0 liegen.

Eine Route in der Antwort enthält beispielsweise Folgendes:

"originIndex": 1,
"destinationIndex": 0

Diese Eigenschaften geben an, dass die Route vom Startpunkt aus berechnet wurde. Wegpunkt an Index 1 im Eingabearray und vom Zielwegpunkt an Index 0.

Für die nächste Route:

"originIndex": 4,
"destinationIndex": 1

Die Route wurde vom Ursprungswegpunkt an Index 4 in der Eingabe berechnet Array und vom Zielwegpunkt an Index 1 im Eingabearray.

Informationen zur Antwort

Die JSON-Objekt die die API-Antwort darstellt, ein Array enthält, wobei jedes Array-Element definiert die Route von einem Ursprungswegpunkt zu einem Zielwegpunkt.

Zusammen mit den Eigenschaften originIndex und destinationIndex gibt jede Route Informationen speziell für diese Route enthält, 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)
    }
  }
  …
]