Sprawdź odpowiedź macierzy macierzy

Żądanie macierzy tras przyjmuje jako dane wejściowe tablicę punktów pośrednich miejsca wyjazdu i miejsca docelowego. Interfejs Routes API oblicza następnie trasę z każdego punktu pośredniego miejsca wyjazdu do każdego punktu pośredniego miejsca docelowego. Jeśli na przykład określisz 2 punkty pośrednie miejsca wyjazdu i 2 punkty pośrednie miejsca docelowego, interfejs API obliczy 4 oddzielne trasy.

Odpowiedź interfejsu API zawiera tablicę, w której każdy element odpowiada trasie z jednego punktu pośredniego miejsca wyjazdu do jednego punktu pośredniego miejsca docelowego. Jeśli więc określisz 2 punkty pośrednie miejsca wyjazdu i 2 punkty pośrednie miejsca docelowego, tablica odpowiedzi będzie zawierać 4 elementy – po jednym dla każdej obliczonej trasy.

Korzystając z odpowiedzi, możesz udostępnić klientom różne opcje trasy, a następnie pozwolić im wybrać trasę odpowiednią do ich potrzeb.

Maski pól

Gdy wywołujesz metodę obliczania trasy, musisz określić maskę pola, która definiuje pola, które mają być zwracane w odpowiedzi. Nie ma domyślnej listy zwracanych 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 masek pól. W środowisku produkcyjnym odpowiedź będzie zawierać tylko pola, które zostały wyraźnie określone w masce pola.

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

Wyświetlanie informacji o prawach autorskich

Gdy wyświetlasz wyniki użytkownikom, musisz podać to oświadczenie o prawach autorskich:

Powered by Google, ©YEAR Google

Na przykład:

Powered by Google, ©2023 Google

Określanie trasy w odpowiedzi

Aby określić każdą trasę w odpowiedzi, użyj właściwości odpowiedzi originIndex i destinationIndex. Te właściwości zawierają liczony od zera indeks wejściowych punktów pośrednich miejsca wyjazdu i miejsca docelowego użytych do obliczenia trasy. Oznacza to, że pierwszy punkt pośredni miejsca wyjazdu i pierwszy punkt pośredni miejsca docelowego w żądaniu znajdują się pod indeksem 0 w tablicy.

Na przykład trasa w odpowiedzi zawiera:

"originIndex": 1,
"destinationIndex": 0

Te właściwości wskazują, że trasa została obliczona na podstawie punktu pośredniego miejsca wyjazdu o indeksie 1 w tablicy wejściowej oraz punktu pośredniego miejsca docelowego o indeksie 0.

W przypadku następnej trasy:

"originIndex": 4,
"destinationIndex": 1

Trasa została obliczona na podstawie punktu pośredniego miejsca wyjazdu o indeksie 4 w tablicy wejściowej oraz punktu pośredniego miejsca docelowego o indeksie 1 w tablicy wejściowej.

Informacje o trasie w odpowiedzi

Odpowiedź interfejsu API zawiera tablicę, w której każdy element definiuje trasę z jednego punktu pośredniego miejsca wyjazdu do jednego punktu pośredniego miejsca docelowego. Te elementy to RouteMatrixElements w metodzie gRPC lub treść odpowiedzi w odpowiedzi HTTP.

Oprócz właściwości originIndex i destinationIndex każdy element zawiera tylko podstawowe informacje dotyczące danej trasy, takie jak distanceMeters, duration i travelAdvisory. Aby uzyskać bardziej szczegółowe informacje o trasie, np. linię łamaną, użyj computeRoutes.

Odpowiedź ma postać:

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