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