Введение
Places API позволяет искать и получать информацию о различных типах мест по текстовой строке или по близости. Places API (устаревший) – это устаревшая версия Places API (нового).
В таблице ниже перечислены соответствующие версии обоих API. В этом руководстве рассказывается, чем они различаются и как перейти на Places API (New).
| Places API (устаревший) | Places API (новинка) | Примечания |
|---|---|---|
| Find Place (устаревший) | Text Search (New) | Новой версии Find Place (Legacy) нет. Ее заменила новая версия текстового поиска. |
| Поиск поблизости (устаревший) | Поиск поблизости (новый) | Все запросы, использующие устаревший API и включающие текстовый запрос, должны использовать Text Search (New), поскольку Nearby Search (New) не поддерживает текстовый ввод. |
| Text Search (Legacy) | Text Search (New) | |
| Place Details (Legacy) | Place Details (New) | |
| Place Photos (устаревшая версия) | Фотографии мест (новое) | |
| Автозаполнение мест (устаревшая версия) | Autocomplete (New) | |
| Автозаполнение запросов (устаревшая версия) | Autocomplete (New) | Возможности, добавленные в новую версию Autocomplete. |
Переход на новые API
Чтобы перейти на новые API, ознакомьтесь со следующими руководствами по переносу данных:
- Переход на Nearby Search (New)
- Переход на текстовый поиск (New)
- Переход на информацию о местах (New)
- Переход на Place Photos (New)
- Переход на Autocomplete (New)
Основные функции, добавленные в Places API (новинка)
В этом разделе описаны основные функции, добавленные в Places API (New).
Реализовано на стандартной платформе Google Cloud.
Новая версия Places API реализована на инфраструктуре сервисов в Google Cloud. Это изменение позволит повысить безопасность и надежность платформы, а также расширить возможности защиты, например за счет OAuth. Такой стандартный дизайн API обеспечивает согласованность между API, что повышает эффективность разработки с помощью Places API (New).
Рост эффективности
Places API (New) обеспечивает повышенную производительность, поэтому стоит заменить им существующий Places API в приложениях.
Упрощенное ценообразование
В новой версии Places API упрощена схема оплаты: вы платите только за те данные, которые используете. Упрощенное ценообразование реализуется с помощью маски поля.
В новых версиях информации о местах (New), поиска поблизости (New) и текстового поиска (New) маска полей позволяет управлять списком полей, возвращаемых в ответе. Вам будет выставлен счет только за запрошенные данные. Маски полей помогут вам не запрашивать ненужные данные и тем самым сократить время обработки и снизить расходы.
Согласованные данные в ответе о месте
В устаревших версиях API информация о местах (Legacy), поиск поблизости (Legacy) и текстовый поиск (Legacy) возвращали разные данные о месте. Places API (New) стандартизирует ответ, поэтому все эти API возвращают одинаковые данные о месте.
Расширенные типы мест
Теперь ответ API может содержать основной тип места. Каждое место может иметь одно значение типа, которое указывается как основной тип места, как указано в Таблице А.
В новом API также есть несколько новых типов. Вы можете использовать эти новые типы, а также существующие типы в поиске с помощью поиска поблизости (New) и текстового поиска (New). Все новые типы включены в таблицу А.
Динамические данные о местах
Places API (New) поддерживает динамические данные в ответах, например доступность станции зарядки ЭМ или актуальные цены на топливо на заправке. Используйте эти поля ответа, чтобы сделать взаимодействие с пользователями более динамичным.