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