Обзор API Places (устаревшая версия)

API Places позволяет искать и получать информацию о различных типах мест, используя текстовую строку или по близости. Places API — это устаревшая версия Places API (новая) .

В следующей таблице перечислены соответствующие версии обоих API. Используйте это руководство, чтобы понять ключевые различия между ними и перейти на Places API (новая версия).

API Адресов (устаревшая версия) API мест (новое) Примечания
Найти место (наследие) Текстовый поиск (новинка) Новой версии Find Place не существует. Текстовый поиск (новый) заменил его.
Поиск поблизости (старая версия) Поиск поблизости (новинка) Все запросы, использующие устаревший API, включающие текстовый запрос, должны использовать текстовый поиск (новый), поскольку поиск поблизости (новый) не поддерживает ввод текста.
Текстовый поиск (устаревшая версия) Текстовый поиск (новинка)
Сведения о месте (устаревшая версия) Детали места (новое)
Разместить фотографию (устаревшая версия) Разместить фото (новое)
Автозаполнение мест (устаревшая версия) Автозаполнение (новое)
Автозаполнение запроса (устаревшая версия) Автозаполнение (новое) Возможности, добавленные в автозаполнение (новое).

Переход на новые API

Чтобы перейти на новые API, ознакомьтесь со следующими руководствами по миграции:

Ключевые функции, добавленные в Places API (новинка)

В этом разделе описаны ключевые функции, добавленные в Places API (новая версия).

Реализовано на стандартной платформе Google Cloud.

Places API (новый) реализован в сервисной инфраструктуре Google Cloud. Эта реализация обеспечивает более безопасную и надежную платформу с расширенными возможностями безопасности, такими как OAuth . Этот стандартный дизайн API обеспечивает уровень согласованности между API, что повышает эффективность разработки с помощью Places API (новая версия).

Улучшенная производительность

API Places (новый) обеспечивает повышенную производительность, поэтому стоит заменить приложения, использующие существующий API Places.

Упрощенное ценообразование

Цены упрощены благодаря Places API (новое), поэтому вы платите только за те данные, которые используете. Упрощенное ценообразование реализуется с помощью маски поля .

При использовании сведений о месте (новое), поиска поблизости (новое) и текстового поиска (новое) вы используете маску поля для управления списком полей, возвращаемых в ответе. В этом случае вам будет выставлен счет только за запрошенные данные. Использование маскировки полей — это хорошая практика проектирования, позволяющая гарантировать, что вы не запрашиваете ненужные данные, что помогает избежать ненужного времени обработки и затрат на выставление счетов.

Согласованные данные ответов для места

При использовании существующих API API сведений о месте, поиска поблизости и текстового поиска возвращали разные данные ответа для места. Places API (новый) стандартизирует ответ, поэтому все эти API возвращают одни и те же данные о месте.

Расширенные типы мест

Ответ API теперь может содержать основной тип места. Каждое место может иметь одно значение типа, указанное в качестве основного типа места, как указано в таблице A.

Новый API также включает несколько новых типов. Вы можете использовать эти новые и существующие типы при поиске с помощью функции «Поиск поблизости» (новый) и «Текстовый поиск (новый)». Все новые типы включены в Таблицу А.

Динамические данные о месте

Places API (новый) поддерживает данные динамического ответа, такие как наличие зарядной станции для электромобилей или последние цены на топливо на заправочной станции. Используйте эти поля ответов для создания динамичного взаимодействия с пользователем.