Omówienie wyszukiwania miejsc przy trasie

bookmark_border Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Funkcje wyszukiwania wzdłuż trasy są dostępne w tych interfejsach API Miejsca (Nowe):

• Wyszukiwanie tekstowe (nowa funkcja): wyszukiwanie miejsc na wstępnie zdefiniowanej trasie podróży.
• Wyszukiwanie tekstowe (nowa funkcja) i Wyszukiwanie w pobliżu (nowa funkcja): obliczanie podsumowania trasy z określonej lokalizacji początkowej do każdego miejsca w wynikach wyszukiwania.
• Tylko wyszukiwanie tekstu (nowa wersja): obliczanie podsumowania trasy dla każdego miejsca na wstępnie zdefiniowanej trasie.

Szukaj miejsc na trasie

Do obliczenia trasy podróży między dwoma lokalizacjami używasz interfejsu Routes API. Interfejs Routes API może obliczyć trasę dla samochodu, roweru, dwukołowego pojazdu, transportu publicznego lub pieszego.

Wyszukiwanie tekstowe (nowa funkcja) umożliwia korzystanie z wyliczonego wcześniej planu podróży do przeprowadzenia wyszukiwania wzdłuż trasy. W przypadku tej opcji przekazujesz z interfejsu Routes API do żądania wyszukiwania tekstowego (Nowy) wcześniej obliczoną trasę. Odpowiedź zawiera miejsca, które pasują do kryteriów wyszukiwania i znajdują się w pobliżu określonej trasy.

Wyszukiwanie wzdłuż trasy jest podobne do korzystania z opcji locationRestriction lub locationBias w żądaniu, aby wpływać na wyniki wyszukiwania. locationRestrictionzwraca wyniki wyszukiwania, które mieszczą się w ramach widocznego obszaru, a locationBias może zwracać wyniki wyszukiwania spoza widocznego obszaru. Opcje locationBias i locationRestriction umożliwiają określenie regionu, aby zawęzić wyniki wyszukiwania, ale funkcja wyszukiwania miejsc przy trasie w wyszukiwarce tekstowej pozwala też zawęzić wyniki wyszukiwania, aby obejmowały te z minimalnym czasem objazdu od początku do końca trasy. Wyniki wyszukiwania możesz kierować za pomocą funkcji locationBias lub locationRestriction w połączeniu z wielokątem.

Weź pod uwagę na przykład trasę z miejsca wyjazdu, która w interfejsie Routes API jest nazywana punktem pośrednim, do miejsca docelowego obliczonego przez ten interfejs:

Gdy wyszukujesz miejsca na trasie, wyszukiwarka zwraca miejsca znajdujące się w pobliżu trasy z minimalnym czasem dojazdu z miejsca wyjazdu do miejsca docelowego. W tym przykładzie punkty A, B i C to miejsca zwrócone przez wyszukiwanie.

Oblicz podsumowanie trasy

Wyszukiwanie tekstowe (nowa wersja) i Wyszukiwanie w pobliżu (nowa wersja) mogą obliczać podsumowanie trasy, czyli czas i odległość do każdego miejsca w odpowiedzi, na podstawie określonej w żądaniu lokalizacji miejsca docelowego. Gdy określisz punkt początkowy, odpowiedź zawiera nie tylko listę miejsc pasujących do wyszukiwania, ale też czas i odległość podróży z punktu początkowego do każdego miejsca.

Na tym obrazie punkty A, B i C to miejsca zwrócone w odpowiedzi na zapytanie:

W przypadku każdego miejsca w wynikach odpowiedź zawiera czas podróży i odległość od punktu początkowego do miejsca docelowego (jeśli jest dostępna).

Domyślnie czas i odległość podróży są obliczane na podstawie opcji TRAFFIC_UNAWARE w interfejsie Routes API. Opcjonalnie możesz ustawić preferencje trasowania, aby uwzględnić w obliczeniach warunki ruchu na żywo TRAFFIC_AWARE_OPTIMAL lub warunki ruchu na żywo z obniżeniem opóźnienia TRAFFIC_AWARE.

Informacje o trasach, odcinkach i punktach pośrednich

Trasa składa się z kilku komponentów obliczanych przez interfejs Routes API:

Trasa składa się z tych komponentów:

• Punkt pośredni: aby obliczyć trasę, należy podać co najmniej miejsca docelowe i początkowe. Te lokalizacje określasz jako punkty pośrednie na trasie. Punkty pośrednie to lokalizacje między miejscem wyjazdu a miejscem docelowym, przez które ma przebiegać trasa.

• Trasa: cała podróż od punktu początkowego do punktu docelowego, przez wszystkie punkty pośrednie. Trasa składa się z co najmniej 1 odcinka.

  Przekazując trasę do wyszukiwania tekstowego, przekazujesz zakodowaną linię łamaną trasy zwróconą przez interfejs API Trasy. Zakodowana linia łamana to zakodowana lista punktów szerokości i długości geograficznej, która umożliwia reprezentowanie linii łamanej trasy jako ciągu znaków.

• Odcinek: ścieżka od jednego punktu drogi do następnego punktu drogi. Każdy odcinek składa się z co najmniej 1 odrębnego etapu.

  Trasa zawiera osobny odcinek dla ścieżki od każdego punktu pośredniego do następnego. Jeśli np. trasa zawiera jeden punkt początkowy i jeden punkt docelowy, to zawiera tylko jeden etap.

  W przypadku każdego dodatkowego punktu kontrolnego dodanego do trasy po punkcie początkowym i docelowym, zwanego punktem pośrednim, interfejs API dodaje osobny odcinek.

Więcej informacji o trasach i ich obliczaniu znajdziesz w interfejsie API Tras.

Oblicz podsumowanie trasy z wyszukiwaniem na trasie

Obliczenia podsumowania trasy możesz połączyć z wyszukiwaniem na trasie. W tym przypadku zapytanie Text Search (New) zwraca czas trwania podróży i odległość do każdego miejsca w odpowiedzi, a potem od każdego miejsca do miejsca docelowego na trasie. Wyobraź sobie, że to obliczenie zapewnia czas i odległość podróży, jeśli z wybranego szlaku zboczysz, aby dotrzeć do miejsca w wynikach wyszukiwania, a potem kontynuujesz podróż do miejsca docelowego.

Weźmy na przykład trasę z miejsca wylotu do miejsca docelowego obliczoną przez interfejs Routes API. Przekaż tę ścieżkę do interfejsu API wyszukiwania tekstowego (nowego) wraz z kryteriami wyszukiwania.

W tym przykładzie lokalizacja A to miejsce zwrócone w wynikach wyszukiwania z tekstu „Wyszukiwanie (nowa wersja)”. W przypadku każdego miejsca w odpowiedzi wyszukiwanie obejmuje czas i odległość potrzebną na dojazd do tego miejsca jako podróż w 2 etapach:

• Pierwszy etap zawiera czas i odległość podróży od miejsca docelowego do miejsca wyjazdu. W tym przykładzie od punktu początkowego do miejsca A.
• Drugi etap zawiera czas i odległość podróży od miejsca do miejsca docelowego. W tym przykładzie: z A do miejsca docelowego.

Na podstawie informacji w odpowiedzi możesz obliczyć czas i odległość objazdu, gdzie:

• $t_{OD}$ to czas trwania podróży z miejsca wyjazdu do miejsca docelowego, $s_{OD}$ to odległość z miejsca wyjazdu do miejsca docelowego.
• $t_{OA}$ to czas trwania podróży z miejsca wyjazdu do A; $s_{OA}$ to odległość z miejsca wyjazdu do A
• $t_{AD}$ to czas trwania podróży z A do miejsca docelowego; $s_{AD}$ to odległość od A do miejsca docelowego.

Czas objazdu to różnica w czasie między pierwotną podróżą (od punktu początkowego do punktu docelowego) a nową podróżą (od punktu początkowego do punktu docelowego przez A):

Odległość objazdu to różnica odległości między pierwotną podróżą (od miejsca wylotu do miejsca docelowego) a nową podróżą (od miejsca wylotu do miejsca docelowego przez A):