Обзор Places SDK для Android (устаревшая версия)

В этом руководстве описаны основные различия между версиями Places SDK и рассказано, как перейти на Places SDK для Android (новый).

Функции SDK, доступные в каждой версии

В таблице ниже указано, какие версии SDK и API требуются для каждой функции SDK.

Функция Версия Places API Метод инициализации Минимальная версия SDK
Autocomplete (New) Places API (новинка) initializeWithNewPlacesApiEnabled() 3.5.0
Place Details (New) Places API (новинка) initializeWithNewPlacesApiEnabled() 3.3.0
Поиск поблизости (новый) Places API (новинка) initializeWithNewPlacesApiEnabled() 3.5.0
Фотографии мест (новое) Places API (новинка) initializeWithNewPlacesApiEnabled() 3.4.0
Text Search (New) Places API (новинка) initializeWithNewPlacesApiEnabled() 3.3.0
Автозаполнение мест Places API (устаревший) initialize() (поддержка прекращена)
Current Place Places API (устаревший) initialize() (поддержка прекращена)
Информация о местах Places API (устаревший) initialize() (больше не поддерживается)
Фотографии мест Places 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". Ответ содержит список мест, соответствующих текстовой строке с учетом указанного предпочтительного местоположения.

В информацию о местах (New) и фотографии мест (New) добавлены новые данные ответа

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

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

В Place Photos (New) добавлен новый ответ URI

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

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

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

В Place Details (New) и Text Search (New) вы можете использовать списки полей, чтобы указать, какие поля должны возвращаться в ответе на запрос. Вам будет выставлен счет только за запрошенные данные. Списки полей помогут вам не запрашивать ненужные данные и тем самым сократить время обработки и снизить расходы.

Подробную информацию о ценах можно найти в разделе Использование и оплата.

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

В новом SDK есть новые типы мест, которые возвращаются в составе ответа на новые запросы информации о местах и текстового поиска. Вы также можете использовать эти новые типы и существующие типы в поиске с помощью текстового поиска (New). Новые типы приведены в таблице А.