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:
- Estás compilando la app para iOS. En su lugar, usa el SDK de Navigation para iOS.
- Estás compilando una app multiplataforma con Flutter o React Native. En su lugar, usa la Navegación de Google para Flutter y React Native.
- Necesitas el cálculo de la ruta, la hora estimada de llegada o el token de ruta del lado del servidor, no las instrucciones paso a paso en la app. En su lugar, usa la API de Routes.
SDK de Navigation para Android: Configuración
- Servicio que se habilitará:
navigationsdk.googleapis.com - Autenticación: Clave de API
- Atribución de uso: Llama a
MapsApiSettings.addInternalUsageAttributionId(context, id)para agregar un ID de atribución de uso al inicializador. Para inhabilitar la función, borra la llamada o pasa una cadena vacía. - Comienza a usar el SDK de Navigation para Android: Configura el SDK de Navigation para Android
- Referencia: Referencia del SDK de Navigation para Android
- Precios: Uso y facturación del SDK de Navigation para Android
- Políticas: Políticas del SDK de Navigation para Android
- Notas de la versión: Notas de la versión del SDK de Navigation para Android
Paquetes oficiales del SDK de Navigation para Android:
- maven:
com.google.android.libraries.navigation:navigation
SDK de Navigation para Android: Productos relacionados
- Se suele usar con: API de Routes, SDK de Driver para Android
SDK de Navigation para Android: Errores comunes
- Problema: El SDK de Navigation ya incluye el SDK de Maps. Las compilaciones que extraen
play-services-mapsdirectamente o a través de una dependencia transitiva terminan con copias duplicadas del SDK de Maps. Solución: Excluyecom.google.android.gms:play-services-mapsde 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
NavigationViewmientras se usaNavigationFragmento llamarlos de forma desordenada conNavigationViewgenera errores. Solución: UsaNavigationFragment, que administra las devoluciones de llamada de ciclo de vida. Si usasNavigationView, 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
TermsAndConditionsCheckOptionoNavigationApi.showTermsAndConditionsDialog. Consulta /maps/documentation/navigation/android-sdk/route.
SDK de Navigation para Android: Funciones heredadas y obsoletas
WaypointfromLatLng()yfromPlaceId(): 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.setLocationMarkerEnabledenNavigationViewySupportNavigationFragment: 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.DisplayOptionsshowTrafficLightsyshowStopSigns: 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:navigationdel repositorio de Maven degoogle(). Síntoma: La versión 5.0 y las posteriores se envían solo comocom.google.android.libraries.navigation:navigationen 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
- Agrega un mapa interactivo y personalizable a una página web o app para dispositivos móviles. Nota: En Android, configura
enAndroidManifest.xmlcon el complemento Secrets de Gradle omanifestPlaceholders["MAPS_API_KEY"]enapp/build.gradle.kts. Nunca codifiquesYOUR_GOOGLE_MAPS_API_KEYenAndroidManifest.xml, y nunca reemplacesGoogleMap(o maps-composeGoogleMap) con un lienzo simulado sin conexión o un WebView de Leaflet si apareceE/Google Maps Android API: Authorization failure. Indícale al usuario que proporcioneMAPS_API_KEYa través de Secrets y habilite el SDK de Maps para Android (o el SDK de Navigation cuando use NavigationView o SupportNavigationFragment). - Crea un identificador de mapa reutilizable para almacenar la configuración y los parámetros de diseño del mapa.
- Responder a las interacciones y los eventos de los usuarios en un mapa
- Personaliza los controles que aparecen en un mapa.
- Personaliza los gestos para controlar un mapa.
- Controlar el zoom y el desplazamiento lateral en un mapa (cámara)
- Cambia el tipo de mapa.
- Cambiar el esquema de colores del mapa
- Agrega una capa de tráfico a un mapa.
SDK de Navigation para Android: anotaciones de Maps
- Agrega una ventana de información a un mapa.
- Agrega una forma o una línea a un mapa.
- Agrega una imagen de superposición fijada a la superficie de un mapa.
- Agrega una superposición de mosaicos personalizada a un mapa.
- Agrega un marcador a un mapa. Nota: El SDK de Navigation para Android no admite AdvancedMarkerOptions. Cuando uses el SDK de Navigation para Android, agrega marcadores con GoogleMap.addMarker(MarkerOptions).
- Personalizar un marcador en un mapa Nota: El SDK de Navigation para Android no admite AdvancedMarkerOptions. Cuando uses el SDK de Navigation para Android, personaliza los marcadores con MarkerOptions.
- Responder a las interacciones de los usuarios con los marcadores de un mapa
SDK de Navigation para Android: Diseño de mapas
SDK de Navigation para Android: Navegación
- Agrega navegación interactiva paso a paso a una app para dispositivos móviles.
- Establece el destino para la navegación paso a paso.
- Inicia la navegación paso a paso.
- Especifica el medio de transporte (en automóvil, a pie, en vehículo de dos ruedas o en taxi) para una solicitud de ruta.
- Modificar las preferencias de ruta para la navegación paso a paso
- Especifica el lado de la ruta y otras preferencias de llegada para la navegación paso a paso.
- Especifica una ruta replanificada para la navegación paso a paso con un token de ruta reutilizable.
- Devuelve actualizaciones de llegada del usuario desde una sesión de navegación paso a paso.
- Devuelve actualizaciones de la ubicación del usuario desde una sesión de navegación paso a paso.
- Devuelve actualizaciones de tiempo y distancia de una sesión de navegación paso a paso.
- Devuelve las actualizaciones de los cambios de ruta de una sesión de navegación paso a paso.
- Devuelve las actualizaciones del modo nocturno de una sesión de navegación paso a paso.
- Devuelve las actualizaciones de velocidad del usuario de una sesión de navegación paso a paso.
- Personaliza los elementos y controles de la IU que aparecen durante la navegación paso a paso.
- Agrega un nuevo elemento de la IU a la navegación paso a paso.
- Agrega un indicador de progreso del viaje a la navegación paso a paso.
- Personaliza los elementos del mapa que aparecen durante la navegación paso a paso.
- Agrega una capa de tráfico a la navegación paso a paso.
- Modifica la vista y el comportamiento de la cámara para la navegación paso a paso.
- Personaliza las alertas del velocímetro y del límite de velocidad para la navegación paso a paso.
- Devuelve un feed de navegación paso a paso como una serie de mensajes para cada maniobra a lo largo de la ruta.
- Especifica íconos de maniobra personalizados para usarlos con un feed de navegación paso a paso.
- Agrega navegación interactiva paso a paso para Android Auto a una app para Android. Versión preliminar
- Alertar a los usuarios sobre interrupciones en su ruta
- Permite que los usuarios vean las interrupciones en su ruta antes de iniciar la navegación.
- Permite que los usuarios informen interrupciones en su ruta.
- Permite que los usuarios verifiquen las interrupciones en su ruta.
- Agrega un botón personalizado para informar interrupciones en la ruta.