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

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

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

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

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

Ошибка: kGMSPlacesRateLimitExceeded

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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