Обзор миграции

Places SDK для iOS (новый) обеспечивает улучшенную производительность и новую модель ценообразования, что делает целесообразным обновление приложений, использующих Places SDK для iOS (устаревший). Подробнее о сравнении функций см. в разделе «Выберите свой SDK» .

Используйте это руководство, чтобы понять основные различия между Places SDK для iOS (новая версия) и Places SDK для iOS (устаревшая версия), а также узнать, как вносить необходимые изменения.

Лучшие практики выставления счетов для миграции

Это руководство применимо, если использование API достаточно интенсивно для перехода на тариф второго уровня. При переходе на новую версию API с вас также будет взиматься плата за другой артикул. Чтобы избежать увеличения расходов в течение месяца перехода, мы рекомендуем переходить на новые API в рабочей среде как можно ближе к началу месяца. Это позволит вам достичь наиболее экономически эффективных тарифных планов в течение месяца миграции. Подробнее о тарифных планах см. на странице тарифов и в разделе часто задаваемых вопросов о ценах .

Ошибка: kGMSPlacesRateLimitExceeded

Примечание: Если в вашем приложении iOS возникают ошибки kGMSPlacesRateLimitExceeded , возможно, вы используете устаревшую версию API Places. Версия 2.7.0 API Places устарела 29 января 2019 г. и была отключена 29 июля 2019 г. Доступна новая версия API Places. Рекомендуем обновиться до новой версии как можно скорее. Подробности см. в руководстве по миграции .

Включить Places SDK для iOS (новое)

Places SDK для iOS использует сервис Places API . Чтобы использовать функции Places SDK для iOS (новый), необходимо сначала включить Places API (новый) в вашем проекте Google Cloud. Подробнее см. в статье «Настройка проекта Google Cloud» .

Затем необходимо убедиться, что вы добавили Places API (новый) к ключу API, используемому вашим приложением. Подробнее см. в разделе Использование ключей API .

Общие изменения

Некоторые общие изменения, которые применяются к нескольким API, включают:

• Использует новую модель ценообразования. Информацию о ценах для всех API см. в разделе «Цены на Places SDK для iOS (новый)» .

• Для параметров «Сведения о месте (новое)» , «Поиск поблизости (новое)» и «Текстовый поиск (новое)» требуются маски полей, чтобы указать, какие поля вы хотите вернуть в ответе.

• GMSPlacesClient содержит новые методы для вызова этих новых API.

• Добавлены новые классы для определения запроса к каждому из новых API.

• Экземпляр GMSPlace ответа содержит новое свойство reviews типа GMSPlaceReview . Когда ваше приложение отображает информацию, полученную из экземпляра GMSPlace , такую как фотографии и отзывы, оно также должно отображать необходимые атрибуции.

  Более подробную информацию см. в документации по атрибуции .

Примечание: поскольку текстовый поиск (новый) и поиск поблизости (новый) были добавлены в Places SDK для iOS и не заменили какие-либо существующие API, для их использования не требуется миграция.

Изменения, специфичные для API

В этот раздел включены следующие руководства по миграции для каждого API:

• Перенести в сведения о месте (новое)
• Перенести на место фото (новое)
• Переход на автозаполнение (новое)