API Places позволяет вам искать информацию о месте, используя различные категории, включая заведения, известные достопримечательности и географические местоположения. Вы можете искать места либо по близости, либо по текстовой строке. Поиск места возвращает список мест вместе с краткой информацией о каждом месте; дополнительная информация доступна с помощью запроса Place Details (Legacy) .
Сравнить типы поиска
Доступны три конечные точки поиска с различными характеристиками. В следующей таблице показаны некоторые из этих различий.
Тип | Выбор поля | Текстовый поиск (устаревший) | Неоднозначный текст | Фильтр местоположения | Дополнительные фильтры |
---|---|---|---|---|---|
Найти место (устаревшее) | input | ||||
Поиск поблизости (устаревший) | keyword | ||||
Текстовый поиск (устаревший) | query |
Выбор поля
Невозможно ограничить Nearby Search (Legacy) или Text Search (Legacy) только определенными полями. Чтобы не запрашивать (и не платить) данные, которые вам не нужны, используйте вместо этого запрос Find Place (Legacy).
Неоднозначный текст
Функции «Найти место» (устаревшая версия) и «Текстовый поиск» (устаревшая версия) оптимизированы для сопоставления неоднозначного текста по ряду полей, в то время как «Поиск поблизости» (устаревшая версия) ограничен строгими соответствиями по подмножеству полей.
Дополнительные фильтры
Поиск поблизости (устаревшая версия) и текстовый поиск (устаревшая версия) позволяют использовать дополнительные параметры для фильтрации результатов (например, minprice
, maxprice
, opennow
и type
).