Omówienie wyszukiwania miejsc przy trasie

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

• 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 2 miejscami 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 prośbach, aby wpływać na wyniki wyszukiwania. locationRestrictionzwraca wyniki wyszukiwania, które mieszczą się w ramach widocznego obszaru, podczas gdy 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. Możesz wpływać na wyniki wyszukiwania, używając 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ć podczas obliczeń 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:

• Waypoint 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 jednego punktu pośredniego do następnego. Jeśli np. trasa zawiera 1 punkt początkowy i 1 punkt docelowy, to zawiera 1 etap.

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

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

Oblicz podsumowanie routingu 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 docelowego w wynikach wyszukiwania, a następnie 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 w sekcji Tekstowe wyszukiwanie (nowa). 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 punktu A; \(s_{OA}\) to odległość z miejsca wyjazdu do punktu 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):