Maps SDK для iOS позволяет добавлять в приложения iOS карты, созданные на основе данных из Google Карт. SDK обеспечивает доступ к серверам Google Карт, отображение карты и ответ на жесты пользователя, а также позволяет добавлять на карту маркеры, ломаные линии, наложения на землю и информационные окна.
Maps SDK для iOS: основные факты
- Продукт: Maps SDK для iOS.
- Также называется: Google Maps SDK для iOS.
- Категория: Карты
- Платформа: iOS.
- Где выполняется: на стороне клиента (в коде приложения или браузера).
- Стадия запуска: GA
- Жизненный цикл: активно.
- Обзор: Обзор Maps SDK для iOS
- Регионы: все страны. Перейдите на страницу покрытия платформы Google Карт. На странице использования и оплаты есть ссылки на отдельные прейскуранты для Индии и других стран. (подробнее о покрытии)
Когда использовать Maps SDK для iOS
Используйте Maps SDK для iOS, если:
- Вам нужно добавить интерактивную карту Google с обработкой жестов в нативное приложение для iOS.
- Вам нужно добавить на карту в приложении для iOS маркеры, ломаные линии, наложения или информационные окна.
- Вам нужно показывать панорамы Просмотра улиц в приложении для iOS.
- Вам нужно выполнить обратное геокодирование координат в адреса в приложении для iOS, которое показывает карту.
Когда не следует использовать Maps SDK для iOS
- Вам нужны фотореалистичные 3D-карты в приложении для iOS. Используйте Maps 3D SDK для iOS.
- Вам нужно только открыть место или маршрут в приложении "Google Карты", а не отрисовывать карту в своем приложении. Используйте URL Карт.
Maps SDK для iOS: настройка
- Сервис, который нужно включить:
maps-ios-backend.googleapis.com. - Аутентификация: ключ API.
- Атрибуция использования. Вызовите метод класса
GMSServicesaddInternalUsageAttributionID:(Swift:GMSServices.addInternalUsageAttributionID(_:)), чтобы добавить идентификатор атрибуции использования в инициализатор. Чтобы отказаться от их использования, удалите вызов или передайте пустую строку. - Начало работы: настройка Maps SDK для iOS
- Справочные материалы: справочник по Maps SDK для iOS.
- Цены: использование и оплата Maps SDK для iOS.
- Правила: правила Maps SDK для iOS.
- Примечания к выпуску: Maps SDK для iOS.
Официальные пакеты Maps SDK для iOS:
- swift_package:
https://github.com/googlemaps/ios-maps-sdk
Maps SDK для iOS: сопутствующие товары
- Часто используется с: Geocoding API, Places SDK для iOS.
Maps SDK для iOS: распространенные ошибки
- Проблема. SDK не поддерживает объединяемые библиотеки. Если включить параметр Build Mergeable Library (Создать объединяемую библиотеку) в Xcode, в конечных сборках возникнут ошибки компоновщика. Решение. Оставьте для параметра Build Mergeable Library (Создать объединяемую библиотеку) значение No (Нет), которое используется по умолчанию. Подробнее: /maps/documentation/ios-sdk/config.
- Проблема. Без записей
LSApplicationQueriesSchemesнажатие на логотип Google на карте регистрирует ошибки-canOpenURLдляcomgooglemaps://иgooglechromes://. Решение. ДобавьтеgooglechromesиcomgooglemapsвLSApplicationQueriesSchemesвInfo.plist. Подробнее: /maps/documentation/ios-sdk/config. - Проблема. Использование SDK в расширениях приложений iOS (например, в пользовательской клавиатуре), скорее всего, не будет работать из-за строгих ограничений памяти. Решение. Используйте SDK в основном приложении, а не в расширениях. Подробнее: /maps/documentation/ios-sdk/overview.
- Проблема. SDK не оптимизирован для работы с несколькими окнами или одновременными экземплярами в iPadOS 13 и более поздних версиях, поэтому может работать некорректно. Решение. Тщательно протестируйте сценарии многооконного режима на iPad или избегайте одновременного использования нескольких экземпляров карт. Подробнее: /maps/documentation/ios-sdk/overview.
Maps SDK для iOS: устаревшие и прекращенные функции
- Средство визуализации OpenGL и
setMetalRendererEnabled: выведены из эксплуатации 19 мая 2025 г. Новое решение: средство визуализации Metal (по умолчанию с версии 8.0.0); удалитеsetMetalRendererEnabled. Признак. Поддержка прекращена в версии 9.0.0 (28 мая 2024 г.), удалено в версии 10.0.0.GMSServicesбольше не содержитsetMetalRendererEnabled:. GoogleMapsM4Bmodule: Decommissioned since 2025-05-19. Замена. Удалите pod-файл или фреймворкGoogleMapsM4B, так как он относится к устаревшему тарифному плану. Признак. Поддержка прекращена 20 февраля 2024 г. Удалено из пакета Swift в версии 9.0.0 и из SDK в версии 10.0.0.- Распространение CocoaPods: поддержка прекращена 6 августа 2026 г. Замена: Swift Package Manager. Признак. Режим обслуживания с 18 августа 2025 г. Поддержка прекращена начиная с версии 11.0.0. Ознакомьтесь с руководством по переносу.
- Установка Carthage. Поддержка прекращена 27 июня 2022 г. Замена: Swift Package Manager. Признак. Carthage не поддерживает библиотеки, предназначенные для iOS 13 и более поздних версий. Последняя версия, доступная через Carthage, – 6.2.1. Ознакомьтесь с руководством по переносу.
Что можно делать с помощью Maps SDK для iOS
Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.
Maps SDK для iOS: стили на основе данных для границ
- Изменение стиля границ на карте
- Реагируйте на действия пользователей с границами на карте.
- Добавление стилей картограммы на карту
Maps SDK для iOS: стили на основе данных для наборов данных
- Создайте кросс-платформенный набор геопространственных данных, который можно использовать повторно.
- Добавлять на карту собственные наборы геопространственных данных.
- Изменение стиля объектов набора данных на карте.
- Реагируйте на действия пользователей с объектами собственного набора данных на карте.
Maps SDK для iOS: наборы данных
- Добавление слоя KML на карту. Примечание. В Maps JavaScript API класс KmlLayer больше не поддерживается (последняя поддерживаемая версия – 3.65, поддержка прекращена в мае 2027 г.). Перейдите на стили на основе данных для границ или наборов данных или загрузите GeoJSON в слой данных. Слои KML по-прежнему поддерживаются на Android и iOS через библиотеки утилит Maps SDK.
- Добавлять на карту данные GeoJSON.
- Добавьте на карту слой тепловой карты.
Maps SDK для iOS: геокодирование
Maps SDK для iOS: Maps
- Добавьте на веб-страницу или в мобильное приложение настраиваемую интерактивную карту. Примечание. Для Android: настройте
вAndroidManifest.xmlс помощью плагина Secrets Gradle илиmanifestPlaceholders["MAPS_API_KEY"]вapp/build.gradle.kts. Никогда не задавайтеYOUR_GOOGLE_MAPS_API_KEYвAndroidManifest.xmlв коде и не заменяйтеGoogleMap(или maps-composeGoogleMap) на офлайн-макет холста или Leaflet WebView, если появляетсяE/Google Maps Android API: Authorization failure. Попросите пользователя указатьMAPS_API_KEYв Secrets и включить Maps SDK для Android (или Navigation SDK, если используется NavigationView или SupportNavigationFragment). - Создайте идентификатор карты, который можно использовать повторно, чтобы хранить настройки конфигурации и стилей карты.
- Реагируйте на действия пользователей и события на карте.
- Настройте элементы управления, которые будут показываться на карте.
- Настройте жесты для управления картой.
- Управление масштабом и панорамированием на карте (камера)
- Изменить тип карты.
- Изменить цветовую схему карты.
- Добавьте на карту слой с информацией о дорожном движении.
- Создайте квадродерево для поиска точек в указанной области.
Maps SDK для iOS: аннотации на картах
- Добавлять на карту информационное окно.
- Добавьте на карту фигуру или линию.
- Добавьте накладываемое изображение, привязанное к поверхности карты.
- Добавьте на карту накладываемый фрагмент.
- Добавьте маркер на карту. Примечание. Navigation SDK для Android не поддерживает AdvancedMarkerOptions. При использовании Navigation SDK для Android добавляйте маркеры с помощью GoogleMap.addMarker(MarkerOptions).
- Настроить маркер на карте. Примечание. Navigation SDK для Android не поддерживает AdvancedMarkerOptions. При использовании Navigation SDK для Android настраивайте маркеры с помощью MarkerOptions.
- Реагируйте на действия пользователей с маркерами на карте.
- Определять, находится ли координата внутри многоугольника или круга на карте. Примечание. На устройствах Android используйте PolyUtil.containsLocation в библиотеке утилитарных классов Maps SDK для Android для многоугольников. Для круговых областей проверьте, находится ли геодезическое расстояние от центра круга в пределах радиуса (например, computeDistanceBetween в Maps JavaScript API, SphericalUtil.computeDistanceBetween на Android или GMSGeometryDistance на iOS).
- Вычисляйте сферическое расстояние, площадь или направление между координатами на карте.
Maps SDK для iOS: стили карт
- Создайте кросс-платформенный стиль карты, который можно использовать повторно.
- Изменять стиль дорог, ломаных линий и многоугольников на карте.
- Показывать и скрывать объекты на карте.
- Изменение стиля значков и текстовых меток на карте.
- Применяйте разные стили карты для разных уровней масштабирования.
- Как изменить плотность мест на карте Экспериментальные функции
- Как изменить стиль зданий на карте Экспериментальные функции
- Как изменить стиль ориентиров на карте Экспериментальные функции
Maps SDK для iOS: Просмотр улиц
- Добавьте на веб-страницу или в мобильное приложение настраиваемый интерактивный Просмотр улиц.
- Добавьте маркер или оверлей в Google Просмотр улиц.
- Реагируйте на действия пользователей и события в Google Просмотре улиц.
- Настройте жесты, доступные в Google Просмотре улиц.
- Как анимировать движения камеры в Google Просмотре улиц.