Places SDK для Android (новый) обеспечивает улучшенную производительность и новую модель ценообразования, что делает обновление приложений, использующих Places SDK для Android (устаревший), оправданным. Подробнее о сравнении функций см. в разделе «Выберите свой SDK» .
Используйте это руководство, чтобы понять основные различия между Places SDK для Android (новым) и Places SDK для Android (старым), а также узнать, как вносить необходимые изменения.
Лучшие практики выставления счетов для миграции
Это руководство применимо, если использование API достаточно интенсивно для перехода на тариф второго уровня. При переходе на новую версию API с вас также будет взиматься плата за другой артикул. Чтобы избежать увеличения расходов в течение месяца перехода, мы рекомендуем переходить на новые API в рабочей среде как можно ближе к началу месяца. Это позволит вам достичь наиболее экономически эффективных тарифных планов в течение месяца миграции. Подробнее о тарифных планах см. на странице тарифов и в разделе часто задаваемых вопросов о ценах .
Включить Places SDK для Android (новое)
Places SDK для Android (устаревшая версия) использует сервис Places API . Чтобы использовать функции Places SDK для Android (новая версия), необходимо сначала включить Places API (новая версия) в вашем проекте Google Cloud. Подробнее см. в статье «Настройка проекта Google Cloud» .
Затем необходимо убедиться, что вы добавили Places API (новый) к ключу API, используемому вашим приложением. Подробнее см. в разделе Использование ключей API .
Общие изменения
Некоторые общие изменения, которые применяются к нескольким API, включают:
Использует новую модель ценообразования. Информацию о ценах для всех API см. в разделе Places SDK для Android (новый) .
Для параметров «Сведения о месте (новое)» , «Поиск поблизости (новое)» и «Текстовый поиск (новое)» требуются маски полей, чтобы указать, какие поля вы хотите вернуть в ответе.
Добавлены новые классы для определения запросов или добавления новых полей в ответ.
Объект ответа
Place
содержит новый методgetReviews()
, который возвращает список объектовReview
. Когда ваше приложение отображает информацию, полученную из объектаPlace
, например фотографии и отзывы, оно также должно отображать необходимые данные об авторстве.Более подробную информацию см. в документации по атрибуции .
Изменения, специфичные для API
В этот раздел включены следующие руководства по миграции для каждого API:
- Перенести в сведения о месте (новое)
- Перенести на место фото (новое)
- Переход на автозаполнение (новое)