Configurer un projet Android Studio existant

Cette page explique comment configurer un projet Android Studio afin d'utiliser le SDK Maps pour Android sans avoir recours au modèle Google Maps détaillé dans le guide de démarrage rapide.

Le modèle Google Maps configure et ajoute automatiquement une carte de base à un nouveau projet Android Studio. Toutefois, vous pouvez également ajouter une carte à un projet Android qui utilise un autre modèle Android Studio. Pour ce faire, vous devez configurer manuellement votre projet, puis ajouter la carte.

Configurer Android Studio

  1. Android Studio est nécessaire. Si vous ne l'avez pas encore fait, téléchargez-le et installez-le.

  2. Ajoutez le SDK des services Google Play à Android Studio. Le SDK Maps pour Android est intégré au SDK des services Google Play, que vous pouvez ajouter via SDK Manager.

Configurer un projet Cloud et une clé API

Pour configurer un projet Cloud et une clé API :

Mettre à jour le fichier manifeste de l'application

Cette section décrit les paramètres à ajouter à votre fichier AndroidManifest.xml.


Numéro de version des services Google Play

Ajoutez la déclaration suivante à l'élément application pour intégrer la version des services Google Play avec laquelle l'application a été compilée.

<meta-data
    android:name="com.google.android.gms.version"
    android:value="@integer/google_play_services_version" />

Autorisation d'accéder à la position

Si votre application a besoin de géolocaliser l'utilisateur, vous devez demander l'autorisation correspondante dans votre fichier AndroidManifest.xml. Les options sont ACCESS_FINE_LOCATION, qui indique la position exacte de l'utilisateur, et ACCESS_COARSE_LOCATION, qui est moins précise. Pour plus d'informations, consultez le guide des données de localisation.

Pour demander l'autorisation ACCESS_FINE_LOCATION, ajoutez ce code à l'élément manifest :

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

Autorisation de stockage externe

Si vous envisagez d'utiliser la version 8.3 ou ultérieure du SDK des services Google Play, vous n'avez pas besoin de l'autorisation WRITE_EXTERNAL_STORAGE. Si vous ciblez des versions antérieures du SDK des services Google Play, vous devez demander l'autorisation WRITE_EXTERNAL_STORAGE dans l'élément manifest.

<uses-permission
        android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

Bibliothèque Apache HTTP Legacy

Si vous utilisez com.google.android.gms:play-services-maps:16.0.0 ou une version antérieure et que votre application cible le niveau d'API 28 (Android 9.0) ou supérieur, vous devez inclure la déclaration suivante dans l'élément <application> de AndroidManifest.xml. Sinon, ignorez cette déclaration.

<uses-library
    android:name="org.apache.http.legacy"
    android:required="false" />

Ajouter la dépendance Maps

Dans le fichier build.gradle au niveau de votre application, ajoutez la dépendance Maps. Pour plus d'informations, consultez le guide de gestion des versions.

dependencies {
    implementation 'com.google.android.gms:play-services-maps:18.0.1'
    // ...
}

Étapes suivantes

Une fois votre projet configuré, vous pouvez ajouter une carte.