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

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 SDK для iOS:

  • swift_package: https://github.com/googlemaps/ios-maps-sdk

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:.
  • GoogleMapsM4B module: 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: наборы данных

Maps SDK для iOS: геокодирование

Maps SDK для iOS: Maps

Maps SDK для iOS: аннотации на картах

Maps SDK для iOS: стили карт

Maps SDK для iOS: Просмотр улиц