Configura un proyecto de la consola de Google Cloud

Para configurar y configurar una consola de Google Cloud para usar el SDK para el consumidor para Android, sigue estos pasos.

  1. Configura tu proyecto de desarrollo.
  2. Agrega el SDK para el consumidor a tu app.
  3. Agrega la clave de API a tu app.
  4. Incluye las atribuciones requeridas en tu app.

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 y una clave de API para tu proyecto de movilidad, debes configurar uno. Para obtener más detalles, consulta Crea tu proyecto en la guía de Fleet Engine.

Cuando selecciones tu proyecto de desarrollo para el SDK para el consumidor, selecciona el mismo proyecto de la consola de Google Cloud y la clave de API que usas para Fleet Engine.

Agrega el SDK para el consumidor a tu app

El SDK para el consumidor 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 para el consumidor a tu app, agrega las dependencias del SDK para el consumidor y del SDK de Maps a tu configuración de Gradle o Maven.

En los siguientes ejemplos, reemplaza VERSION_NUMBER por la versión requerida del SDK para el 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:18.1.0"
}

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 para el consumidor a tu app, agrega la clave de API. Debes usar la clave de API del proyecto que obtuviste cuando configuraste tu proyecto de desarrollo. Para obtener 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 tu app pueda hacer referencia a ella de forma más segura. 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 de seguridad de la API.

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

Para instalar el complemento y almacenar tu clave de API, haz lo siguiente:

  1. Abre el archivo build.gradle de 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 detalles, consulta Sincroniza tu proyecto con Gradle en la documentación de Android.

  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 y 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 muestra:

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

Si usas el SDK para el consumidor en tu app, debes incluir el 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" del archivo AAR sin archivar.

Consulta https://developers.google.com/android/guides/opensource para obtener información sobre cómo incluir avisos de código abierto.

¿Qué sigue?

Obtén tokens de autenticación