Omówienie wyszukiwania miejsc przy trasie

Funkcje wyszukiwania miejsc przy trasie są dostępne w tych interfejsach Places (New) API:

• Tylko Text Search (New): wyszukiwanie miejsc na zdefiniowanej trasie podróży.
• Wyszukaj tekst (Nowe) i Wyszukiwanie w pobliżu (Nowe): Oblicz podsumowanie routingu od określonej lokalizacji początkowej routingu do każdego miejsca w wynikach wyszukiwania.
• Tylko Wyszukaj tekst (Nowe): obliczanie podsumowania routingu dla każdego miejsca na zdefiniowanej trasie podróży.

Wyszukiwanie miejsc przy trasie

Za pomocą interfe0}su Routes API możesz obliczyć trasę podróży między 2 lokalizacjami. Interfejs Routes API może obliczyć trasę dla samochodu, roweru, pojazdu dwukołowego, transportu publicznego lub pieszą.

Text Search (New) umożliwia użycie obliczonej trasy do przeprowadzenia wyszukiwania miejsc przy trasie. W tym przypadku przekazujesz wstępnie obliczoną trasę z interfejsu Routes API do żądania Wyszukaj tekst (New). Odpowiedź zawiera miejsca, które pasują do kryteriów wyszukiwania i znajdują się w pobliżu określonej trasy.

Wyszukiwanie miejsc przy trasie jest podobne do używania opcji żądania locationRestriction lub locationBias w celu ukierunkowania wyników wyszukiwania. locationRestriction zwraca wyniki wyszukiwania, które mieszczą się w granicach widocznego obszaru, a locationBias może zwracać wyniki wyszukiwania poza widocznym obszarem. Jednak opcje locationBias i locationRestriction umożliwiają określenie regionu, w którym mają być ukierunkowane wyniki wyszukiwania, a funkcja wyszukiwania miejsc przy trasie w Text Search umożliwia też ukierunkowanie wyników wyszukiwania tak, aby uwzględniały te, które mają minimalny czas objazdu od miejsca początkowego do miejsca docelowego. Możesz ukierunkować wyniki wyszukiwania za pomocą locationBias lub locationRestriction w połączeniu z linią łamaną.

Rozważmy na przykład trasę od miejsca początkowego, które w interfejsie Routes API jest nazywane punktem pośrednim , do miejsca docelowego obliczoną przez interfejs Routes API:

Gdy wyszukujesz miejsca przy trasie, wyszukiwanie jest ukierunkowane na zwracanie miejsc w pobliżu trasy z minimalnym czasem objazdu od miejsca początkowego do miejsca docelowego. W tym przykładzie punkty A, B i C to miejsca zwrócone przez wyszukiwanie.

Obliczanie podsumowania routingu

Wyszukaj tekst (New) i Wyszukiwanie w pobliżu (New) mogą obliczyć podsumowanie routingu, czyli czas trwania i odległość, do każdego miejsca w odpowiedzi na podstawie określonej w żądaniu lokalizacji początkowej routingu. Gdy określisz lokalizację początkową, odpowiedź będzie zawierać nie tylko listę miejsc pasujących do wyszukiwania, ale też czas i odległość podróży od lokalizacji początkowej do każdego miejsca.

Na ilustracji poniżej punkty A, B i C to miejsca zwrócone w odpowiedzi na wyszukiwanie:

W przypadku każdego miejsca w wynikach odpowiedź zawiera czas i odległość podróży od lokalizacji początkowej do tego miejsca, jeśli są dostępne.

Domyślnie czas i odległość podróży są obliczane za pomocą opcji TRAFFIC_UNAWARE w interfejsie Routes API. Opcjonalnie możesz ustawić preferencje routingu, aby podczas obliczeń uwzględniać aktualne warunki drogowe TRAFFIC_AWARE_OPTIMAL lub aktualne warunki drogowe ze zmniejszonym opóźnieniem TRAFFIC_AWARE.

Informacje o trasach, odcinkach i punktach pośrednich

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

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

• Waypoint: aby obliczyć trasę, musisz określić co najmniej lokalizacje miejsca początkowego i miejsca docelowego. Te lokalizacje definiujesz jako punkty pośrednie na trasie. Punkty pośrednie to lokalizacje między miejscem 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 odcinka.

  Gdy przekazujesz trasę do Wyszukaj tekst, przekazujesz zakodowaną linię łamaną trasy zwróconą przez interfejs Routes API. Zakodowana linia łamana to zakodowana lista punktów szerokości i długości geograficznej, która umożliwia przedstawienie linii łamanej trasy jako ciągu znaków.

• Odcinek: ścieżka od jednego punktu pośredniego na trasie do następnego punktu pośredniego na trasie. Każdy odcinek składa się z co najmniej 1 oddzielnego kroku.

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

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

Więcej informacji o trasach i ich obliczaniu znajdziesz w dokumentacji interfejsu Routes API.

Obliczanie podsumowania routingu za pomocą wyszukiwania miejsc przy trasie

Możesz połączyć obliczanie podsumowania routingu z wyszukiwaniem miejsc przy trasie. W takim przypadku Wyszukaj tekst (New) zwraca czas i odległość podróży do każdego miejsca w odpowiedzi, a następnie z każdego miejsca do miejsca docelowego trasy. To obliczenie można traktować jako podanie czasu i odległości podróży, jeśli zboczysz z określonej trasy, aby dotrzeć do miejsca w wynikach wyszukiwania, a następnie kontynuować podróż do miejsca docelowego.

Rozważmy na przykład trasę od miejsca początkowego do miejsca docelowego obliczoną przez interfejs Routes API. Przekaż tę trasę do interfejsu Wyszukaj tekst (New) API wraz z kryteriami wyszukiwania.

W tym przykładzie lokalizacja A to miejsce zwrócone w wynikach wyszukiwania przez Wyszukaj tekst (Nowe). W przypadku każdego miejsca w odpowiedzi wyszukiwanie obejmuje czas i odległość potrzebne do objazdu do tego miejsca jako podróż 2-etapową:

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

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

• \(t_{OD}\) to czas podróży od miejsca początkowego do miejsca docelowego, \(s_{OD}\) a to odległość podróży od miejsca początkowego do miejsca docelowego;
• \(t_{OA}\) to czas podróży od miejsca początkowego do miejsca A, a \(s_{OA}\) to odległość podróży od miejsca początkowego do miejsca A;
• \(t_{AD}\) to czas podróży od miejsca A do miejsca docelowego, \(s_{AD}\) to odległość podróży od miejsca A do miejsca docelowego.

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

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