Referencia rápida del SDK de Navigation para Android

El SDK de Navigation para Android agrega la navegación paso a paso de Google Maps a las apps para Android, con personalización de la IU y configuración de rutas. Incluye la capa del mapa del SDK de Maps, por lo que las apps que la usan no pueden incluir también el SDK de Maps para Android.

SDK de Navigation para Android: Datos clave

  • Producto: SDK de Navigation para Android
  • También conocido como: SDK de Navigation
  • Categoría: Rutas
  • Plataforma: Android
  • Se ejecuta en: El cliente (código de la app o del navegador)
  • Etapa de lanzamiento: GA
  • Ciclo de vida: Activo
  • Descripción general: Descripción general del SDK de Navigation para Android

Cuándo usar el SDK de Navigation para Android

Usa el SDK de Navigation para Android en los siguientes casos:

  • Necesitas la navegación paso a paso de Google Maps dentro de tu propia app para Android para que los usuarios no cambien a otra app.
  • Necesitas personalizar la IU de navegación para que coincida con tu marca o crear una experiencia de navegación personalizada.
  • Necesitas navegación integrada en la app para conducir, caminar, andar en bicicleta o usar vehículos de dos ruedas.
  • Debes navegar por una ruta que planificaste con la API de Routes pasando un token de ruta al SDK.

No uses el SDK de Navigation para Android en los siguientes casos:

SDK de Navigation para Android: Configuración

Paquetes oficiales del SDK de Navigation para Android:

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

SDK de Navigation para Android: Errores comunes

  • Problema: El SDK de Navigation ya incluye el SDK de Maps. Las compilaciones que extraen play-services-maps directamente o a través de una dependencia transitiva terminan con copias duplicadas del SDK de Maps. Solución: Excluye com.google.android.gms:play-services-maps de todas las dependencias (exclusiones de configuraciones de Gradle o de Maven) y quita cualquier dependencia directa del SDK de Maps. Consulta /maps/documentation/navigation/android-sdk/android-studio-setup.
  • Problema: El SDK de Navigation 8.0 y versiones posteriores declara minAndroidGradlePluginVersion=9.0.1, por lo que las compilaciones con un AGP anterior fallan. Solución: Actualiza a AGP 9.0.1, Gradle 9.1.0 y Kotlin 2.3.0 antes de compilar con la versión 8.0 o una posterior. Consulta /maps/documentation/navigation/android-sdk/kotlin-compatibility-migration.
  • Problema: Llamar directamente a los métodos del ciclo de vida de NavigationView mientras se usa NavigationFragment o llamarlos de forma desordenada con NavigationView genera errores. Solución: Usa NavigationFragment, que administra las devoluciones de llamada de ciclo de vida. Si usas NavigationView, reenvía los métodos de ciclo de vida en orden estricto. Consulta /maps/documentation/navigation/android-sdk/nav-map-interactions-best-practices.
  • Problema: La navegación no está disponible hasta que el usuario acepta las Condiciones del Servicio de Navegación de Google. Solución: Deja que el SDK muestre el mensaje la primera vez que se invoque el navegador o muestra el diálogo antes (por ejemplo, durante el registro) con TermsAndConditionsCheckOption o NavigationApi.showTermsAndConditionsDialog. Consulta /maps/documentation/navigation/android-sdk/route.

SDK de Navigation para Android: Funciones heredadas y obsoletas

  • Waypoint fromLatLng() y fromPlaceId(): Retiradas desde el 10 de mayo de 2021. Reemplazo: Waypoint.builder() (Waypoint.Builder). Síntoma: Se quitó en la versión 3.0; las llamadas no se compilan con la versión 3.0 o posterior. Consulta la guía de migración.
  • SupportNavigationFragment: Obsoleto desde el 1 de octubre de 2026. Reemplazo: NavigationFragment. Síntoma: Se dejó de usar en la versión 8.0.0 del SDK de Navigation. Consulta la guía de migración.
  • setLocationMarkerEnabled en NavigationView y SupportNavigationFragment: Se retiró el 7 de julio de 2023. Reemplazo: GoogleMap.setMyLocationEnabled. Síntoma: Se quitó en la versión 5.0.0 (obsoleta en la 4.1); las llamadas no se compilan en la versión 5.0 o posterior.
  • DisplayOptions showTrafficLights y showStopSigns: Retiradas desde el 1 de octubre de 2026. Reemplazo: No se necesita un reemplazo; los semáforos y las señales de pare siempre están habilitados durante la navegación. Síntoma: Las llamadas a estos métodos no se compilan con la versión 8.0.0.
  • Artefacto de Maven com.google.android.maps:navsdk (repositorio privado, v4.x) y descarga del paquete de AAR: Retirado desde el 7 de julio de 2023. Reemplazo: com.google.android.libraries.navigation:navigation del repositorio de Maven de google(). Síntoma: La versión 5.0 y las posteriores se envían solo como com.google.android.libraries.navigation:navigation en Google Maven; el paquete AAR ya no se distribuye. Consulta la guía de migración.

Qué puedes hacer con el SDK de Navigation para Android

Consulta las guías vinculadas a continuación para cada tarea o compara los productos en el Explorador de capacidades.

SDK de Navigation para Android: Maps

SDK de Navigation para Android: anotaciones de Maps

SDK de Navigation para Android: Diseño de mapas

SDK de Navigation para Android: Navegación