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

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

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

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

Функция	Версия Places API	Метод инициализации	Минимальная версия SDK
Автозаполнение (новая версия)	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() (поддержка прекращена)
Place Photos	Places API (устаревший)	initialize() (поддержка прекращена)

Прекращена поддержка метода Places.initialize. Используйте вместо него Places.initializeWithNewPlacesApiEnabled(). Чтобы использовать Places.initializeWithNewPlacesApiEnabled(), необходимо включить Places API (New) для ключа API в консоли Google Cloud.

Переход на новые API

Чтобы перейти на новые API, ознакомьтесь со следующими руководствами по переносу данных:

• Переход на информацию о местах (новая функция)
• Переход на Place Photos (New)
• Переход на Autocomplete (New)

Улучшения в 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:

• Автозаполнение (новая версия)
• Place Details (New)
• Поиск поблизости (новая версия)
• Place Photos (New)
• Text Search (New)

Новая версия текстового поиска

Новая версия текстового поиска возвращает информацию о местах на основе введенной фразы, например "кафе в Москве", "обувные магазины в Санкт-Петербурге" или "улица Центральная, 123". Ответ содержит список мест, соответствующих текстовой строке с учетом указанного предпочтительного местоположения.

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

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

• Фотографии мест (новое) добавляет AuthorAttributions в класс PhotoMetadata. AuthorAttributions содержит List объектов AuthorAttribution.

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

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

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

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

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

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

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

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