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: настройка
- Сервис, который нужно включить:
navigationsdk.googleapis.com. - Аутентификация: ключ API.
- Также включите: Maps SDK для iOS.
- Атрибуция использования. Вызовите
GMSServices.addInternalUsageAttributionID(_:)(+[GMSServices addInternalUsageAttributionID:]), чтобы добавить идентификатор атрибуции использования в инициализатор. Чтобы отказаться от их использования, удалите вызов или передайте пустую строку. - Начало работы: настройка Navigation SDK для iOS
- Справочная информация: справочник по Navigation SDK для iOS.
- Цены: Статистика использования и оплата Navigation SDK для iOS
- Правила: Правила Navigation SDK для iOS
- Примечания к выпуску: Примечания к выпуску 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: сопутствующие товары
- Часто используется с: Maps SDK для iOS, Routes API, Route Optimization API, Places SDK для iOS.
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 г. Ознакомьтесь с руководством по переносу.
GMSNavigatorsetDestinations: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(). Ознакомьтесь с руководством по переносу. GMSNavigatorcontinueToNextDestination: поддержка прекращена 7 апреля 2026 г. Замена:GMSNavigatorcontinueToNextDestinationWithCompletion:.GMSUISettingsshowsTrafficLightsи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: навигация
- Добавьте в мобильное приложение интерактивную пошаговую навигацию.
- Укажите пункт назначения для пошаговой навигации.
- Запустите пошаговую навигацию.
- Укажите способ передвижения (на автомобиле, пешком, на двухколесном транспорте, на такси) для запроса маршрута.
- Изменение настроек маршрута для пошаговой навигации.
- Укажите сторону дороги и другие настройки прибытия для пошаговой навигации.
- Укажите перепланированный маршрут для пошаговой навигации с помощью токена маршрута многократного использования.
- Возвращает обновления о прибытии пользователя из сеанса пошаговой навигации.
- Возвращать обновления местоположения пользователя из сеанса пошаговой навигации.
- Возвращает обновленные данные о времени и расстоянии из сеанса пошаговой навигации.
- Возвращает обновления об изменении маршрута из сеанса пошаговой навигации.
- Возвращает обновления ночного режима из сеанса пошаговой навигации.
- Возвращает данные о скорости пользователя во время сеанса пошаговой навигации.
- Настройте элементы интерфейса и управления, которые будут показываться во время пошаговой навигации.
- Добавьте новый элемент интерфейса в пошаговую навигацию.
- Добавьте индикатор выполнения поездки в пошаговую навигацию.
- Настройте объекты, которые будут показываться на карте во время пошаговой навигации.
- Добавьте слой с информацией о дорожном движении в пошаговую навигацию.
- Измените вид камеры и ее поведение для пошаговой навигации.
- Настройте спидометр и оповещения об ограничении скорости для пошаговой навигации.
- Возвращает фид пошаговой навигации в виде серии сообщений для каждого маневра на маршруте.
- Укажите собственные значки маневров для использования в фиде пошаговой навигации.
- Добавьте в приложение для iOS интерактивную пошаговую навигацию для CarPlay. Предварительная версия
- Предупреждайте пользователей о проблемах на маршруте.
- Позвольте пользователям просматривать информацию о дорожных работах на маршруте до начала навигации.
- Разрешите пользователям сообщать о проблемах на маршруте.
- Разрешите пользователям подтверждать дорожные происшествия на маршруте.
- Добавьте кнопку для сообщения о проблемах на маршруте.