Configuration de l'utilitaire du SDK Maps pour Android

Sélectionnez une plate-forme : Android iOS

Cette page explique comment configurer la bibliothèque d'utilitaires du SDK Maps pour Android et exécuter l'application de démonstration incluse dans la bibliothèque.

Prérequis et remarques

La bibliothèque d'utilitaires du SDK Maps pour Android est compatible avec les niveaux d'API Android 15 ou supérieur. Lorsque vous définissez la cible de build de votre projet, veillez à utiliser le niveau d'API Android le plus récent.

La documentation de référence est disponible sur GitHub.

Étape 1. Installer la bibliothèque d'utilitaires du SDK Maps pour Android

Ajoutez la dépendance suivante au fichier build.gradle de votre application :

dependencies {
    implementation 'com.google.maps.android:android-maps-utils:2.3.0'

}

Utilisez l'un des utilitaires de la bibliothèque, par exemple le regroupement des repères, les cartes de densité ou d'autres utilitaires.

Étape 2. (Facultatif) Installer la bibliothèque KTX d'utilitaires du SDK Maps pour Android

La bibliothèque d'utilitaires du SDK Maps pour Android intègre une bibliothèque d'extensions Ktlin (KTX) correspondantes. Cette bibliothèque fournit des fonctionnalités en langage Kotlin, telles que des fonctions d'extension, des arguments nommés et des arguments par défaut, pour vous permettre d'écrire du code Kotlin concis et idiomatique. Si vous ne développez pas en Kotlin, vous pouvez ignorer cette étape.

Pour utiliser cette bibliothèque, ajoutez la dépendance suivante au fichier build.gradle de votre application (en plus de la dépendance android-maps-utils) :

dependencies {
    implementation 'com.google.maps.android:maps-utils-ktx:3.4.0'
}

Pour en savoir plus sur cette bibliothèque, consultez la page GitHub de Maps KTX.

Étape 3. Afficher le code source de la bibliothèque d'utilitaires du SDK Maps pour Android

La bibliothèque d'utilitaires étant Open Source, vous pouvez télécharger la bibliothèque android-maps-utils sur votre ordinateur. Cela vous permettra de la personnaliser, de consulter l'application de démonstration ou simplement de comprendre le fonctionnement de la bibliothèque. Pour ce faire, vous pouvez cloner le dépôt (recommandé pour recevoir les mises à jour automatiques) ou télécharger un fichier ZIP. Si vous souhaitez personnaliser la bibliothèque, vous devez dupliquer le dépôt.

Le dépôt inclut :

  • une application de démonstration, dans le répertoire demo ;
  • la bibliothèque d'utilitaires, dans le répertoire library ;
  • la bibliothèque d'utilitaires du SDK Maps version 3 (BÊTA), dans le répertoire library-v3 ;
  • différents fichiers contenant la licence, les contributeurs et les informations Lisez-moi ;
  • la configuration de compilation Gradle, à utiliser avec Android Studio.

Exécuter l'application de démonstration

Le dépôt GitHub de la bibliothèque d'utilitaires inclut une application de démonstration qui contient des exemples de mise en œuvre de chaque utilitaire. Suivez les étapes ci-après pour exécuter l'application de démonstration sur votre appareil Android.

  1. Téléchargez le dépôt via l'une des méthodes mentionnées ci-dessus.
  2. Dans Android Studio, sélectionnez File > New > Import Project.
  3. Accédez au répertoire android-maps-utils qui a été créé lorsque vous avez cloné la bibliothèque d'utilitaires et double-cliquez dessus pour le sélectionner. Android Studio crée le projet.
  4. Si vous utilisez un appareil Android au lieu d'un émulateur, veillez à activer le mode développeur. Associez ensuite l'appareil Android à votre ordinateur.
  5. Ajoutez à local.properties une seule ligne comme celle-ci :

    MAPS_API_KEY=YOUR_API_KEY

    YOUR_API_KEY correspond à la clé API obtenue, comme décrit dans Utiliser des clés API.

  6. Compilez et exécutez l'application de démonstration.

L'application devrait s'ouvrir sur l'appareil Android et afficher une liste d'utilitaires, dont le regroupement des repères, polyutil, les cartes de densité, etc. L'application se trouve également dans la liste des applications, sous le nom Maps Utils Demo.