Configurer un projet dans la console Google Cloud

Pour configurer une console Google Cloud afin d'utiliser le SDK Consumer pour Android, procédez comme suit.

  1. Configurez votre projet de développement.
  2. Ajoutez le SDK Consumer à votre application.
  3. Ajoutez la clé API à votre application.
  4. Incluez les attributions requises dans votre application.

Pour en savoir plus sur chaque étape, consultez les sections suivantes.

Configurer votre projet de développement

Si vous ne disposez pas d'un projet de développement Google Cloud Console ni d'une clé API pour votre projet de mobilité, vous devez en configurer un. Pour en savoir plus, consultez la section Créer votre projet du guide Fleet Engine.

Lorsque vous sélectionnez votre projet de développement pour le SDK client, sélectionnez le même projet de console Google Cloud et la même clé API que ceux que vous utilisez pour Fleet Engine.

Ajouter le SDK Consumer à votre application

Le SDK Consumer est disponible dans le dépôt Maven de Google. Le dépôt inclut les fichiers Project Object Model (.pom) et les Javadocs du SDK. Pour ajouter le SDK Consumer à votre application, ajoutez les dépendances du SDK Consumer et du SDK Maps à votre configuration Gradle ou Maven.

Dans les exemples suivants, remplacez VERSION_NUMBER par la version requise du SDK client:

Gradle

Ajoutez les éléments suivants à votre 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

Ajoutez les éléments suivants à votre 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>

Ajouter la clé API à votre application

Une fois que vous avez ajouté le SDK client à votre application, ajoutez la clé API. Vous devez utiliser la clé API du projet que vous avez obtenue lorsque vous avez configuré votre projet de développement. Pour en savoir plus, consultez la section Configurer votre projet de développement à l'étape 3 de ce guide.

Cette section explique comment stocker votre clé API pour qu'elle puisse être référencée de manière plus sécurisée par votre application. Pour en savoir plus sur les bonnes pratiques de sécurité des clés API, consultez l'article Google Maps Platform sur les bonnes pratiques de sécurité des API.

Pour vous faciliter la tâche, vous pouvez utiliser la documentation GitHub Secrets Gradle Plugin for Android.

Pour installer le plug-in et stocker votre clé API :

  1. Ouvrez votre fichier build.gradle au niveau racine et ajoutez le code suivant à l'élément dependencies sous 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. Ouvrez le fichier build.gradle au niveau de l'application et ajoutez le code suivant à l'élément plugins.

    Groovy

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

    Kotlin

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

  3. Si vous utilisez Android Studio, synchronisez votre projet avec Gradle. Pour en savoir plus, consultez la section Synchroniser votre projet avec Gradle dans la documentation Android.

  4. Ouvrez local.properties dans votre répertoire au niveau du projet, puis ajoutez le code suivant. Remplacez YOUR_API_KEY par votre clé API.

    MAPS_API_KEY=YOUR_API_KEY

  5. Dans votre fichier AndroidManifest.xml, accédez à com.google.android.geo.API_KEY et mettez à jour l'attribut android:value comme suit:

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

L'exemple suivant présente un fichier manifeste complet pour un exemple d'application:

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

Inclure les attributions requises dans votre application

Si vous utilisez le SDK Consumer dans votre application, vous devez inclure le texte d'attribution et les licences Open Source dans la section des mentions légales de votre application. Il est préférable d'inclure les attributions dans un élément de menu indépendant ou dans une section À propos.

Vous trouverez les informations de licence dans le fichier "third_party_licenses.txt" du fichier AAR non archivé.

Consultez https://developers.google.com/android/guides/opensource pour savoir comment inclure des avis Open Source.

Étape suivante

Obtenir des jetons d'authentification