Sprawdź odpowiedź macierzy macierzy

Żądanie macierzy tras przyjmuje jako dane wejściowe tablicę punktu początkowego i docelowego punkty pośrednie. Interfejs Routes API oblicza następnie trasę z każdego punktu początkowego do każdego docelowego punktu na trasie. Na przykład, jeśli podasz 2 pochodzenie punkty pośrednie i dwa docelowe punkty pośrednie, interfejs API oblicza następnie trasy.

Odpowiedź interfejsu API zawiera tablicę, w której każdy jej element odpowiada funkcji na trasie z jednego punktu początkowego do jednego docelowego punktu. Dlatego, jeśli określić dwa punkty pośrednie początkowe i dwa docelowe punkty pośrednie, tablica odpowiedzi zawiera cztery elementy, po jednym na każdą obliczoną trasę.

Korzystając z odpowiedzi, możesz podać klientom różne opcje trasy a następnie pozwolić użytkownikowi wybrać trasę, która będzie mu odpowiadać.

Informacje o maskach pól

Gdy wywołujesz metodę do obliczenia trasy, musisz podać pole określającą pola, które mają być zwracane w odpowiedzi. Brak domyślnej listy zwróconych pól. Jeśli pominiesz tę listę, metody zwrócą błąd .

Przykłady w tym dokumencie pokazują cały obiekt odpowiedzi bez uwzględniania maski pól. W środowisku produkcyjnym odpowiedź będzie zawierać tylko pola, które wyraźnie określisz w masce.

Więcej informacji znajdziesz w sekcji Wybieranie informacji do zwrócenia.

Wyświetlanie informacji o prawach autorskich

Podczas wyświetlania wyników użytkownikom musisz dołączyć to oświadczenie o prawach autorskich:

Powered by Google, ©YEAR Google

Na przykład:

Powered by Google, ©2023 Google

Określ trasę w odpowiedzi

Użyj właściwości odpowiedzi originIndex i destinationIndex, by zidentyfikować w odpowiedzi na każdą trasę. Te właściwości zawierają indeks liczony od zera: dane wejściowe origin i miejsca docelowego destination, używane do obliczania . Oznacza to, że pierwszy punkt początkowy i pierwszy docelowy punkt pośredni w żądaniu mają indeks tablicy 0.

Na przykład trasa w odpowiedzi zawiera:

"originIndex": 1,
"destinationIndex": 0

Właściwości te wskazują, że trasa została obliczona na podstawie punktu początkowego punkt pośredni w indeksie 1 w tablicy wejściowej oraz z docelowego punktu pośredniego w indeks 0.

Na następnej trasie:

"originIndex": 4,
"destinationIndex": 1

Trasa została obliczona na podstawie punktu początkowego w indeksie 4 w danych wejściowych i od docelowego punktu pośredniego w indeksie 1 w tablicy wejściowej.

Informacje o odpowiedzi

Obiekt JSON reprezentująca odpowiedź interfejsu API zawiera tablicę, w której każdy element tablicy określa trasę z jednego punktu początkowego do jednego docelowego punktu.

Każda trasa wraz z właściwościami originIndex i destinationIndex zawiera informacje dotyczące tej trasy, takie jak distanceMeters, duration i travelAdvisory.

Odpowiedź ma taki 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)
    }
  }
  …
]