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