Con la integración del SDK de Navigation para Android, tu app puede ir más allá de la vinculación a una vista de mapa externa. Con la navegación de Google Maps, tu app puede ofrecer recuperación dinámica e informes de un solo vistazo de datos sobre el recorrido de un usuario. En esta guía, se explica cómo ejecutar las apps de demostración del SDK de Navigation, que están disponibles en GitHub.
Prepárate
Para comenzar a usar el SDK de Navigation, asegúrate de tener los siguientes elementos.
- Una clave de API aprovisionada para usar con el SDK de Navigation Consulta Cómo usar claves de API para obtener más información sobre cómo crear y restringir claves.
- El artefacto del SDK Asegúrate de que tu proyecto esté configurado para usar Maven para el SDK de Navigation.
- Una o más de las apps de demostración
- Android Studio, el entorno de desarrollo recomendado para compilar una app con el SDK de Navigation
Esta documentación está diseñada para personas que estén familiarizadas con el desarrollo de Android y con conceptos de programación orientada a objetos. También debes conocer Google Maps desde el punto de vista del usuario.
Cómo obtener apps de demostración
Google proporciona dos apps para ayudarte a comprender lo que ofrece el SDK de Navigation además de las APIs de Google Maps, según tu nivel de experiencia. Los desarrolladores familiarizados con las APIs de Google Maps pueden enfocar su atención en la demostración de GoogleNavigation. Los desarrolladores que sean nuevos en ambos proyectos encontrarán útiles ambas apps.
A partir de la versión 4.1 del SDK de Navigation para Android, las siguientes apps de demostración están disponibles en GitHub para descargarlas.
Demostración de GoogleNavigation: Muestra la integración de los comportamientos y las vistas de la API en relación con la experiencia del usuario durante una sesión de navegación guiada.
Demostración de GoogleMap: Muestra comportamientos individuales de la interfaz de
GoogleMap
para personalizar el aspecto y la presentación de los mapas.
La demostración de GoogleNavigation
La demostración más reciente de GoogleNavigation está disponible en GitHub.
Edificio
En Android Studio, importa la app de demostración y permite que se ejecute Gradle.
Abre
local.defaults.properties
y actualiza el valor de la propiedadMAPS_API_KEY
:MAPS_API_KEY=YOUR_API_KEY
Haz clic en Build y examina los detalles de la implementación del SDK.
En la clase Java, anota el código de la implementación.
En el XML de diseño, observa el diseño y el texto.
En el archivo
build.gradle
, anota el SDK en las dependencias.
Consulta la documentación del complemento de Gradle para Secrets para obtener más información sobre cómo se agrega la clave de API al manifiesto.
En ejecución
Conecta un dispositivo Android a tu computadora o usa un emulador.
- Dispositivo Android: Consulta las instrucciones para habilitar las opciones para desarrolladores en tu dispositivo Android y configurar el sistema para que lo detecte.
- Emulatormdash:Usa el Administrador de dispositivos virtuales de Android (AVD) para configurar un dispositivo virtual. Cuando elijas un emulador, asegúrate de seleccionar una imagen que incluya las APIs de Google.
En Android Studio, haz clic en la opción de menú Run (o en el ícono del botón de reproducción) y, luego, elige un destino de implementación.
Cuando se compila y se inicia, la app presenta al usuario una página de destino con una lista de opciones.
Opciones de NavViewActivity y NavFragmentActivity
Es probable que los usuarios nuevos del NavSDK consideren que estas dos opciones son las más útiles.
Opción 1: NavViewActivity
muestra comportamientos con NavigationView
junto con Navigator
.
Opción 2: La segunda opción, titulada NavFragmentActivity
, muestra comportamientos con SupportNavigationFragment
junto con Navigator
.
Cuando hagas clic en una de estas opciones, verás lo siguiente:
- la IU de navegación
- un botón "Establecer destino" en el menú de la app
- una superposición con la que puedes interactuar para invocar métodos de forma dinámica en la API
- un menú ampliado con más opciones
Para comenzar, haz clic en Establecer destino y elige una dirección. Luego, la app simula un viaje desde tu ubicación actual hasta esa dirección. Usa los paneles de control superpuestos para ver qué sucede cuando llamas a una API. Por ejemplo, puedes hacer clic en View Methods para intentar forzar el SDK en modo nocturno y comprobar cómo se ve.
Opción SwappingMapAndNavActivity
SwappingMapAndNavActivity
muestra los siguientes patrones comunes:
- se muestra una
MapView
- cambiar a un
NavigationView
cuando comienza la navegación - regresa a una
MapView
cuando finaliza la navegación
Demostración de GoogleMap
La demostración más reciente de GoogleNavigation está disponible en GitHub.
Edificio
En Android Studio, importa la app de demostración y permite que se ejecute Gradle.
Abre
local.defaults.properties
y actualiza el valor de la propiedadMAPS_API_KEY
:MAPS_API_KEY=YOUR_API_KEY
Haz clic en Build y examina los detalles de la implementación del SDK.
En la clase Java, anota el código de la implementación.
En el XML de diseño, observa el diseño y el texto.
En el archivo
build.gradle
, anota el SDK en las dependencias.
Consulta el complemento de Gradle para secretos para obtener más información sobre cómo se agrega la clave de API al manifiesto.
En ejecución
Conecta un dispositivo Android a tu computadora o usa un emulador.
- Dispositivo Android Consulta las instrucciones para habilitar las opciones para desarrolladores en tu dispositivo Android y configurar el sistema para que lo detecte.
- Emulador: Usa el Administrador de dispositivos virtuales de Android (AVD) para configurar un dispositivo virtual. Cuando elijas un emulador, asegúrate de seleccionar una imagen que incluya las APIs de Google.
En Android Studio, haz clic en la opción Run del menú (o en el ícono del botón de reproducción) y, luego, elige un destino de implementación.
Cuando se compila y se inicia, la app presenta al usuario una página de destino con una lista de demostraciones.
Los usuarios de las demostraciones del SDK de Google Maps deben estar familiarizados con este patrón de presentación y la estructura correspondiente del código fuente. Esto se debe a que la demostración de GoogleMap está diseñada para ser similar a la app de demostración de la API de Google Maps. La diferencia principal es que la demostración del SDK de Navigation le permite al usuario elegir en qué clase de vista desea ejecutar una prueba: NavigationView
o MapView
, cuando corresponda.
Por lo general, Google recomienda a los usuarios que adopten el NavigationView
.
Esta demostración te brinda la flexibilidad de probar estos comportamientos en ambas versiones de nuestra app de demostración y elegir el que te resulte más conveniente. Por ejemplo, es posible que aún sea necesario usar un MapView
en situaciones en las que usas una biblioteca de terceros que espera interactuar con esa clase.