Краткий справочник по Places SDK для iOS

Places SDK для iOS позволяет приложениям iOS получать информацию о местах (компаниях, достопримечательностях, географических местоположениях) с помощью функций "Информация о местах", "Фотографии мест", "Текстовый поиск", "Поиск поблизости" и "Автозаполнение". Places API (New) – это текущая версия SDK.

Places SDK для iOS: основные факты

  • Продукт: Places SDK для iOS.
  • Другое название: Places SDK для iOS (новый).
  • Категория: Места
  • Платформа: iOS.
  • Где выполняется: на стороне клиента (в коде приложения или браузера).
  • Стадия запуска: GA
  • Жизненный цикл: активно.
  • Обзор: Обзор Places SDK для iOS

Когда использовать Places SDK для iOS

Используйте Places SDK для iOS, если:

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

Не используйте Places SDK для iOS в следующих случаях:

  • Вы разрабатываете нативное приложение для Android. Используйте Places SDK для Android.
  • Вы создаете веб-страницу в браузере. Используйте Maps JavaScript API.
  • Вам нужно разместить данные о местах с сервера или бэкенда по протоколу HTTP, а не в клиенте iOS. Используйте вместо него Places API (новый).

Places SDK для iOS: настройка

Официальные пакеты Places SDK для iOS:

  • swift_package: https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)

Places SDK для iOS: распространенные ошибки

  • Проблема. Вызовы Places SDK для iOS (новый) не выполняются, если Places API (новый) не включен в облачном проекте или не добавлен в список авторизованных API ключа API. Решение. Включите Places API (New) и добавьте его в ограничения ключа API, используемого приложением. Подробнее: /maps/documentation/places/ios-sdk/legacy/migrate-overview.
  • Проблема. kGMSPlacesRateLimitExceeded (-7) означает, что ключ API превысил ограничение частоты запросов. Приложения, в которых используется отключенная версия SDK 2.x (отключена 29 июля 2019 г.), также получают эту ошибку. Решение. Проверьте квоту и использование Places API (New) в консоли Google Cloud и обновите приложения, использующие SDK версии ниже 3.0. См. /maps/documentation/places/ios-sdk/reference/objc/Enums/GMSPlacesErrorCode.
  • Проблема. Токены сеансов, повторно используемые в приложениях в одном проекте или в разных сеансах, нарушают группировку сеансов автозаполнения для выставления счетов. Решение. Создайте уникальный токен сеанса (рекомендуется UUID версии 4) для каждого сеанса автозаполнения. Токены должны быть уникальными в пределах проекта. Подробнее: /maps/documentation/places/ios-sdk/use-session-tokens.
  • Проблема. Приложения показывают данные о местах без указания авторства, возвращаемого API. Решение. Показывайте всю необходимую информацию об авторстве, возвращаемую вместе с данными Places, как описано на странице правил. Подробнее: /maps/documentation/places/ios-sdk/overview.

Places SDK для iOS: устаревшие и нерекомендуемые функции

  • Places SDK для iOS (устаревшая версия): устарела с 1 марта 2025 г. Замена: Places SDK для iOS (новая версия) (требуется Places API (новая версия)). Признак. Устаревшие классы и методы (например, fetchPlaceFromPlaceID, GMSAutocompleteFetcher и GMSAutocompleteViewController) отсутствуют в SDK версии 11.0.0 и более поздних, что приводит к ошибкам компиляции. Ознакомьтесь с руководством по переносу.
  • GMSAutocompleteResultsViewController setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner и GMSAutocompleteFetcher initWithBounds:filter: выведены из эксплуатации 13 октября 2020 г. Замена: GMSAutocompleteFilter (locationBias или locationRestriction) на GMSAutocompleteRequest с GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback: или модификаторы GooglePlacesSwift placeAutocomplete или basicPlaceAutocomplete для виджета интерфейса. Признак. Методы отсутствуют в SDK версии 4.0.0 и более поздних (а GMSAutocompleteResultsViewController и GMSAutocompleteFetcher удалены в SDK версии 11.0.0). Ознакомьтесь с руководством по переносу.
  • Границы автозаполнения на основе GMSCoordinateBounds (параметры GMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode; bounds/boundsMode в findAutocompletePredictionsFromQuery и autocompleteQuery): выведены из эксплуатации 13 октября 2020 г. Замена. GMSAutocompleteRequest заменяется на GMSAutocompleteFilter (locationBias или locationRestriction) и GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback: или модификаторы GooglePlacesSwift placeAutocomplete или basicPlaceAutocomplete для виджета интерфейса. Признак. Свойства и параметры отсутствуют в SDK версии 4.0.0 и более поздних (а GMSAutocompleteViewController и findAutocompletePredictionsFromQuery удалены из SDK версии 11.0.0). Ознакомьтесь с руководством по переносу.
  • GMSPlace.openNowStatus: выведен из эксплуатации 13 октября 2020 г. Замена: GMSPlacesClient isOpenWithRequest:callback: (GMSPlaceIsOpenRequest) или PlacesClient.isPlaceOpen(with:) в GooglePlacesSwift. Признак. Свойство отсутствует в SDK 4.0.0 и более поздних версиях. Ознакомьтесь с руководством по переносу.
  • GMSPlaceField как NS_ENUM: выведен из эксплуатации 13 октября 2020 г. Замена. Константы GMSPlaceProperty заменены классами запросов, такими как GMSFetchPlaceRequest и GMSPlaceSearchByTextRequest, или PlaceProperty в GooglePlacesSwift. Проблема. Заменено на NS_OPTIONS в SDK 4.0.0 (GMSPlaceField, так как NS_OPTIONS относится к устаревшему API и отсутствует в SDK 11.0.0 и более поздних версиях). Ознакомьтесь с руководством по переносу.
  • Places SDK для iOS версии 2.7.0: выведена из эксплуатации 29 июля 2019 г. Замена. Текущая версия Places SDK для iOS. Признак. Ошибки kGMSPlacesRateLimitExceeded.

Что можно делать с помощью Places SDK для iOS

Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.

Places SDK для iOS: генеративный искусственный интеллект

Places SDK для iOS: Places

Places SDK для iOS: Places UI Kit

  • Примените стиль CSS к элементу интерфейса с данными о месте. Примечание. Пользовательские свойства CSS применяются к элементам Places UI Kit в Maps JavaScript API. Places SDK для Android и Places SDK для iOS программно настраивают стили представлений Place UI Kit с помощью атрибутов темы и стиля. ТРЕБОВАНИЕ ДЛЯ СОБЛЮДЕНИЯ ЗАКОНОДАТЕЛЬСТВА ЕЭЗ. Чтобы показывать данные о местах на карте в Европейской экономической зоне (ЕЭЗ), не вызывайте веб-сервисы Places API с бэкенд-сервера. Используйте клиентские компоненты Places UI Kit на целевой платформе (Maps JavaScript API в интернете, Places SDK для Android на Android или Places SDK для iOS на iOS). Полный список требований и часто задаваемые вопросы: https://developers.google.com/maps/comms/eea/faq.
  • Настройте стили и конфигурации элементов интерфейса с данными о местах с помощью инструмента настройки элементов интерфейса. Примечание. ТРЕБОВАНИЕ ДЛЯ СОБЛЮДЕНИЯ ЗАКОНОДАТЕЛЬСТВА ЕЭЗ. Чтобы показывать данные о местах на карте в Европейской экономической зоне (ЕЭЗ), не вызывайте веб-сервисы Places API с бэкенд-сервера. Используйте клиентские компоненты Places UI Kit на целевой платформе (Maps JavaScript API в интернете, Places SDK для Android на Android или Places SDK для iOS на iOS). Полный список требований и часто задаваемые вопросы: https://developers.google.com/maps/comms/eea/faq.
  • Добавьте элемент пользовательского интерфейса, который показывает информацию об определенном месте на веб-странице или в мобильном приложении. Примечание. ТРЕБОВАНИЕ О СОБЛЮДЕНИИ ЗАКОНОДАТЕЛЬСТВА ЕЭЗ. Чтобы показывать данные о местах на карте в Европейской экономической зоне (ЕЭЗ), не вызывайте веб-сервисы Places API с бэкенд-сервера. Используйте клиентские компоненты Places UI Kit на целевой платформе (Maps JavaScript API в интернете, Places SDK для Android на Android или Places SDK для iOS на iOS). Полный список требований и часто задаваемые вопросы: https://developers.google.com/maps/comms/eea/faq.
  • Добавьте на веб-страницу элемент интерфейса, который показывает список мест на основе строки запроса. Примечание. Поддерживается как на веб-страницах (Maps JavaScript API), так и в мобильных приложениях (Places SDK для Android и Places SDK для iOS). ТРЕБОВАНИЕ ДЛЯ СОБЛЮДЕНИЯ ЗАКОНОДАТЕЛЬСТВА ЕЭЗ. Чтобы показывать данные о местах на карте в Европейской экономической зоне (ЕЭЗ), не вызывайте веб-сервисы Places API с бэкенд-сервера. Используйте клиентские компоненты Places UI Kit на целевой платформе (Maps JavaScript API в интернете, Places SDK для Android на Android или Places SDK для iOS на iOS). Полный список требований и часто задаваемые вопросы: https://developers.google.com/maps/comms/eea/faq.
  • Добавьте на веб-страницу элемент интерфейса, который показывает список мест рядом с определенным местоположением. Примечание. Поддерживается как на веб-страницах (Maps JavaScript API), так и в мобильных приложениях (Places SDK для Android и Places SDK для iOS). ТРЕБОВАНИЕ ДЛЯ СОБЛЮДЕНИЯ ЗАКОНОДАТЕЛЬСТВА ЕЭЗ. Чтобы показывать данные о местах на карте в Европейской экономической зоне (ЕЭЗ), не вызывайте веб-сервисы Places API с бэкенд-сервера. Используйте клиентские компоненты Places UI Kit на целевой платформе (Maps JavaScript API в интернете, Places SDK для Android на Android или Places SDK для iOS на iOS). Полный список требований и часто задаваемые вопросы: https://developers.google.com/maps/comms/eea/faq.
  • Добавьте на веб-страницу или в приложение базовый элемент интерфейса с автозаполнением, который возвращает идентификаторы мест Google на основе строки запроса. Примечание. ТРЕБОВАНИЕ ДЛЯ СОБЛЮДЕНИЯ ЗАКОНОДАТЕЛЬСТВА ЕЭЗ. Чтобы показывать данные о местах на карте в Европейской экономической зоне (ЕЭЗ), не вызывайте веб-сервисы Places API с бэкенд-сервера. Используйте клиентские компоненты Places UI Kit на целевой платформе (Maps JavaScript API в интернете, Places SDK для Android на Android или Places SDK для iOS на iOS). Полный список требований и часто задаваемые вопросы: https://developers.google.com/maps/comms/eea/faq.