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

Navigation SDK для iOS позволяет добавлять в приложения для iOS пошаговую навигацию Google Карт с настройкой интерфейса и маршрутов. Он расширяет возможности Maps SDK для iOS, который предоставляет слой карты и также должен быть установлен в приложении.

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

  • Продукт: Navigation SDK для iOS.
  • Другое название: Navigation SDK.
  • Категория: маршруты.
  • Платформа: iOS.
  • Где выполняется: на стороне клиента (в коде приложения или браузера).
  • Стадия запуска: GA
  • Жизненный цикл: активно.
  • Обзор: Обзор Navigation SDK для iOS
  • Регионы: ограниченное количество. Автомобильные и пешеходные маршруты доступны в большинстве стран. Информация о дорожном движении, сбоях в реальном времени, двухколесном транспорте, велосипедах, ограничениях скорости, светофорах и знаках "Стоп" зависит от страны. (подробнее о покрытии)

Navigation SDK для iOS: когда использовать

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

  • Вам нужно встроить пошаговую навигацию Google Карт в нативное приложение iOS, чтобы пользователям не приходилось переключаться между приложениями.
  • Вам нужно настроить интерфейс навигации, стили карты, камеру или макет в соответствии с вашим брендом во время навигации.
  • Вам нужны настройки маршрута, несколько путевых точек или токен маршрута из Routes API или Route Optimization API.
  • Вам нужны события поездки (местоположение, прибытие, изменения маршрута, расчетное время прибытия) или фид данных с пошаговыми инструкциями для собственного интерфейса навигации или CarPlay.

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

  • Вы разрабатываете приложение для Android. Используйте Navigation SDK для Android.
  • Вы создаете приложение Flutter или React Native. Используйте Google Navigation для Flutter и React Native.
  • Вам нужны только маршруты, расчетное время прибытия или расстояния на сервере, без навигации в приложении. Используйте Routes API.

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

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

  • swift_package: https://github.com/googlemaps/ios-navigation-sdk (GoogleNavigation)

Пакеты, которые не следует использовать с Navigation SDK для iOS:

  • cocoapods: GoogleNavigation. Распространение CocoaPods прекращено в версии 11.0.0, а 18 августа 2025 г. переведено в режим обслуживания. Используйте Swift Package Manager.

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

  • Проблема. Экран тускнеет или выключается во время навигации, потому что SDK не отключает таймер бездействия iOS. Решение. Задайте UIApplication.shared.isIdleTimerDisabled = true во время навигации. Подробнее /maps/documentation/navigation/ios-sdk/route…
  • Проблема. В будущей основной версии SDK будет использоваться альтиметр (CMAltimeter), и приложения без NSMotionUsageDescription в Info.plist будут аварийно завершать работу при инициализации. Добавление ключа сейчас не повлияет на текущее поведение. Решение. Добавьте NSMotionUsageDescription (Privacy – Motion Usage Description) в Info.plist. Подробнее /maps/documentation/navigation/ios-sdk/route…
  • Проблема. Places SDK для iOS не входит в пакет Navigation SDK (начиная с версии Places SDK 5.0), поэтому классы Places отсутствуют. Решение. Установите Places SDK для iOS отдельно, используя ту же версию, что и для Navigation SDK. Подробнее: /maps/documentation/navigation/ios-sdk/xcode-setup.
  • Проблема. При настройке пунктов назначения с помощью токена маршрута возникает ошибка .travelModeUnsupported, если для параметра travelMode приложения не задано значение driving или twoWheeler. Решение. Задайте для mapView.travelMode значение .driving или .twoWheeler. Проверьте resolvedParameters.travelMode, чтобы узнать, какой режим используется для маршрута. Подробнее: /maps/documentation/navigation/ios-sdk/route-customizations.

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

  • Распространение CocoaPods: поддержка прекращена 6 августа 2026 г. Замена: Swift Package Manager. Признак. Режим обслуживания с 18 августа 2025 г. Новые версии CocoaPods не будут выпускаться после второго квартала 2026 г. Ознакомьтесь с руководством по переносу.
  • GMSNavigator setDestinations:callback:, setDestinations:routingOptions:callback:, setDestinations:routeToken:callback: (GMSRouteStatusCallback): поддержка прекращена 2 ноября 2026 г. Замена: setDestinations:completionHandler:, setDestinations:routingOptions:completionHandler:, setDestinationsWithToken:completionHandler: (GMSNavigationRouteCompletionHandler).
  • Свойство экземпляра appCheckTokenProvider в GMSServices устарело с 24 сентября 2026 г. Замена: свойство класса GMSServices.appCheckTokenProvider (+[GMSServices setAppCheckTokenProvider:]). Признак: в версии 11.1.0 не удалось настроить проверку приложений через GMSServices.sharedServices(). Ознакомьтесь с руководством по переносу.
  • GMSNavigator continueToNextDestination: поддержка прекращена 7 апреля 2026 г. Замена: GMSNavigator continueToNextDestinationWithCompletion:.
  • GMSUISettings showsTrafficLights и showsStopSigns: выведены из эксплуатации 6 августа 2026 г. Замена. Не требуется. Светофоры и знаки "Стоп" показываются по умолчанию во время навигации.
  • Тип карты .terrain во время активной навигации выведен из эксплуатации 6 августа 2026 г. Замена: .normal (kGMSTypeNormal), .satellite или тип карты .hybrid.
  • Протоколы GMSNavigatorDelegate и GMSRoadSnappedLocationProviderDelegate выведены из эксплуатации 13 мая 2021 г. Замена: GMSNavigatorListener и GMSRoadSnappedLocationProviderListener (добавьте с помощью -addListener:; задайте timeUpdateThreshold и distanceUpdateThreshold в GMSNavigator). Ознакомьтесь с руководством по переносу.

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

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

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

Navigation SDK для iOS: навигация