Wyszukiwanie na trasie – omówienie

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 (nowość) i Wyszukiwanie w pobliżu (nowość): oblicza podsumowanie 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 obliczania trasy między 2 lokalizacjami użyj interfejsu Routes API. Interfejs Routes API może obliczyć trasę dla samochodu, roweru, dwukołowego pojazdu, transportu publicznego lub pieszego.

Uwaga: interfejs Places API nie obsługuje tras komunikacji miejskiej.

Wyszukiwanie tekstowe (nowość) umożliwia korzystanie z obliczonej trasy do wyszukiwania wzdłuż trasy. Dzięki tej opcji przekazujesz wyliczoną trasę z interfejsu Routes API do żądania wyszukiwania tekstu (nowe). 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, 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 wyniki, które mają minimalny czas objazdu od początku do końca trasy. Możesz odchylać wyniki wyszukiwania, używając w połączeniu z linią łamaną tych właściwości locationBias lub locationRestriction.

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, wyniki wyszukiwania są dopasowywane do miejsc znajdujących się w pobliżu trasy z minimalnym czasem dojazdu z miejsca wylotu do miejsca docelowego. W tym przykładzie punkty A, B i C to miejsca zwrócone przez wyszukiwanie.

Oblicz podsumowanie tras

Funkcje Wyszukiwanie tekstowe (nowość) i Wyszukiwanie w pobliżu (nowość) mogą obliczać podsumowanie trasy, czyli czas trwania i odległość do każdego miejsca w odpowiedzi, na podstawie lokalizacji punktu początkowego w żądaniu. 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).

Uwaga: są to tylko szacunkowe informacje o przekierowaniu. Aby uzyskać szczegóły rzeczywistej trasy, w tym wskazówki krok po kroku, użyj interfejsu API Trasy.

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.

Uwaga: opcje TRAFFIC_AWARE i TRAFFIC_OPTIMAL dotyczą tylko trybów podróży DRIVE i TWO_WHEELER. Jeśli dowolna z preferencji routingu jest określona z nieobsługiwanym trybem podróży, obliczenie podsumowania routingu zostanie domyślnie wykonane z użyciem opcji TRAFFIC_UNAWARE. Jeśli podano TWO_WHEELER w nieobsługiwanym regionie, interfejs API zwraca puste podsumowanie routingu.

Gdy ustawisz preferencje wyznaczania trasy TRAFFIC_AWARE, trasy są obliczane z uwzględnieniem warunków na drodze. Dzięki temu trasa i jej szczegóły lepiej odzwierciedlają rzeczywiste warunki. Zwiększenie jakości danych odbywa się kosztem opóźnienia odpowiedzi, dlatego stosujemy optymalizacje wydajności, aby zmniejszyć opóźnienie. Gdy ustawisz preferencję kierowania TRAFFIC_AWARE_OPTIMAL, trasy są obliczane z uwzględnieniem warunków ruchu, ale nie są stosowane żadne optymalizacje skuteczności. W tym trybie serwer wykonuje bardziej wyczerpujące wyszukiwanie sieci drogowej, aby znaleźć optymalną trasę.

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. Określasz je jako punkty pośrednie na trasie. Pośrednie punkty pośrednie to lokalizacje pomiędzy miejscem wylotu a celem podróży, przez które chcesz przechodzić 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 kontrolnego na trasie do następnego punktu kontrolnego na tej trasie. Każda noga składa się z co najmniej 1 oddzielnego kroku.

  Trasa zawiera oddzielny odcinek ścieżki od każdego punktu pośredniego do kolejnego. Jeśli na przykład trasa obejmuje jeden punkt początkowy i jeden 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 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 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 sekcji Tekstowe wyszukiwanie (nowa). W przypadku każdego miejsca w odpowiedzi wyszukiwanie obejmuje czas i odległość wymaganą 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 z punktu początkowego do miejsca A.
• Drugi etap zawiera informacje o czasie podróży i odległości od miejsca do celu trasy. 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):

$$ t_{detour} = t_{OA} + t_{AD} - t_{OD} $$

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):

$$ s_{detour} = s_{OA} + s_{AD} - s_{OD} $$