Comenzar

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 vista única de datos sobre el viaje de un conductor.

En esta guía, se muestra un proyecto de Android Studio, cómo integrar el SDK de Navigation y cómo ejecutar la app de demostración que se proporciona con el SDK.

El SDK de Navigation es una biblioteca estática (.aar) que te permite controlar la apariencia 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 para Android, 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 archivo ZIP que contiene lo siguiente:

      • El archivo de biblioteca estática .aar en el directorio libs/ que contiene el SDK de Navigation como un paquete de aar
      • Archivos de texto para licencias y vínculos a Condiciones de Uso y acuerdos.
      • Una app de demostración para importar como un proyecto nuevo en Android Studio. Los archivos de la app para compilar la app de demostración en Android Studio con Gradle y Maven.

  • 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 estar familiarizado con Google Maps como usuario.

Obtén el SDK, la app de demostración y la documentación

Después de descargar y descomprimir el archivo del SDK, puedes examinar y ejecutar la app de demostración.

La app de demostración proporciona una compilación que implementa una clase NavigationFragment y una variante que implementa una clase NavigationView. La variante NavigationFragment se ejecuta de forma predeterminada y muestra una ruta de navegación, como se indica en la siguiente imagen.

  1. Con tu administrador de archivos favorito, ve al directorio con los archivos del SDK.

  2. Copia la biblioteca del SDK de Navigation en el directorio app/libs del proyecto demo:

    Por ejemplo, puedes ejecutar cp libs/*.aar demo/app/libs en tu terminal de Linux.

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

  4. Abre el AndroidManifest.xml de la app y actualiza el valor de la propiedad API_KEY:

    <?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.navigationapidemo" >

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/_AppTheme" >

        <meta-data
            android:name="com.google.android.geo.API_KEY"
            android:value="YOUR_API_KEY"/>
    </application>
</manifest>

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

Ejecuta la app

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

  3. En la app de demostración de Navigation, elige Set Destination y sigue las indicaciones para seleccionar una ubicación y, luego, iniciar la navegación simulada.

Cómo compilar la variante de vista

La app de demo incluye una variante de View.

  1. En Android Studio, abre la app de demostración y haz clic en la pestaña Build Variants de la ventana Build.

  2. En la ventana Build Variants, selecciona viewDebug y la lista de archivos cambiará.

  3. Revisa los detalles de implementación del SDK para la clase NavigationView.

    • En NavViewActivity.java, anota el código de implementación.

    • En Activity_Nav_View.xml, observa el diseño y el texto.

  4. Compila y ejecuta la app. El nombre de la app cambia para indicar qué versión se compiló. De lo contrario, solo el objeto de renderización es diferente.

Próximo paso

Integra el SDK de Navigation para Android en tu propia app.