Wyszukiwanie na trasie – omówienie
Funkcje wyszukiwania wzdłuż trasy są dostępne w tych (nowych) interfejsach API Miejsc:
- 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, systemu transportu publicznego lub pieszego.
Wyszukiwanie tekstowe (nowość) pozwala użyć tej obliczonej trasy do wykonania wyszukiwać wzdłuż trasy. W przypadku tej opcji przekazujesz do żądania wyszukiwania tekstowego (nowa wersja) z interfejsu Routes API 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. locationRestriction
zwraca wyniki wyszukiwania, które znajdują się w granicach widocznego obszaru,
locationBias może zwracać wyniki wyszukiwania poza widocznym obszarem. 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 wyniki, które mają minimalny czas objazdu od początku do końca trasy. Możesz stronnić wyniki wyszukiwania za pomocą
locationBias lub locationRestriction w połączeniu z linią łamaną.
Weźmy na przykład trasę z punktu początkowego, nazywaną waypoint w interfejsie Routes API do miejsca docelowego obliczonego przez Interfejs API:
Podczas wyszukiwania wzdłuż trasy wyszukiwanie jest stronnicze, aby zwrócić miejsca w pobliżu trasę z minimalnym czasem objazdu od punktu początkowego do miejsca docelowego. W tym przykładzie punkty A, B i C to miejsca zwrócone przez wyszukiwanie.
Oblicz podsumowanie tras
Wyszukiwanie tekstowe (nowość) i Wyszukiwanie w pobliżu (nowość) mogą obliczać podsumowanie trasy, czyli czas trwania i dystans, do każdego miejsce w odpowiedzi na podstawie określonej lokalizacji punktu początkowego w parametrze użytkownika. 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 routingu, aby umożliwić
aktualne warunki na drodze TRAFFIC_AWARE_OPTIMAL
lub warunki ruchu w czasie rzeczywistym o skróceniu czasu oczekiwania TRAFFIC_AWARE
brane pod uwagę podczas obliczeń.
Informacje o trasach, nogach 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. Określasz te lokalizacje jako punkty pośrednie na trasę. Pośrednie punkty pośrednie to lokalizacje pomiędzy miejscem początkowym a punktem początkowym miejsce docelowe, przez które ma przejść 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ą trasę linia łamana zwracana przez interfejs Routes API. Zakodowany linia łamana to zakodowana lista punktów szerokości i długości geograficznej, która pozwala przedstawić linii łamanej trasy.
-
Odcinek: ścieżka od jednego punktu drogi do następnego punktu drogi. Każda noga składa się z co najmniej 1 oddzielnego kroku.
Trasa zawiera osobny odcinek dla ścieżki od każdego punktu pośredniego do następnego. Jeśli na przykład trasa zawiera jeden punkt początkowy i jeden punkt pośredni docelowy punkt pośredni, trasa składa się z jednego etapu.
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 na temat tras i obliczania tras można znaleźć w sekcji Trasy API.
Oblicz podsumowanie routingu z wyszukiwaniem na trasie
Obliczenia dotyczące podsumowania trasy możesz łączyć z wyszukiwaniem na trasie. W tym przypadku Wyszukiwanie tekstowe (nowe) zwraca czas podróży i odległość do każdego miejsca w odpowiedzi, a następnie z każdego miejsca do ostatniej cel podróży. Wyobraź sobie, że to obliczenie zapewnia czas i odległość podróży, jeśli z wybranego szlaku zboczysz na chwilę, aby dotrzeć do miejsca w wynikach wyszukiwania, a potem kontynuujesz podróż do miejsca docelowego.
Weźmy na przykład trasę z miejsca wyjazdu do miejsca docelowego obliczoną przez interfejs Routes API. Przekaż tę ścieżkę do interfejsu Text Search (New) API wraz z kryteriami wyszukiwania.
W tym przykładzie lokalizacja A jest miejscem zwracanym w wynikach wyszukiwania pochodzących z pola Tekst Wyszukiwanie (nowość). W przypadku każdego miejsca w odpowiedzi wyszukiwanie obejmuje czas trwania i odległość wymaganą do dwuetapowej podróży do tego miejsca:
- Pierwszy etap obejmuje czas podróży i odległość od trasy. origin do miejsca. W tym przykładzie od punktu początkowego do miejsce A.
- Drugi etap zawiera czas i odległość podróży od miejsca do celu. W tym przykładzie od A do miejsce docelowe.
Na podstawie informacji w odpowiedzi możesz obliczyć objazd czas trwania i dystans, 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 podróży z miejsca wylotu do miejsca A; \(s_{OA}\) to odległość podróży z punktu początkowego do A
- \(t_{AD}\) to czas podróży z A do miejsca docelowego. \(s_{AD}\) to odległość podróży z A do miejsca docelowego
Czas trwania objazdu to różnica czasu trwania między pierwotną podróżą. (z miejsca wylotu do miejsca docelowego) i nowa podróż (od miejsca wylotu do miejsce docelowe do A):
Odległość objazdu to różnica odległości między pierwotną podróżą (od punktu początkowego do miejsca docelowego) a nową podróżą (od punktu początkowego do miejsca docelowego przez A):