Żądanie macierzy tras przyjmuje jako dane wejściowe tablicę punktów początkowych i docelowych. Interfejs Routes API oblicza następnie trasę od każdego punktu kontrolnego źródła do każdego punktu kontrolnego miejsca docelowego. Jeśli na przykład określisz 2 punkty kontrolne źródła i 2 punkty kontrolne miejsca docelowego, interfejs API obliczy 4 osobne trasy.
Odpowiedź interfejsu API zawiera tablicę, w której każdy element odpowiada trasie od jednego punktu docelowego do drugiego. Dlatego jeśli określisz 2 punkty kontrolne źródła i 2 punkty kontrolne docelowe, tablica odpowiedzi będzie zawierać 4 elementy, po jednym dla każdej obliczonej trasy.
Dzięki odpowiedzi możesz udostępnić klientom różne opcje trasy, a następnie pozwolić użytkownikowi wybrać odpowiednią trasę.
Informacje o maskach pól
Gdy wywołujesz metodę obliczania trasy, musisz podać maskę pól, która określa, które pola mają być 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, 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
Wyświetlając wyniki użytkownikom, musisz uwzględnić to oświadczenie o prawach autorskich:
Powered by Google, ©YEAR Google
Na przykład:
Powered by Google, ©2023 Google
Określanie trasy w odpowiedzi
Użyj właściwości odpowiedzi originIndex i destinationIndex, aby zidentyfikować każdą trasę w odpowiedzi. Właściwości te zawierają zerowy indeks danych wejściowych pochodzenia i danych wejściowych miejsca docelowegopunktów pośrednich używanych do obliczania trasy. Oznacza to, że pierwszy punkt kontrolny miejsca odjazdu i pierwszy punkt kontrolny miejsca docelowego w żądaniu znajdują się pod indeksem 0 tablicy.
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 oraz docelowego punktu pośredniego o indeksie 0.
Na następnej trasie:
"originIndex": 4, "destinationIndex": 1
Trasa została obliczona na podstawie punktu kontrolnego źródła o indeksie 4 w tablicy danych wejściowych oraz punktu kontrolnego miejsca docelowego o indeksie 1 w tablicy danych wejściowych.
Informacje o odpowiedzi
Obiekt JSON reprezentujący odpowiedź interfejsu API zawiera tablicę, w której każdy element tablicy definiuje trasę od jednego punktu kontrolnego źródła do jednego punktu kontrolnego docelowego.
Oprócz właściwości originIndex i destinationIndex każda trasa zawiera związane z nią informacje, np. 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)
}
}
…
]