Pour configurer un projet Google Cloud Console afin qu'il utilise le SDK Driver pour Android, procédez comme suit.
- Configurez votre projet d'application mobile.
- Ajoutez le SDK Driver à votre application.
- Ajoutez la clé API à votre application.
- Incluez les attributions requises dans votre application.
Pour en savoir plus sur chaque étape, consultez les sections suivantes.
Configurer votre projet d'application mobile
Cette section explique comment configurer votre projet d'application mobile pour le pilote. SDK.
Pour configurer votre projet d'application mobile, procédez comme suit:
- Si vous ne disposez ni d'un projet de développement dans la console Google Cloud, ni d'une clé API pour votre projet de mobilité, vous devez en configurer un. Pour en savoir plus, consultez Créez votre projet Fleet Engine.
- Dans la console Google Cloud, sélectionnez le même projet et Clé API que vous utilisez pour Fleet Engine.
- Sélectionnez API et des services Google, puis recherchez et activez SDK Maps pour Android.
Ajouter le SDK Driver à votre application
Le SDK Driver est disponible dans le dépôt Maven de Google. Le dépôt qui inclut les fichiers de modèle d'objet de projet (.pom) du SDK et Javadocs.
Pour ajouter le SDK Driver à votre application, ajoutez le SDK Driver et le SDK Navigation à votre configuration Gradle ou Maven.
Dans l'exemple suivant, remplacez VERSION_NUMBER
par la version sélectionnée.
du SDK Driver.
Gradle
Ajoutez les éléments suivants à votre 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
Ajoutez les éléments suivants à votre 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>
Ajouter la clé API à votre application
Une fois que vous avez ajouté le SDK Driver à votre application, ajoutez la clé API. Vous devez utiliser la clé API du projet, obtenue lors de la configuration de votre projet de développement. Pour Pour en savoir plus, consultez Configurer votre projet d'application mobile.
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 simplifier cette tâche, vous pouvez utiliser la documentation GitHub Plug-in Secrets Gradle pour Android :
Pour installer le plug-in et stocker votre clé API, procédez comme suit:
Ouvrez le fichier
build.gradle
au niveau racine et ajoutez le code suivant àdependencies
sousbuildscript
.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") } }
Ouvrez le fichier
build.gradle
au niveau de l'application et ajoutez le code suivant au Élémentplugins
.Groovy
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
Kotlin
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
Si vous utilisez Android Studio, synchronisez votre projet avec Gradle. Pour en savoir plus, consultez Synchroniser votre projet avec Gradle.
Ouvrez
local.properties
dans votre répertoire au niveau du projet, puis ajoutez le code suivant. RemplacezYOUR_API_KEY
par votre clé API.MAPS_API_KEY=YOUR_API_KEY
Dans votre fichier
AndroidManifest.xml
, accédez àcom.google.android.geo.API_KEY
. Mettez à jour l'attributandroid: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.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>
Incluez les attributions requises dans votre application
Si vous utilisez le SDK Driver 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 Inclure des avis Open Source pour découvrir comment inclure des avis open source.