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

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

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

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

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

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

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

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

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

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