Places SDK позволяет искать и получать информацию о различных типах мест, используя текстовую строку или по близости. Places SDK — это устаревшая версия Places SDK (New).
Воспользуйтесь этим руководством, чтобы понять основные различия между версиями Places SDK и перейти на Places SDK (New).
Функции 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 ознакомьтесь со следующими руководствами по миграции:
- Перенос данных о местоположении (новое)
- Перенести на новое место для фотосъемки
- Переход на автозаполнение (новая функция)
Улучшения в SDK для работы с местами для Android (новые)
В этом разделе описаны ключевые функции, добавленные в Places SDK для Android (новые).
Реализовано на стандартной платформе Google Cloud.
Places SDK для Android (новая версия) реализован на сервисной инфраструктуре Google Cloud. Эта реализация обеспечивает более безопасную и надежную платформу. Стандартизированный дизайн обеспечивает уровень согласованности между SDK, что повышает эффективность разработки с использованием Places SDK для Android (новая версия).
Улучшенная производительность
Новый SDK Places для Android обеспечивает улучшенную производительность, что делает целесообразным замену приложений, использующих существующий SDK.
Новые функции
В состав Places SDK для Android (новая версия) входят последние версии всех функций SDK:
- Автозаполнение (новое)
- Подробная информация о месте (новое)
- Поиск поблизости (новая функция)
- Фотографии мест (новые)
- Поиск текста (новая функция)
Новая служба текстового поиска
Функция текстового поиска (новая функция) возвращает информацию о наборе мест на основе строки — например, «пицца в Нью-Йорке», «обувные магазины рядом с Оттавой» или «123 Мэйн-стрит». Сервис отвечает списком мест, соответствующих текстовой строке, с учетом любых заданных параметров местоположения.
В разделы «Подробная информация о месте размещения» (новое) и «Фотографии места размещения» (новое) добавлены новые данные об ответах.
В разделе «Подробности о месте » (новое) в объект ответа
Placeтеперь включен новый класс «Отзывы ». Класс «Место» содержит новый методgetReviews()для поддержки этого поля. Вызов методаgetReviews()позволяет получить до пяти отзывов о месте.Функция «Добавить фото» (новая) добавляет
AuthorAttributionsв классPhotoMetadata.AuthorAttributionsсодержитListобъектовAuthorAttribution.
В функцию «Фотографические места» добавлен новый URI-ответ.
Теперь с помощью функции «Разместить фото» (новая функция) можно получить URI растрового изображения. Ранее можно было получить только само растровое изображение.
Упрощенное ценообразование
В Places SDK для Android (новая версия) упрощена система ценообразования, так что вы платите только за использованные данные. Упрощенное ценообразование реализовано с помощью списков полей, также называемых масками полей .
При использовании функций «Подробная информация о месте» и «Текстовый поиск» вы используете списки полей для управления перечнем полей, возвращаемых в ответе. В этом случае с вас взимается плата только за запрошенные данные. Использование списка полей — это хорошая практика проектирования, позволяющая избежать запроса ненужных данных, что помогает избежать лишнего времени обработки и дополнительных расходов.
Подробную информацию о ценах на оба SDK см. в разделе «Использование и выставление счетов» .
Расширенные типы мест
Новый SDK включает новые типы мест, которые возвращаются в составе ответов «Подробности о месте» и «Текстовый поиск». Вы также можете использовать эти новые типы, а также существующие типы, в поиске с помощью текстового поиска. Новые типы приведены в таблице A.