Prueba la demostración

Si integras el SDK de Navigation para Android, tu app puede ir más allá de vincular a una vista de mapa externa. Con la navegación de Google Maps, tu app puede ofrecer recuperación dinámica y generación de informes de un solo vistazo sobre los datos del viaje 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.

Esta documentación está diseñada para personas familiarizadas con el desarrollo de Android y los conceptos de programación orientada a objetos. También debes estar familiarizado con el uso de Google Maps desde la perspectiva del usuario.

Obtén las 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 que ya conocen las APIs de Google Maps pueden enfocarse en la demostración de GoogleNavigation. Los desarrolladores que no conozcan ninguno de los dos proyectos encontrarán útiles ambas apps.

A partir de la versión 4.1 del SDK de Navigation para Android, las siguientes apps de demo están disponibles para descargar en GitHub.

  • 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 GoogleMap para personalizar el aspecto y la presentación de los mapas.

Demostración de GoogleNavigation

La demostración más reciente de GoogleNavigation está disponible en GitHub.

Compilación

  1. En Android Studio, importa la app de demostración y permite que se ejecute Gradle.

  2. Abre local.defaults.properties y actualiza el valor de la propiedad MAPS_API_KEY:

      MAPS_API_KEY=YOUR_API_KEY

  3. Haz clic en build y examina los detalles de la implementación del SDK.

    • En la clase de Java, observa el código de implementación.

    • En el XML de diseño, observa el diseño y el texto.

    • En el archivo build.gradle, observa 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.

Ejecutar

  1. 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.

  2. 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 opciones.

Es probable que los usuarios nuevos del SDK de Navigation encuentren 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 NavigationFragment junto con Navigator.

Cuando hagas clic en una de estas opciones, se te presentará 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 la superposición de paneles de control para ver qué sucede cuando llamas a una API. Por ejemplo, haz clic en View Methods para intentar forzar el SDK al modo nocturno y ver cómo se ve.

Opción SwappingMapAndNavActivity

En el SwappingMapAndNavActivity, se muestran los siguientes patrones comunes:

La demostración de GoogleMap

La demostración más reciente de GoogleNavigation está disponible en GitHub.

Compilación

  1. En Android Studio, importa la app de demostración y permite que se ejecute Gradle.

  2. Abre local.defaults.properties y actualiza el valor de la propiedad MAPS_API_KEY:

      MAPS_API_KEY=YOUR_API_KEY

  3. Haz clic en build y examina los detalles de la implementación del SDK.

    • En la clase de Java, observa el código de implementación.

    • En el XML de diseño, observa el diseño y el texto.

    • En el archivo build.gradle, observa el SDK en las dependencias.

Para obtener más información sobre cómo se agrega la clave de API al manifiesto, consulta el complemento de Gradle para Secrets.

Ejecutar

  1. 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.

  2. 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.

Este patrón de presentación y la estructura correspondiente del código fuente deberían ser familiares para los usuarios de las demostraciones del SDK de Google Maps. 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 permite que el usuario elija en qué clase de vista desea probar una demostración: NavigationView o MapView, según corresponda.

Por lo general, Google alienta a los usuarios a usar el NavigationView. Esta demostración proporciona la flexibilidad de probar estos comportamientos en ambas versiones de nuestra app de demostración y elegir la que más te convenga. Por ejemplo, es posible que aún sea necesario usar un MapView en situaciones en las que uses una biblioteca de terceros que espera interactuar con esa clase.