Введение
API для поиска мест позволяет искать и получать информацию о различных типах мест, используя текстовую строку или по близости. API для поиска мест (устаревшая версия) — это устаревшая версия API для поиска мест (новая версия) .
В таблице ниже указаны соответствующие версии обоих API. Используйте это руководство, чтобы понять основные различия между ними и перейти на Places API (новый).
| API для работы с местами (устаревшая версия) | API для работы с местами (новый) | Примечания |
|---|---|---|
| Найти место (наследие) | Поиск текста (новая функция) | Новой версии программы Find Place (Legacy) нет. Ее заменила программа Text Search (New). |
| Поиск поблизости (устаревшая версия) | Поиск поблизости (новая функция) | Для всех запросов, использующих устаревший API и содержащих текстовый запрос, следует использовать текстовый поиск (новый вариант), поскольку поиск поблизости (новый вариант) не поддерживает ввод текста. |
| Поиск текста (устаревшая версия) | Поиск текста (новая функция) | |
| Подробная информация о месте (наследие) | Подробная информация о месте (новое) | |
| Фотографии мест (наследие) | Фотографии мест (новые) | |
| Функция автозаполнения (устаревшая версия) | Автозаполнение (новое) | |
| Автозаполнение запросов (устаревшая функция) | Автозаполнение (новое) | В функцию автозаполнения добавлены новые возможности. |
Перейдите на новые API.
Для перехода на новые API ознакомьтесь со следующими руководствами по миграции:
- Переключиться на поиск поблизости (новый)
- Переход на текстовый поиск (новая функция)
- Перенос данных о местоположении (новое)
- Перенести фотографии на сайт (новая функция)
- Переход на автозаполнение (новая функция)
В API Places добавлены новые ключевые функции (новые).
В этом разделе описаны основные функции, добавленные в Places API (новые).
Реализовано на стандартной платформе Google Cloud.
Places API (New) is implemented on the service infrastructure on Google Cloud. This implementation brings with it a more secure and trusted platform with enhanced security options like OAuth . This standard API design brings a level of consistency across the APIs that improve the efficiency of development with Places API (New).
Улучшенная производительность
Новый API для работы с местами обеспечивает улучшенную производительность, что делает целесообразным замену приложений, использующих существующий API для работы с местами.
Упрощенное ценообразование
Ценообразование упрощено благодаря Places API (новая функция), поэтому вы платите только за используемые данные. Упрощенное ценообразование реализовано с помощью маски поля .
With Place Details (New), Nearby Search (New), and Text Search (New) you use the field mask to control the list of fields to return in the response. You are then only billed for the data requested. Using field masking is a good design practice to ensure that you don't request unnecessary data, which helps to avoid unnecessary processing time and billing charges.
Последовательные данные ответов для данного места
With the legacy APIs, the Place Details (Legacy), Nearby Search (Legacy), and Text Search (Legacy) APIs returned different response data for a place. Places API (New) standardizes the response so these APIs all return the same data for a place.
Расширенные типы мест
Теперь ответ API может содержать основной тип места. Каждое место может иметь одно значение типа, указанное в качестве основного типа места, как показано в таблице A.
The new API also includes several new types. You can use these new types, and the existing types, in a search with Nearby Search (New) and Text Search (New). The new types are all included in Table A .
Динамические данные о местах
Places API (New) supports dynamic response data, such as the availability of an EV charging station or the latest fuel prices for a gas station. Use these response fields to create dynamic user experiences.