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