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

Places SDK позволяет искать и извлекать информацию для различных типов мест с помощью текстовой строки или по близости. Places SDK — это устаревшая версия Places SDK (New).

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

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

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

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

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

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

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

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

С Place Details and Text Search вы используете списки полей для управления списком полей, возвращаемых в ответе. Затем вы платите только за запрошенные данные. Использование списка полей — это хорошая практика проектирования, которая гарантирует, что вы не запрашиваете ненужные данные, что помогает избежать ненужного времени обработки и расходов на выставление счетов.

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

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

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