Обзор поисковой операции вдоль маршрута.
Функция поиска вдоль маршрута доступна в следующих API-интерфейсах Places (новые):
- Поиск по тексту (только новая функция): поиск мест вдоль заданного маршрута поездки.
- Поиск по тексту (новая функция) и поиск поблизости (новая функция): вычисляют сводку маршрута от указанного пункта отправления до каждого пункта в результатах поиска.
- Поиск по тексту (только для новой версии): Рассчитывает сводку маршрута для каждого места вдоль предопределенного маршрута поездки.
Поиск вдоль маршрута
Для расчета маршрута между двумя точками вы используете API Routes . API Routes может рассчитать маршрут для автомобиля, велосипеда, двухколесного транспортного средства, общественного транспорта или для пешей прогулки.
Функция «Текстовый поиск (новая)» позволяет использовать этот вычисленный маршрут для выполнения поиска вдоль заданного маршрута . При использовании этой опции вы передаете предварительно вычисленный маршрут из API маршрутов в запрос «Текстовый поиск (новая)». В ответе будут содержаться места, соответствующие критериям поиска и расположенные рядом с указанным маршрутом.
Поиск вдоль маршрута аналогичен использованию параметров запроса locationRestriction или locationBias для смещения результатов поиска. locationRestriction возвращает результаты поиска, попадающие в границы области просмотра, в то время как locationBias может возвращать результаты поиска за пределы области просмотра. Однако, хотя параметры locationBias и locationRestriction позволяют указать регион для смещения результатов поиска, функция поиска вдоль маршрута в текстовом поиске также позволяет смещать результаты поиска таким образом, чтобы включить те, у которых минимальное время объезда от начальной точки маршрута до конечной точки. Вы можете смещать результаты поиска, используя locationBias или locationRestriction в сочетании с полилинией.
Например, рассмотрим маршрут от начальной точки, называемой путевой точкой в API маршрутов, до конечной точки, рассчитанный с помощью API маршрутов:
При поиске вдоль маршрута поиск, как правило, возвращает места, расположенные недалеко от маршрута, с минимальным временем объезда от начальной точки до конечной. В этом примере точки A, B и C — это места, найденные в результате поиска.
Рассчитать сводку маршрутизации
Поиск по тексту (новый) и поиск поблизости (новый) позволяют рассчитать сводку маршрута , то есть продолжительность и расстояние до каждого места в ответе, на основе указанного в запросе местоположения начальной точки маршрута . При указании начальной точки маршрута ответ содержит не только список мест, соответствующих поиску, но и продолжительность поездки и расстояние от начальной точки маршрута до каждого места.
На следующем изображении точки A, B и C — это места, найденные в результате поиска:
Для каждого места в результатах поиска ответ содержит информацию о продолжительности поездки и расстоянии от начальной точки маршрута до этого места, если таковые имеются.
По умолчанию продолжительность и расстояние поездки рассчитываются с использованием параметра TRAFFIC_UNAWARE в API маршрутов. При желании можно установить параметры маршрутизации, учитывающие условия дорожного движения в реальном времени TRAFFIC_AWARE_OPTIMAL или условия дорожного движения с уменьшенной задержкой TRAFFIC_AWARE при расчетах.
Информация о маршрутах, участках и путевых точках.
Маршрут, рассчитываемый с помощью API маршрутов, состоит из нескольких компонентов:
Маршрут состоит из следующих компонентов:
- Путевые точки : Для расчета маршрута необходимо указать как минимум начальную и конечную точки. Эти точки определяются как путевые точки на маршруте. Промежуточные путевые точки — это точки между начальной и конечной точками, через которые должен проходить маршрут.
Маршрут : Весь путь от начальной точки маршрута, через любые промежуточные точки, до конечной точки маршрута. Маршрут состоит из одного или нескольких участков .
При передаче маршрута в Text Search вы передаете закодированную полилинию маршрута , возвращаемую API маршрутов . Закодированная полилиния — это закодированный список точек широты и долготы, позволяющий представить полилинию маршрута в виде строки.
Этап : Путь от одной точки маршрута до следующей точки маршрута. Каждый этап состоит из одного или нескольких отдельных шагов .
Маршрут состоит из отдельных участков пути от каждой контрольной точки до следующей. Например, если маршрут содержит одну начальную и одну конечную контрольные точки, то маршрут состоит из одного участка.
Для каждой дополнительной точки маршрута, добавляемой после начальной и конечной точек (так называемой промежуточной точки), API добавляет отдельный участок.
Для получения дополнительной информации о маршрутах и их расчете см. API маршрутов .
Рассчитайте сводку маршрута, выполнив поиск вдоль маршрута.
Вы можете комбинировать вычисления сводной информации о маршруте с поиском вдоль маршрута . В этом случае текстовый поиск (новый) возвращает продолжительность поездки и расстояние до каждого пункта в ответе, а затем от каждого пункта до конечного пункта назначения маршрута. Представьте, что это вычисление показывает продолжительность поездки и расстояние, если вы отклонитесь от указанного маршрута, чтобы добраться до пункта назначения в результатах поиска, а затем продолжите путь до конечного пункта назначения.
Например, рассмотрим следующий маршрут от пункта отправления до пункта назначения, рассчитанный API маршрутов. Передайте этот маршрут в API текстового поиска (новый) вместе с критериями поиска.
В этом примере местоположение А — это место, найденное в результатах поиска с помощью текстового поиска (новый). Для каждого места в ответе поиск включает продолжительность и расстояние, необходимые для объезда этого места в два этапа :
- Первый этап включает в себя продолжительность поездки и расстояние от начальной точки маршрута до конечного пункта . В этом примере — от начальной точки до пункта А.
- Второй этап включает в себя продолжительность поездки и расстояние от места назначения до конечного пункта маршрута. В этом примере — от точки А до конечного пункта назначения.
На основе информации из ответа вы можете рассчитать продолжительность и расстояние объезда , где:
- \(t_{OD}\) — это продолжительность поездки от пункта отправления до пункта назначения. \(s_{OD}\) — это расстояние поездки от пункта отправления до пункта назначения.
- \(t_{OA}\) – это продолжительность поездки от пункта отправления до пункта А; \(s_{OA}\) — это расстояние поездки от начальной точки до точки А.
- \(t_{AD}\) – это продолжительность поездки из пункта А в пункт назначения; \(s_{AD}\) — это расстояние поездки от точки А до пункта назначения.
Продолжительность объезда — это разница во времени между первоначальной поездкой (от пункта отправления до пункта назначения) и новой поездкой (от пункта отправления до пункта назначения через точку А):
Объездное расстояние — это разница в расстоянии между исходным маршрутом (от пункта отправления до пункта назначения) и новым маршрутом (от пункта отправления до пункта назначения через точку А):