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.
Prepárate
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
- 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.
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.
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 deMAPS_API_KEY
. propiedad:MAPS_API_KEY=YOUR_API_KEY
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
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.
En Android Studio, haz clic en la opción Run del menú (o en el botón de reproducción). icon); 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
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
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 deMAPS_API_KEY
. propiedad:MAPS_API_KEY=YOUR_API_KEY
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
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.
En Android Studio, haz clic en la opción Run del menú (o en el botón de reproducción). icon); 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 aplicación. 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.