Configurar un proyecto de la consola de Google Cloud para usar el SDK de Driver para Android, sigue estos pasos.
- Configura tu proyecto de app para dispositivos móviles.
- Agrega el SDK del controlador a tu app.
- Agrega la clave de API a tu app.
- Incluye las atribuciones requeridas en tu app.
Para obtener más detalles sobre cada paso, consulta las siguientes secciones.
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 SDK de Driver.
Para configurar tu proyecto de app para dispositivos móviles, sigue estos pasos:
- 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 Cómo crear tu proyecto de Fleet Engine.
- En la consola de Google Cloud, selecciona el mismo proyecto de la consola de Google Cloud y la misma clave de API que usas para Fleet Engine.
- 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.
En el siguiente ejemplo, sustituye 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 tu app pueda hacer referencia a ella de manera más segura. Para obtener más información sobre las prácticas recomendadas de seguridad de las claves de API, consulta el artículo de Google Maps Platform sobre prácticas recomendadas de seguridad de las APIs.
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:
Abre el archivo
build.gradle
de nivel raíz y agrega el siguiente código al elementodependencies
enbuildscript
.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") } }
Abre el archivo
build.gradle
a nivel de la app y agrega el siguiente código al elementoplugins
.Groovy
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
Kotlin
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
Si usas Android Studio, sincroniza tu proyecto con Gradle. Para obtener más información, consulta Sincroniza tu proyecto con Gradle.
Abre el archivo
local.properties
en el directorio de nivel de proyecto y, luego, agrega el siguiente código. ReemplazaYOUR_API_KEY
por tu clave de API.MAPS_API_KEY=YOUR_API_KEY
En tu archivo
AndroidManifest.xml
, ve acom.google.android.geo.API_KEY
. Luego, actualiza el atributoandroid: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>
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 un elemento de menú Acerca de.
Puedes encontrar la información de la licencia en el archivo "third_party_licenses.txt" en el archivo AAR sin archivar.
Consulta Cómo incluir avisos de código abierto para obtener información sobre incluyen avisos de código abierto.