Żądanie macierzy tras przyjmuje jako dane wejściowe tablicę punktów początkowych i docelowych. Interfejs Routes API oblicza następnie trasę z każdego punktu początkowego do każdego docelowego punktu. Jeśli np. określisz 2 punkty pośrednie i 2 docelowe punkty na trasie, interfejs API obliczy 4 osobne trasy.
Odpowiedź interfejsu API zawiera tablicę, w której każdy element tablicy odpowiada trasie z jednego punktu początkowego do jednego docelowego. Jeśli więc zdefiniujesz 2 początkowe punkty na trasie i 2 docelowe punkty na trasie, tablica odpowiedzi będzie zawierać 4 elementy, po jednym dla każdej obliczonej trasy.
Dzięki tej odpowiedzi możesz podać klientom różne opcje trasy, a potem pozwolić użytkownikom wybrać tę, która najbardziej odpowiada ich potrzebom.
Informacje o maskach pól
Gdy wywołujesz metodę służącą do obliczenia trasy, musisz określić maskę pola określającą pola, które mają zostać zwrócone 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 wyraźnie określone w masce pól.
Więcej informacji znajdziesz w sekcji Wybieranie informacji do zwrócenia.
Informacje o wyświetlaniu praw autorskich
Wyświetlając wyniki użytkownikom, musisz dołączyć do listy 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
do identyfikacji poszczególnych tras w odpowiedzi. Te właściwości zawierają indeks liczony od zera wejściowego źródła oraz wejściowe punkty pośrednie docelowe używane do obliczenia trasy. Oznacza to, że pierwszy punkt pośredni i pierwszy docelowy punkt na trasie 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 w indeksie 1 w tablicy wejściowej i docelowego punktu pośredniego o indeksie 0.
W przypadku następnej trasy:
"originIndex": 4, "destinationIndex": 1
Trasa została obliczona na podstawie początkowego punktu pośredniego w indeksie 4 na tablicy wejściowej i docelowego punktu pośredniego w indeksie 1 w tablicy wejściowej.
Informacje o odpowiedzi
Obiekt JSON reprezentujący odpowiedź interfejsu API zawiera tablicę, w której każdy element tablicy definiuje trasę z jednego punktu początkowego do jednego docelowego.
Każda trasa oprócz właściwości originIndex
i destinationIndex
zawiera informacje związane z tą trasą, np. distanceMeters
, duration
i travelAdvisory
.
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) } } … ]