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