Обзор Places SDK (старая версия)

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». Служба отвечает списком мест, соответствующих текстовой строке, и любым установленным смещениям местоположения.

Новые данные ответов добавлены в раздел «Сведения о размещении» (новое) и «Фотографии места» (новое).

  • Сведения о месте (новое) теперь включают в объект ответа Place новый класс Review . Класс Place содержит новый метод getReviews() для поддержки этого поля. Вызовите getReviews() , чтобы получить до пяти отзывов о месте.

  • Place Photo (New) добавляет AuthorAttributions в класс PhotoMetadata . AuthorAttributions содержит List объектов AuthorAttribution .

Добавлен новый ответ URI в Place Photos (новое)

Теперь вы можете использовать Place Photo (New) для возврата URI к растровому изображению. Раньше можно было вернуть только растровое изображение.

Упрощенное ценообразование

Благодаря Places SDK для Android (новая версия) ценообразование упрощается, поэтому вы платите только за те данные, которые используете. Упрощенное ценообразование реализуется с помощью списков полей, также называемых масками полей .

При использовании сведений о месте и текстового поиска вы используете списки полей для управления списком полей, возвращаемых в ответе. В этом случае вам будет выставлен счет только за запрошенные данные. Использование списка полей — это хорошая практика проектирования, позволяющая избежать запроса ненужных данных, что помогает избежать ненужного времени обработки и затрат на выставление счетов.

Подробную информацию о ценах на оба SDK см. в разделе «Использование и выставление счетов» .

Расширенные типы мест

Новый SDK включает новые типы мест, которые возвращаются как часть ответа о месте и текстовом поиске. Вы также можете использовать эти новые и существующие типы при поиске с помощью текстового поиска. Новые типы включены в Таблицу А.