A fin de configurar una consola de Google Cloud para usar el SDK del consumidor en Android, sigue estos pasos.
- Configura tu proyecto de desarrollo.
- Agrega el SDK para consumidores a tu app.
- Agrega la clave de API a tu app.
- Incluye las atribuciones requeridas en tu aplicación.
Para obtener más detalles sobre cada paso, consulta las siguientes secciones.
Configura tu proyecto de desarrollo
Si no tienes un proyecto de desarrollo de la consola de Google Cloud ni una clave de API para tu proyecto de movilidad, debes configurar uno. Para obtener más información, consulta Crea tu proyecto en la guía de Fleet Engine.
Cuando selecciones tu proyecto de desarrollo para el SDK de consumidor, elige el mismo proyecto de la consola de Google Cloud y la misma clave de API que usas para Fleet Engine.
Agrega el SDK para consumidores a tu app
El SDK para consumidores está disponible desde un repositorio privado de Maven. El repositorio Incluye los archivos del modelo de objetos del proyecto (.pom) del SDK y Javadocs. Para agregar Consumer SDK para tu app, sigue estos pasos:
Configura tu entorno para acceder al repositorio de Maven host como se describe en Paso 2 de esta guía
Agrega las dependencias del SDK para consumidores y del SDK de Maps a tu Gradle o Maven configuración.
En los siguientes ejemplos, reemplaza
VERSION_NUMBER
por el valor requerido. del SDK de consumidor:Gradle
Agrega lo siguiente a tu
build.gradle
:dependencies { ... implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-consumer:VERSION_NUMBER' implementation "com.google.android.gms:play-services-maps:VERSION_NUMBER" }
Maven
Agrega lo siguiente a tu
pom.xml
:<dependencies> ... <dependency> <groupId>com.google.android.libraries.mapsplatform.transportation</groupId> <artifactId>transportation-consumer</artifactId> <version>VERSION_NUMBER</version> </dependency> <dependency> <groupId>com.google.android.gms</groupId> <artifactId>play-services-maps</artifactId> <version>18.1.0</version> </dependency> </dependencies>
Agrega la clave de API a tu app
Una vez que hayas agregado el SDK de consumidor 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 desarrollo en el paso 3 de esta guía.
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.
Para optimizar esta tarea, puedes usar la documentación de GitHub Secrets Gradle Complemento para Android.
Para instalar el complemento y almacenar tu clave de API, haz lo siguiente:
Abre el archivo
build.gradle
en el 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 en la documentación de Android.
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.consumerapidemo">
<uses-permission android:name="android.permission.ACCESS_FINE_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 para consumidores 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 https://developers.google.com/android/guides/opensource para obtener información sobre cómo incluyen avisos de código abierto.