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 un entorno y los informes de vista única de datos sobre el recorrido de un usuario. 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 tú debe estar habilitado el SDK para poder 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 las 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 su uso con SDK de Navigation. Debes proporcionar tu projectID, 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 la versión 4.99.0 y anteriores. Si no puedes usar Maven, puedes puedes descargar el artefacto comprimido desde Google Drive compartido. El archivo de biblioteca estática es el archivo .aar de la Directorio libs/ que contiene el SDK de Navigation como Paquete de AAR
  • Una o más de las apps de demostración
  • En 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 conceptos de programación orientados a objetos. También debes estar familiarizado 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 la capa de mapa y la navegación. atributos. 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 que ofrece el SDK de Navigation, además del las APIs de Google Maps, según tu nivel de experiencia. Desarrolladores familiarizados con las APIs de Google Maps pueden centrar su atención en la demostración de GoogleNavigation. Desarrolladores que no tienen experiencia en ambos ambas apps resultarán útiles.

A partir de la versión 4.1 del SDK de Navigation para Android, las siguientes apps de demostración son disponibles en GitHub para que los descargues.

• Demostración de GoogleNavigation: muestra la integración de los comportamientos de la API y vistas relacionadas con la experiencia del usuario en una navegación guiada del usuario.

• Demostración de GoogleMap: muestra comportamientos individuales 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 Maven remoto. con el complemento de Artifact Registry en Gradle. Asegúrate de cumplir 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 AAR sin procesar paquete en tu proyecto, puedes agregarlo a tu proyecto en la libs . Luego, deberás quitar todas las referencias a artifactregistry. y el repositorio remoto correspondiente, y declara el siguiente AAR dependencia en tu build.gradle de nivel de app: api(name: 'google_navigation', ext: “aar”)

La demostración de GoogleNavigation

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

Edificio

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 realizas la actualización. local.defaults.properties por la clave de API aprovisionada.

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

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

En ejecución

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

   • Dispositivo Android: Consulta la instrucciones para habilita las opciones para desarrolladores en tu dispositivo Android y configura el sistema para detectar el dispositivo.
   • Emulatormdash;Uso del dispositivo virtual de Android (AVD) Administrador para configurar un dispositivo virtual. Cuando elijas un emulador, asegúrate de elegir una imagen que incluya las APIs de Google.

2. En Android Studio, haz clic en la opción Run del menú (o en el botón de reproducción). ); y, luego, elige un objetivo de implementación.

Cuando se compila y se lanza, la app presenta al usuario una página de destino de una lista de opciones.

Opciones NavViewActivity y NavFragmentActivity

Es probable que los usuarios nuevos del NavSDK consideren que estas dos opciones útiles.

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

Opción 2: La segunda opción, titulada NavFragmentActivity, muestra los comportamientos con el SupportNavigationFragment junto al Navigator

Cuando hagas clic en una de estas opciones, verás lo siguiente:

• la IU de navegación
• la opción "Definir destino" botón en el menú de la app
• una superposición con la que puedes interactuar para invocar métodos de forma dinámica en el 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. Cómo usar el control y paneles se superponen para ver qué sucede cuando llamas a una API. Por ejemplo, puedes Haz clic en View Methods para forzar el SDK en modo nocturno a fin de ver qué funciona. cómo es el aspecto.

Opción SwappingMapAndNavActivity

Nota: Esta opción te ayuda en la transición de la versión 1 a la 4. Alentamos utilizando NavigationView exclusivamente cuando sea posible, pero proporciona esto como un ejemplo sobre cómo usar ambos de manera mano a mano.

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.

Edificio

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 realices la actualización. local.defaults.properties con la clave de API aprovisionada.

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

     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 secrets Gradle complemento para obtener más información sobre cómo agregar la clave de API al Manifiesto.

En ejecución

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

   • Dispositivo Android Consulta la instrucciones para habilitar las Opciones para desarrolladores en tu dispositivo Android y configurar tu sistema para detectar el dispositivo.
   • Emulador: Usa el dispositivo virtual de Android (AVD). Administrador para configurar un dispositivo virtual. Cuando elijas un emulador, asegúrate de elegir una imagen que incluya las APIs de Google.

2. En Android Studio, haz clic en la opción Run del menú (o en el botón de reproducción). ); y, luego, elige un objetivo de implementación.

Cuando se compila y se lanza, la app presenta al usuario una página de destino de una lista de demostraciones.

Este patrón de presentación y la estructura correspondiente del código fuente deben estar familiarizados con los usuarios de las demostraciones del SDK de Google Maps. Esto se debe a que el La demostración de GoogleMap está diseñada para ser similar a la demostración de la API de Google Maps. de la app. El principal La diferencia es que la demostración del SDK de Navigation le permite al usuario elegir qué clase de vista. le gustaría ejecutar una demostración en: NavigationView o MapView: cuando corresponda.

Por lo general, Google recomienda a los usuarios que utilicen el NavigationView Esta demostración ofrece la flexibilidad de probar estos comportamientos en ambas versiones de a nuestra app de demostración y elige la que mejor se adapte a tus necesidades. Por ejemplo, es posible que aún sea necesario para usar un MapView en situaciones en las que uses un servicio biblioteca que espera interactuar con esa clase.

Importante: El MapView: MapFragment y SupportMapFragment requieren que los dispositivos tengan la aplicación esté instalado. 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 un servicio de Google Play muy desactualizado preinstalado. En esos casos, deberás esperar a que extraiga automáticamente una versión más reciente. o actualiza los Servicios de Play de forma manual a través de Google Play Store.