Prueba la demostración

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.

Nota: Por el momento, el SDK de Navigation solo está disponible para clientes seleccionados, y debes tener habilitado el SDK si quieres ejecutar las apps de demostración. Para obtener más información, comunícate con Ventas.

Prepárate

Importante: A partir de la versión 3.0 del SDK de Navigation para Android, puedes obtener la versión más reciente del SDK de Navigation para Android desde nuestro repositorio de Maven. Actualmente, este es el método preferido para obtener el SDK. Para obtener más información, consulta Configura tu proyecto.

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

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

  • Una clave de API aprovisionada para usar con el SDK de Navigation Debes proporcionar el 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 para usar Maven con el SDK de Navigation.
  • Para proyectos que usan la versión 4.99.0 y anteriores. Si no puedes usar Maven, puedes descargar el artefacto comprimido desde Google Drive compartido. El archivo de biblioteca estática es el archivo .aar del directorio libs/ que contiene el SDK de Navigation como un paquete de AAR.
  • 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 familiarizadas con el desarrollo de Android y los conceptos de programación orientada a objetos. También debes conocer Google Maps desde el punto de vista del usuario.

Nota: Si tu app ya usa el SDK de Maps, el SDK de Navigation reemplaza al SDK de Maps para las funciones de capa y de navegación. No puedes usar los SDK de Navigation y de Maps en la misma app.

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. A los desarrolladores nuevos de ambos proyectos les resultarán útiles en ambos proyectos.

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: Se muestran comportamientos individuales de la interfaz de GoogleMap para personalizar el aspecto 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 desde el 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.

Nota: Para las versiones 4.99.0 y anteriores, si aún deseas usar el paquete AAR sin procesar en tu proyecto, puedes agregarlo al proyecto en el directorio libs. Luego, debes quitar todas las referencias al complemento artifactregistry y al repositorio remoto correspondiente, y declarar la siguiente dependencia de AAR en tu build.gradle a nivel de la app: api(name: 'google_navigation', ext: 'aar')

.

La demostración de GoogleNavigation

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

En curso

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

   Nota: La app no puede cargar el mapa hasta que actualices local.defaults.properties con la clave de API aprovisionada.

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 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 Secrets Gradle para obtener más información sobre cómo se agrega la clave de API al manifiesto.

En ejecución

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

Opciones 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 que usan NavigationView junto con Navigator.

Opción 2: La segunda opción, titulada NavFragmentActivity, muestra comportamientos con el SupportNavigationFragment junto con el 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 a 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

Nota: Esta opción te ayuda en la transición de la versión 1 a la 4. Te recomendamos que uses NavigationView exclusivamente cuando sea posible, pero incluimos esto como un ejemplo de cómo usar ambos de forma manual.

SwappingMapAndNavActivity muestra los siguientes patrones comunes:

• se muestra una MapView
• cambiar a una NavigationView cuando comienza la navegación
• regresa a una MapView cuando finaliza la navegación

Demostración de GoogleMap

Nota: Esta app no está disponible para las versiones del SDK anteriores a la 4.1.

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

En curso

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

   Nota: La app no podrá cargar el mapa hasta que actualices local.defaults.properties con la clave de API aprovisionada.

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 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 secreto de Gradle para obtener más información sobre cómo se agrega la clave de API al manifiesto.

En ejecución

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 uno de ellos. 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.

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 usen 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, tal vez sea necesario usar un MapView en situaciones en las que usas una biblioteca de terceros que espera interactuar con esa clase.

Importante: Las clases MapView, MapFragment y SupportMapFragment requieren que los dispositivos tengan instalada la aplicación de Servicios de Google Play. Si inicias un emulador nuevo o restableces la configuración de fábrica de un dispositivo antiguo, es posible que la imagen de Android venga con los Servicios de Google Play preinstalados. En esos casos, deberás esperar a que se extraiga automáticamente una versión más reciente o actualizar los Servicios de Play de forma manual a través de Google Play Store.