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: настройка
- Сервис, который нужно включить:
navigationsdk.googleapis.com. - Аутентификация: ключ API.
- Атрибуция использования. Вызовите
MapsApiSettings.addInternalUsageAttributionId(context, id), чтобы добавить идентификатор атрибуции использования в инициализатор. Чтобы отказаться от их использования, удалите вызов или передайте пустую строку. - Начало работы: настройка Navigation SDK для Android
- Справочник: справочник по Navigation SDK для Android.
- Цены: Использование и оплата Navigation SDK для Android
- Правила: Правила Navigation SDK для Android
- Примечания к выпуску: Примечания к выпуску Navigation SDK для Android
Официальные пакеты Navigation SDK для Android:
- maven:
com.google.android.libraries.navigation:navigation
Navigation SDK для Android: сопутствующие товары
- Часто используется с: Routes API, Driver SDK для Android.
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: устаревшие и не поддерживаемые функции
WaypointfromLatLng()и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 и более поздних.DisplayOptionsshowTrafficLightsиshowStopSigns: выведены из эксплуатации с 1 октября 2026 г. Замена. Не требуется. Светофоры и знаки "Стоп" всегда показываются в режиме навигации. Признак. Вызовы этих методов не компилируются в версии 8.0.0.- Артефакт Maven
com.google.android.maps:navsdk(частный репозиторий, версия 4.x) и скачивание пакета AAR: выведены из эксплуатации 7 июля 2023 г. Замена:com.google.android.libraries.navigation:navigationиз репозитория Mavengoogle(). Признак. Версия 5.0 и более поздние поставляются только какcom.google.android.libraries.navigation:navigationв Google Maven. Пакет AAR больше не распространяется. Ознакомьтесь с руководством по переносу.
Возможности Navigation SDK для Android
Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.
Navigation SDK для Android: карты
- Добавьте на веб-страницу или в мобильное приложение настраиваемую интерактивную карту. Примечание. Для 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). - Создайте идентификатор карты, который можно использовать повторно, чтобы хранить настройки конфигурации и стилей карты.
- Реагируйте на действия пользователей и события на карте.
- Настройте элементы управления, которые будут показываться на карте.
- Настройте жесты для управления картой.
- Управление масштабом и панорамированием на карте (камера)
- Изменить тип карты.
- Изменить цветовую схему карты.
- Добавьте на карту слой с информацией о дорожном движении.
Navigation SDK для Android: аннотации на карте
- Добавлять на карту информационное окно.
- Добавьте на карту фигуру или линию.
- Добавьте накладываемое изображение, привязанное к поверхности карты.
- Добавьте на карту накладываемый фрагмент.
- Добавьте маркер на карту. Примечание. Navigation SDK для Android не поддерживает AdvancedMarkerOptions. При использовании Navigation SDK для Android добавляйте маркеры с помощью GoogleMap.addMarker(MarkerOptions).
- Настроить маркер на карте. Примечание. Navigation SDK для Android не поддерживает AdvancedMarkerOptions. При использовании Navigation SDK для Android настраивайте маркеры с помощью MarkerOptions.
- Реагируйте на действия пользователей с маркерами на карте.
Navigation SDK для Android: стили карт
Navigation SDK для Android: навигация
- Добавьте в мобильное приложение интерактивную пошаговую навигацию.
- Укажите пункт назначения для пошаговой навигации.
- Запустите пошаговую навигацию.
- Укажите способ передвижения (на автомобиле, пешком, на двухколесном транспорте, на такси) для запроса маршрута.
- Изменение настроек маршрута для пошаговой навигации.
- Укажите сторону дороги и другие настройки прибытия для пошаговой навигации.
- Укажите перепланированный маршрут для пошаговой навигации с помощью токена маршрута многократного использования.
- Возвращает обновления о прибытии пользователя из сеанса пошаговой навигации.
- Возвращать обновления местоположения пользователя из сеанса пошаговой навигации.
- Возвращает обновленные данные о времени и расстоянии из сеанса пошаговой навигации.
- Возвращает обновления об изменении маршрута из сеанса пошаговой навигации.
- Возвращает обновления ночного режима из сеанса пошаговой навигации.
- Возвращает данные о скорости пользователя во время сеанса пошаговой навигации.
- Настройте элементы интерфейса и управления, которые будут показываться во время пошаговой навигации.
- Добавьте новый элемент интерфейса в пошаговую навигацию.
- Добавьте индикатор выполнения поездки в пошаговую навигацию.
- Настройте объекты, которые будут показываться на карте во время пошаговой навигации.
- Добавьте слой с информацией о дорожном движении в пошаговую навигацию.
- Измените вид камеры и ее поведение для пошаговой навигации.
- Настройте спидометр и оповещения об ограничении скорости для пошаговой навигации.
- Возвращает фид пошаговой навигации в виде серии сообщений для каждого маневра на маршруте.
- Укажите собственные значки маневров для использования в фиде пошаговой навигации.
- Добавьте в приложение Android интерактивную пошаговую навигацию для Android Auto. Предварительная версия
- Предупреждайте пользователей о проблемах на маршруте.
- Позвольте пользователям просматривать информацию о дорожных работах на маршруте до начала навигации.
- Разрешите пользователям сообщать о проблемах на маршруте.
- Разрешите пользователям подтверждать дорожные происшествия на маршруте.
- Добавьте кнопку для сообщения о проблемах на маршруте.