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.googleapis.com. - Аутентификация: ключ API.
- Атрибуция использования. Вызовите метод класса
addInternalUsageAttributionIDвGMSPlacesClient(Objective-C/Swift) илиPlacesClient(GooglePlacesSwift), чтобы добавить идентификатор атрибуции использования. Если вы удалите вызов, атрибуция будет отключена. - Начало работы: настройка Places SDK для iOS.
- Справочная информация: справочник по Places SDK для iOS.
- Цены: Использование Places SDK для iOS и оплата
- Правила: правила Places SDK для iOS.
- Примечания к выпуску: примечания к выпуску Places SDK для iOS.
Официальные пакеты Places SDK для iOS:
- swift_package:
https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)
Places SDK для iOS: сопутствующие товары
- Часто используется с Maps SDK для iOS.
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 и более поздних, что приводит к ошибкам компиляции. Ознакомьтесь с руководством по переносу. GMSAutocompleteResultsViewControllersetAutocompleteBoundsUsingNorthEastCorner:SouthWestCornerиGMSAutocompleteFetcherinitWithBounds:filter: выведены из эксплуатации 13 октября 2020 г. Замена:GMSAutocompleteFilter(locationBiasилиlocationRestriction) наGMSAutocompleteRequestсGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:или модификаторыGooglePlacesSwiftplaceAutocompleteили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) иGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:или модификаторыGooglePlacesSwiftplaceAutocompleteилиbasicPlaceAutocompleteдля виджета интерфейса. Признак. Свойства и параметры отсутствуют в SDK версии 4.0.0 и более поздних (аGMSAutocompleteViewControllerиfindAutocompletePredictionsFromQueryудалены из SDK версии 11.0.0). Ознакомьтесь с руководством по переносу. GMSPlace.openNowStatus: выведен из эксплуатации 13 октября 2020 г. Замена:GMSPlacesClientisOpenWithRequest: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: генеративный искусственный интеллект
- Возвращает сводку отзывов пользователей на основе искусственного интеллекта для указанного идентификатора места Google.
- Возвращает сводные данные о месте и удобствах вокруг указанного идентификатора места Google для станции зарядки электромобилей, созданные на основе искусственного интеллекта.
Places SDK для iOS: Places
- Возвращает список мест и информацию о них на основе строки запроса.
- Возвращает список мест и информацию о них рядом с определенным местоположением.
- Возвращает результаты автозаполнения для мест на основе строки запроса.
- Возвращает подробную информацию о конкретном месте.
- Возвращает фотографии определенного места. Примечание. Для каждой фотографии должно быть указано авторство (имя автора со ссылкой на его профиль). Это требование содержится в правилах Places API для каждой платформы, например /maps/documentation/javascript/policies#photo-attributions и /maps/documentation/places/web-service/policies#photos-and-review.
- Изменение размера фотографий мест.
- Возвращает оценки и отзывы для определенного места. Примечание. В новом веб-сервисе Places API (New) запрос информации о местах – это GET-запрос к https://places.googleapis.com/v1/places/{placeId} с X-Goog-FieldMask (например, rating,userRatingCount,reviews). Текстовый поиск, поиск поблизости и автозаполнение используют POST. На устройствах Android передайте Place.Field.RATING, USER_RATING_COUNT и REVIEWS в PlacesClient.fetchPlace(). На устройствах iOS передайте GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal и GMSPlacePropertyReviews в GMSFetchPlaceRequest.
- Добавьте на веб-страницу или в приложение виджет автозаполнения, который возвращает результаты о местах на основе строки запроса.
- Укажите поля данных, которые должны быть включены в ответы с информацией о местах.
- Укажите типы мест, которые нужно включить в ответы с информацией о местах.
- Возвращает информацию о месте, где сейчас находится устройство пользователя. Примечание. Устаревшие методы Current Place были удалены из Places SDK для Android версии 6.0 и выше и Places SDK для iOS версии 11.0 и выше. Получите координаты устройства из сервисов геолокации платформы и вызовите Nearby Search.
- Получить обзор от ИИ для определенного места.
- Получать сводку от ИИ с описанием мест в районе вокруг определенного места.
- Возвращает информацию о местах, которые находятся вдоль заданного маршрута, на основе строки запроса.
- Возвращает расстояние, время в пути и URI маршрута для мест, найденных с помощью текстового поиска, на основе набора координат широты и долготы.
- Возвращает расстояние, время в пути и URI маршрута до ближайших мест по набору координат широты и долготы.
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.