Żądanie macierzy tras przyjmuje jako dane wejściowe tablicę punktów pośrednich miejsca wyjazdu i miejsca docelowego. Następnie interfejs Routes API oblicza trasę od każdego punktu pośredniego miejsca wyjazdu do każdego punktu pośredniego miejsca docelowego. Jeśli na przykład określisz 2 punkty początkowe i 2 punkty docelowe, interfejs API obliczy 4 oddzielne trasy.
Odpowiedź interfejsu API zawiera tablicę, w której każdy element odpowiada trasie z jednego punktu początkowego do jednego punktu docelowego. Jeśli więc określisz 2 punkty początkowe i 2 punkty docelowe, tablica odpowiedzi będzie zawierać 4 elementy, po jednym dla każdej obliczonej trasy.
Na podstawie odpowiedzi możesz udostępnić klientom różne opcje tras, 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, które pola 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 sekcji Wybieranie informacji do zwrócenia.
Informacje o wyświetlaniu praw 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
Identyfikowanie trasy w odpowiedzi
Aby zidentyfikować każdą trasę w odpowiedzi, użyj właściwości odpowiedzi originIndex i destinationIndex. Te właściwości zawierają indeks liczony od zera wejściowych punktów orientacyjnych początku i miejsca docelowego użytych do obliczenia trasy. Oznacza to, że pierwszy punkt pośredni miejsca rozpoczęcia i pierwszy punkt pośredni miejsca docelowego w żądaniu mają indeks tablicy 0.
Na przykład trasa w odpowiedzi zawiera:
"originIndex": 1, "destinationIndex": 0
Te właściwości wskazują, że trasa została obliczona od punktu początkowego o indeksie 1 w tablicy wejściowej i do punktu docelowego o indeksie 0.
W przypadku następnej trasy:
"originIndex": 4, "destinationIndex": 1
Trasa została obliczona od punktu pośredniego miejsca wyjazdu o indeksie 4 w tablicy wejściowej i do 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 początkowego do jednego punktu 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 taką 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) } } … ]