Probar la demostración

Si integras el SDK de Navigation para Android, tu app puede ir más allá de vincular una vista de mapa externa. Con la navegación de Google Maps, tu app puede ofrecer recuperación dinámica e informes con una sola vista de los datos sobre el recorrido de un conductor.

En esta guía, se proporciona un proyecto de Android Studio, se muestra cómo integrar el SDK de Navigation y, luego, se muestra cómo ejecutar las aplicaciones de demostración.

El SDK de Navigation es una biblioteca estática que te permite controlar el aspecto y el audio de la navegación en tu app. Para obtener detalles sobre la biblioteca, abre la Referencia del SDK de Navigation (Javadoc) en una ventana separada.

Prepárate

Para comenzar a usar el SDK de Navigation, asegúrate de tener los siguientes elementos.

  • Un representante de Google Maps Platform para acceder a lo siguiente:

    • Una clave de API aprovisionada para usar con el SDK de Navigation. Debes proporcionar tu ID del proyecto, que puedes encontrar en el panel principal de la consola de Google Cloud, debajo del nombre del proyecto.
    • El artefacto del SDK. Asegúrate de que tu proyecto esté configurado a fin de usar Maven para el SDK de Navigation.
    • Para proyectos que usan v4.99.0 y versiones anteriores. Si no puedes usar Maven, puedes descargar el artefacto comprimido desde la unidad compartida de Google Drive. El archivo de biblioteca estática es el .aar del directorio libs/ que contiene el SDK de Navigation como un paquete AAR.
    • Una o más de las apps de demostración

  • Android Studio es el entorno de desarrollo recomendado para compilar una app con el SDK de Navigation.

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 Google Maps desde la perspectiva del usuario.

Cómo obtener apps de demostración

Google proporciona dos apps que te ayudan 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 centrar su atención en la demostración de GoogleNavigation. A los desarrolladores nuevos en ambos proyectos les resultarán útiles ambas apps.

A partir del SDK de Navigation para Android versión 4.1, las siguientes apps de demostración están disponibles en la unidad compartida de Google Drive para su descarga.

  • 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 diseño y la presentación de los mapas.

Nota sobre el uso de Maven

Las apps de demostración están configuradas para descargar el artefacto del SDK del repositorio remoto de Maven mediante el complemento de Artifact Registry en Gradle. Asegúrate de seguir las instrucciones de configuración del proyecto para obtener acceso al SDK.

La demostración de GoogleNavigation

La demostración más reciente de GoogleNavigation está disponible en la raíz de la unidad compartida de Google Drive. Las versiones anteriores de la app existen en el archivo. Para las versiones anteriores a la 4.1, la app se empaqueta junto con las AAR en el mismo archivo ZIP.

Edificio

  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 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, anota el SDK en las dependencias.

Consulta la documentación del complemento Secrets Gradle para obtener más información sobre cómo se agrega la clave de API al manifiesto.

Ejecutándose

  1. Conecta un dispositivo Android a tu computadora o usa un emulador.

    • Dispositivo Android: Consulta las instructions 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 uno. Al elegir 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, se presenta al usuario una página de destino con una lista de opciones.

Es probable que los usuarios nuevos de NavSDK consideren que estas dos opciones son las más útiles.

Opción 1: NavViewActivity muestra los comportamientos que usan NavigationView junto con Navigator.

Opción 2: La segunda opción, llamada NavFragmentActivity, muestra los comportamientos que usan SupportNavigationFragment junto con Navigator.

Si haces clic en una de estas opciones, verás lo siguiente:

  • la IU de navegación
  • un botón “Definir 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 forzar el modo nocturno en el SDK y ver cómo se ve.

Opción SwappingMapAndNavActivity

SwappingMapAndNavActivity muestra los siguientes patrones comunes:

  • En el que se muestra un objeto MapView
  • cambiar a NavigationView cuando la navegación comience
  • Mostrar un objeto MapView cuando finaliza la navegación

La demostración de GoogleMap

La demostración más reciente de GoogleNavigation está disponible en la raíz de la unidad compartida de Google Drive. Las versiones anteriores de la app existen en el archivo.

Edificio

  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 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, anota el SDK en las dependencias.

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

Ejecutándose

  1. Conecta un dispositivo Android a tu computadora o usa un emulador.

    • Dispositivo Android Consulta las instructions 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. Al elegir 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 deben resultar 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 le permite al usuario elegir en qué clase de vista desea ejecutar una demostración: NavigationView o MapView, cuando corresponda.

Por lo general, Google recomienda a los usuarios que usen NavigationView. Esta demostración proporciona la flexibilidad para probar estos comportamientos en ambas versiones en nuestra app de demostración y elegir la que funcione para ti. Por ejemplo, es posible que aún sea necesario usar una MapView en situaciones en las que usas una biblioteca de terceros que espera interactuar con esa clase.