Configura un proyecto de la consola de Google Cloud

Configurar un proyecto de la consola de Google Cloud para usar el SDK de Driver para Android, sigue estos pasos.

1. Configura tu proyecto de app para dispositivos móviles.
2. Agrega el SDK del controlador a tu app.
3. Agrega la clave de API a tu app.
4. Incluye las atribuciones requeridas en tu aplicación.

Para obtener más detalles sobre cada paso, consulta las siguientes secciones.

Nota: La app debe orientarse a minSdkVersion 23 o una versión posterior.

Cómo configurar tu proyecto de aplicación para dispositivos móviles

En esta sección, se describe cómo configurar tu proyecto de app para dispositivos móviles para el controlador de Google Cloud.

Para configurar tu proyecto de aplicación para dispositivos móviles, sigue estos pasos:

1. Si no tienes un proyecto de desarrollo ni una clave de API de la consola de Google Cloud para tu proyecto de movilidad, debes configurar uno. Para obtener más información, consulta Crea tu proyecto de Fleet Engine.
2. En la consola de Google Cloud, selecciona el mismo proyecto y Clave de API que usas para Fleet Engine.
3. Selecciona APIs y Services y busca y habilita las SDK de Maps para Android.

Agrega el SDK de Driver a tu app

El SDK de Driver está disponible en el repositorio de Maven de Google. El repositorio Incluye los archivos del modelo de objetos del proyecto (.pom) del SDK y Javadocs.

Para agregar el SDK de Driver a tu app, agrega los SDK de Drive y Navigation dependencias a tu configuración de Gradle o Maven.

Nota: El SDK de Driver depende del SDK de Navigation. Establece tu dependencia en un Versión definida explícitamente del SDK de Navigation, como se muestra en este ejemplo. De lo contrario, omite el bloque de código de ejemplo para permitir que el proyecto siempre se descargue. la versión más reciente del SDK de Navigation dentro de la versión de actualización principal. El Los comportamientos combinados de las versiones más recientes del SDK de Driver y Navigation SDK tienen las siguientes características: se sometieron a rigurosas pruebas antes de su lanzamiento.

En el siguiente ejemplo, reemplaza VERSION_NUMBER por la versión seleccionada. del SDK de Driver.

Gradle

Agrega lo siguiente a tu build.gradle:

dependencies {
...
implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-driver:VERSION_NUMBER'
implementation 'com.google.android.libraries.navigation:navigation:5.0.0'
}

Maven

Agrega lo siguiente a tu pom.xml:

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation.driver</groupId>
    <artifactId>transportation-driver</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.libraries.navigation</groupId>
    <artifactId>navigation</artifactId>
    <version>5.0.0</version>
  </dependency>
</dependencies>

Agrega la clave de API a tu app

Una vez que hayas agregado el SDK del controlador a tu app, agrega la clave de API. Debes usar la clave de API del proyecto que obtuviste cuando configuraste el proyecto de desarrollo. Para más detalles, consulta Configura tu proyecto de app para dispositivos móviles.

En esta sección, se describe cómo almacenar tu clave de API para que pueda ser más segura. a los que hace referencia tu app. Para obtener más información sobre las prácticas recomendadas de seguridad de la clave de API, consulta el artículo de Google Maps Platform sobre las prácticas recomendadas sobre la seguridad de las APIs.

Importante: No registres tu clave de API en tu sistema de control de versión. En cambio, almacénalo en el archivo local.properties, que se encuentra en el directorio raíz de tu proyecto. Para obtener más información sobre el archivo local.properties, consulta Archivos de propiedades de Gradle.

Para optimizar esta tarea, puedes usar la documentación de GitHub Complemento Secrets Gradle para Android.

Para instalar el complemento y almacenar tu clave de API, sigue estos pasos:

1. Abre el archivo build.gradle en el nivel raíz y agrega el siguiente código al Elemento dependencies en buildscript.

   Groovy

   buildscript {
         dependencies {
             // ...
             classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0"
         }
   }
   

   Kotlin

   buildscript {
       dependencies {
           // ...
           classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0")
       }
   }
   

2. Abre el archivo build.gradle a nivel de la app y agrega el siguiente código al elemento plugins.

   Groovy

   id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
   

   Kotlin

   id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
   

3. Si usas Android Studio, sincroniza tu proyecto con Gradle. Para obtener más información, consulta Sincroniza tu proyecto con Gradle.

4. Abre el archivo local.properties en el directorio de nivel de proyecto y, luego, agrega el siguiente código. Reemplaza YOUR_API_KEY por tu clave de API.

   MAPS_API_KEY=YOUR_API_KEY

5. En tu archivo AndroidManifest.xml, ve a com.google.android.geo.API_KEY. Luego, actualiza el atributo android:value de la siguiente manera:

       <meta-data
           android:name="com.google.android.geo.API_KEY"
           android:value="${MAPS_API_KEY}" />

En el siguiente ejemplo, se muestra un manifiesto completo para una app de ejemplo:

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
        package="com.example.driverapidemo" >
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
        <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
        <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="${MAPS_API_KEY}" />

            <activity android:name=".MainActivity" >
                <intent-filter>
                    <action android:name="android.intent.action.MAIN" />
                    <category android:name="android.intent.category.LAUNCHER" />
                </intent-filter>
            </activity>
        </application>
    </manifest>

Nota: Para obtener la mejor experiencia de navegación, el conductor debe otorgar lo siguiente: permisos: android.permission.ACCESS_COARSE_LOCATION y android.permission.ACCESS_FINE_LOCATION Asegúrate de solicitar ambos en tiempo de ejecución dentro de la app.

Incluye las atribuciones requeridas en tu aplicación

Si usas el SDK de Driver en tu app, debes incluir texto de atribución y las licencias de código abierto como parte de la sección de avisos legales de tu app. Lo mejor es incluir las atribuciones como un elemento de menú independiente o como parte de una campaña Acerca de elemento de menú.

Puede encontrar la información de la licencia en el archivo "third_party_licenses.txt" archivo en el archivo AAR desarchivado.

Consulta Cómo incluir avisos de código abierto para obtener información sobre incluyen avisos de código abierto.

¿Qué sigue?

Cómo declarar dependencias