Configurer un projet dans la console Google Cloud

Pour installer et 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 grand public à 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 dans la console Google Cloud ni d'une clé API pour votre projet de mobilité, vous devez en créer un. Pour en savoir plus, consultez Créez votre projet dans le guide Fleet Engine.

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

Ajouter le SDK grand public à votre application

Le SDK Consumer SDK est disponible à partir d'un dépôt Maven privé. Le dépôt qui inclut les fichiers de modèle d'objet de projet (.pom) du SDK et Javadocs. Pour ajouter le paramètre le SDK grand public à votre application, procédez comme suit:

  1. Configurez votre environnement pour accéder au dépôt Maven de l'hôte, comme décrit dans la section Étape 2 de ce guide.

  2. Ajouter les dépendances du SDK grand public et du SDK Maps à Gradle ou Maven configuration.

    Dans les exemples suivants, remplacez VERSION_NUMBER par les du SDK grand public:

    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:VERSION_NUMBER"
}

    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 grand public à votre application, ajoutez la clé API. Vous devez utiliser la clé API du projet que vous avez obtenue lors de la configuration de votre projet de développement. Pour Pour plus d'informations, consultez la section Configurer votre projet de développement à l'étape 3 de ce guide.

Cette section explique comment stocker votre clé API afin de la sécuriser référencées 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é pour les API.

Pour vous faciliter la tâche, vous pouvez utiliser la documentation GitHub Secrets Gradle Plug-in pour Android.

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

  1. Ouvrez le fichier build.gradle au niveau racine et ajoutez le code suivant à 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é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 Synchronisez 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 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 une application exemple:

    <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 grand public dans votre application, vous devez inclure un texte d'attribution et les licences Open Source dans la section "Mentions légales" de votre application. Il est préférable de inclure les attributions sous forme d'élément de menu indépendant ou dans le cadre d'une section À propos ; l'élément de menu.

Les informations sur la licence sont disponibles dans le fichier "third_party_licenses.txt". dans le fichier AAR désarchivé.

Consultez https://developers.google.com/android/guides/opensource pour découvrir comment inclure des avis open source.

Étape suivante

Obtenir des jetons d'authentification