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

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

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

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

Когда использовать Navigation SDK для Android

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

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

Когда не следует использовать Navigation SDK для Android

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

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

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

  • maven: com.google.android.libraries.navigation:navigation

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

  • Проблема. Maps SDK уже входит в состав Navigation SDK. Сборки, которые используют play-services-maps напрямую или через транзитивную зависимость, содержат дубликаты Maps SDK. Решение. Исключите com.google.android.gms:play-services-maps из всех зависимостей (исключения конфигураций Gradle или исключения Maven) и удалите все прямые зависимости Maps SDK. Подробнее: /maps/documentation/navigation/android-sdk/android-studio-setup.
  • Проблема. Navigation SDK 8.0 и более поздних версий объявляет minAndroidGradlePluginVersion=9.0.1, поэтому сборки с более ранней версией AGP завершаются ошибкой. Решение. Прежде чем выполнять сборку с версией 8.0+, обновите AGP до версии 9.0.1, Gradle – до 9.1.0, а Kotlin – до 2.3.0. Подробную информацию вы найдете на странице /maps/documentation/navigation/android-sdk/kotlin-compatibility-migration.
  • Проблема. Прямой вызов методов жизненного цикла NavigationView при использовании NavigationFragment или их вызов не по порядку с NavigationView приводит к ошибкам. Решение. Используйте NavigationFragment, который управляет обратными вызовами жизненного цикла. Если вы используете NavigationView, перенаправляйте методы жизненного цикла в строгом порядке. Подробнее: /maps/documentation/navigation/android-sdk/nav-map-interactions-best-practices.
  • Проблема. Навигация недоступна, пока пользователь не примет Условия использования Google Навигации. Решение. Позвольте SDK показать запрос при первом вызове навигатора или покажите диалоговое окно раньше (например, во время регистрации), используя TermsAndConditionsCheckOption/NavigationApi.showTermsAndConditionsDialog. Подробнее: /maps/documentation/navigation/android-sdk/route.

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

  • Waypoint fromLatLng() и fromPlaceId(): выведены из эксплуатации 10 мая 2021 г. Замена: Waypoint.builder() (Waypoint.Builder). Признак: удалено в версии 3.0; вызовы не компилируются в версии 3.0 и более поздних. Ознакомьтесь с руководством по переносу.
  • SupportNavigationFragment: поддержка прекращена 1 октября 2026 г. Замена: NavigationFragment. Признак. Поддержка прекращена в Navigation SDK версии 8.0.0. Ознакомьтесь с руководством по переносу.
  • setLocationMarkerEnabled на NavigationView и SupportNavigationFragment: выведен из эксплуатации 7 июля 2023 г. Замена: GoogleMap.setMyLocationEnabled. Признак. Удалено в версии 5.0.0 (не поддерживается в версии 4.1). Вызовы не компилируются в версии 5.0 и более поздних.
  • DisplayOptions showTrafficLights и showStopSigns: выведены из эксплуатации с 1 октября 2026 г. Замена. Не требуется. Светофоры и знаки "Стоп" всегда показываются в режиме навигации. Признак. Вызовы этих методов не компилируются в версии 8.0.0.
  • Артефакт Maven com.google.android.maps:navsdk (частный репозиторий, версия 4.x) и скачивание пакета AAR: выведены из эксплуатации 7 июля 2023 г. Замена: com.google.android.libraries.navigation:navigation из репозитория Maven google(). Признак. Версия 5.0 и более поздние поставляются только как com.google.android.libraries.navigation:navigation в Google Maven. Пакет AAR больше не распространяется. Ознакомьтесь с руководством по переносу.

Возможности Navigation SDK для Android

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

Navigation SDK для Android: карты

Navigation SDK для Android: аннотации на карте

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

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