Omówienie wyszukiwania na trasie

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

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

Wyszukiwanie wzdłuż trasy

Do obliczenia trasy podróży między 2 miejscami używasz interfejsu Routes API. Interfejs Routes API może obliczać trasy dla samochodu, roweru, pojazdu dwukołowego, systemu transportu publicznego lub pieszych.

Uwaga: interfejs Places API nie obsługuje tras w systemie transportu publicznego.

Wyszukiwanie tekstu (nowa funkcja) umożliwia korzystanie z wyliczonego wcześniej planu trasy do przeprowadzenia wyszukiwania wzdłuż trasy. W przypadku tej opcji przekazujesz z interfejsu Routes API do zapytania 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 zapytania locationRestriction lub locationBias w celu zawężenia wyników wyszukiwania. locationRestrictionzwraca wyniki wyszukiwania, które mieszczą się w ramach widoku, a locationBias może zwracać wyniki wyszukiwania spoza widoku. Opcje locationBias i locationRestriction umożliwiają określenie regionu, aby zawęzić wyniki wyszukiwania, ale funkcja wyszukiwania wzdłuż trasy 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. Wyniki wyszukiwania możesz kierować za pomocą właściwości locationBias lub locationRestriction w połączeniu z wielokątem.

Rozważmy na przykład trasę od punktu początkowego, który w interfejsie Routes API jest nazywany punktem pośrednim, do miejsca docelowego obliczonego przez ten interfejs:

Gdy wyszukujesz miejsca na trasie, wyniki wyszukiwania będą zawierać miejsca znajdujące się w pobliżu trasy z minimalnym czasem dojazdu od punktu początkowego do miejsca docelowego. W tym przykładzie punkty A, B i C to miejsca zwrócone przez wyszukiwanie.

Oblicz podsumowanie trasowania

Wyszukiwanie tekstowe (nowa) i Wyszukiwanie w pobliżu (nowa) mogą obliczać podsumowanie trasy, czyli czas i odległość do każdego miejsca w odpowiedzi, na podstawie określonej w żądaniu lokalizacji punktu początkowego trasy. Gdy określisz punkt początkowy trasy, odpowiedź będzie 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 i odległość od punktu początkowego do miejsca docelowego (jeśli są dostępne).

Uwaga: jest to tylko przybliżona informacja o trasie. Aby uzyskać szczegóły dotyczące trasy, w tym wskazówki krok po kroku, użyj interfejsu Route API.

Domyślnie czas i odległość podróży są obliczane za pomocą 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: właściwości TRAFFIC_AWARE i TRAFFIC_OPTIMAL dotyczą tylko trybów podróży DRIVE i TWO_WHEELER. Jeśli którakolwiek z preferencji trasy jest określona z nieobsługiwanym środkiem transportu, obliczenie podsumowania trasy zostanie domyślnie wykonane z użyciem opcji TRAFFIC_UNAWARE. Jeśli w nieobsługiwanym regionie podany jest parametr TWO_WHEELER, interfejs API zwraca puste podsumowanie trasowania.

Gdy ustawisz preferencje wyznaczania trasy TRAFFIC_AWARE, trasy są obliczane z uwzględnieniem warunków na drodze. W efekcie trasa i jej szczegóły lepiej odzwierciedlają warunki panujące w rzeczywistych warunkach. Zwiększenie jakości danych odbywa się kosztem opóźnienia odpowiedzi, dlatego stosujemy optymalizacje wydajności, aby zmniejszyć opóźnienie. Gdy ustawisz preferencję wyznaczania trasy TRAFFIC_AWARE_OPTIMAL, trasy są obliczane z uwzględnieniem warunków ruchu, ale nie są stosowane żadne optymalizacje wydajnoś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 elementów:

• Punkt pośredni: aby obliczyć trasę, należy określić co najmniej punkt początkowy i docelowy. Te lokalizacje określasz jako punkty pośrednie na trasie. Punkty pośrednie to lokalizacje między punktem początkowym a docelowym, przez które ma przebiegać trasa.

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

  Przekazując trasę do wyszukiwania tekstowego, przekazujesz zakodowaną polilinię trasy zwracaną przez interfejs Routes API. Zaszyfrowana linia wielokąta to zakodowana lista punktów szerokości i długości geograficznej, która umożliwia przedstawienie linii wielokąta trasy jako ciągu znaków.

• Odcinek: ścieżka od jednego punktu drogi do następnego punktu drogi. Każdy etap składa się z co najmniej 1 osobnego kroku.

  Trasa zawiera osobny odcinek od jednego punktu do drugiego. Jeśli na przykład trasa zawiera jeden punkt początkowy i jeden punkt docelowy, to zawiera tylko jeden odcinek.

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

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

Oblicz podsumowanie trasy z wyszukiwaniem na trasie

Obliczenia podsumowania trasy możesz łą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 następnie od każdego miejsca do miejsca docelowego. Wyobraź sobie, że to obliczenie zapewnia czas i odległość podróży, jeśli zjeżdżasz z wyznaczonego szlaku, aby dotrzeć do miejsca w wynikach wyszukiwania, a następnie kontynuujesz podróż do miejsca docelowego.

Rozważ na przykład trasę z miejsca wylotu do miejsca docelowego obliczoną przez interfejs Routes API. Przekaż ten szlak do interfejsu Text Search (New) API wraz z kryteriami wyszukiwania.

W tym przykładzie lokalizacja A to miejsce zwrócone w wynikach wyszukiwania z funkcji wyszukiwania tekstowego (Nowa). W przypadku każdego miejsca w odpowiedzi wyszukiwanie obejmuje czas i odległość potrzebną do dojazdu do tego miejsca jako podróży dwuetapowej:

• Pierwszy odcinek zawiera czas i odległość podróży od miejsca do miejsca. W tym przykładzie od punktu wyjścia 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 od miejsca wyjazdu do miejsca docelowego, \(s_{OD}\) to odległość od miejsca wyjazdu do miejsca docelowego.
• \(t_{OA}\) to czas trwania podróży z miejsca wylotu do A; \(s_{OA}\) to odległość z miejsca wylotu 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 trwania objazdu to różnica czasu między pierwotną podróżą (od punktu początkowego do miejsca docelowego) a nową podróżą (od punktu początkowego do miejsca 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} $$