Places SDK позволяет искать и извлекать информацию о различных типах мест, используя текстовую строку или близость к ним. Places SDK — это устаревшая версия Places SDK (новая).
Используйте это руководство, чтобы понять основные различия между версиями Places SDK и перейти на Places SDK (новый).
Функции SDK доступны в каждой версии
В следующей таблице показано, какие версии SDK и API требуются для каждой функции SDK:
| Особенность | API мест включен по ключу API | Метод инициализации | Минимальная версия SDK |
|---|---|---|---|
| Автозаполнение (новое) | API мест (новый) | initializeWithNewPlacesApiEnabled() | 3.5.0 |
| Подробности места (новые) | API мест (новый) | initializeWithNewPlacesApiEnabled() | 3.3.0 |
| Поиск поблизости (новый) | API мест (новый) | initializeWithNewPlacesApiEnabled() | 3.5.0 |
| Фотографии места (новые) | API мест (новый) | initializeWithNewPlacesApiEnabled() | 3.4.0 |
| Текстовый поиск (новый) | API мест (новый) | initializeWithNewPlacesApiEnabled() | 3.3.0 |
| Автозаполнение места | API мест | initialize() | |
| Текущее место | API мест | initialize() | |
| Подробности места | API мест | initialize() | |
| Разместить фотографии | API мест | initialize() |
Переход на новые API
Чтобы перейти на новые API, ознакомьтесь со следующими руководствами по миграции:
- Перенести в сведения о месте (новое)
- Перенести на место фото (новое)
- Переход на автозаполнение (новое)
Улучшения в Places SDK для Android (новое)
В этом разделе рассматриваются основные функции, добавленные в Places SDK для Android (новый).
Реализовано на стандартной платформе Google Cloud
Places SDK для Android (новый) реализован на сервисной инфраструктуре Google Cloud. Эта реализация обеспечивает более безопасную и надёжную платформу. Стандартная архитектура обеспечивает согласованность всех SDK, что повышает эффективность разработки с использованием Places SDK для Android (новый).
Улучшенная производительность
Places SDK для Android (новый) обеспечивает улучшенную производительность, что делает целесообразной замену приложений, использующих существующий SDK.
Новые функции
Places SDK для Android (новый) включает в себя последние версии всех функций SDK:
- Автозаполнение (новое)
- Подробности места (новые)
- Поиск поблизости (новый)
- Фотографии места (новые)
- Текстовый поиск (новый)
Новая служба текстового поиска
Текстовый поиск (новый) возвращает информацию о наборе мест по заданной строке, например, «пицца в Нью-Йорке», «обувные магазины рядом с Оттавой» или «123 Мэйн-стрит». Сервис возвращает список мест, соответствующих текстовой строке, с учётом заданного смещения местоположения.
Новые данные об ответах добавлены в сведения о размещении (новые) и фотографии мест (новые)
В разделе «Сведения о месте (новое)» теперь есть новый класс Review в объекте ответа
Place. Класс Place содержит новый методgetReviews()для поддержки этого поля. ВызовитеgetReviews(), чтобы получить до пяти отзывов о месте.Разместить фото (новое) добавляет объект
AuthorAttributionsв классPhotoMetadata.AuthorAttributionsсодержитListобъектовAuthorAttribution.
Добавлен новый ответ URI для Place Photos (Новое)
Теперь вы можете использовать функцию Place Photo (новая) для возврата URI к растровому изображению. Раньше можно было вернуть только само растровое изображение.
Упрощенное ценообразование
Благодаря Places SDK для Android (новый) ценообразование упрощено, так что вы платите только за используемые данные. Упрощенное ценообразование реализовано с помощью списков полей, также называемых масками полей .
При использовании функций «Сведения о месте» и «Текстовый поиск» вы используете списки полей для управления списком полей, возвращаемых в ответе. В этом случае с вас будет взиматься плата только за запрошенные данные. Использование списка полей — это хорошая практика проектирования, которая гарантирует отсутствие запроса ненужных данных, что помогает избежать ненужного времени обработки и дополнительных расходов.
Подробную информацию о ценах на оба SDK см. в разделе Использование и выставление счетов .
Расширенные типы мест
Новый SDK включает новые типы мест, которые возвращаются в ответах на запросы «Описание места» и «Текстовый поиск». Вы также можете использовать эти новые и существующие типы в поиске с помощью текстового поиска. Новые типы представлены в таблице A.