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 {
// Utility Library for Maps SDK for Android
// You do not need to add a separate dependency for the Maps SDK for Android
// since this library builds in the compatible version of the Maps SDK.
implementation 'com.google.maps.android:android-maps-utils:3.8.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 {
// KTX for the Maps SDK for Android Utility Library
implementation 'com.google.maps.android:maps-utils-ktx:5.1.1'
}
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; - différents fichiers contenant la licence, les contributeurs et les informations README ;
- 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.
- Téléchargez le dépôt via l'une des méthodes mentionnées ci-dessus.
- Dans Android Studio, sélectionnez File > New > Import Project.
- 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.
- Si vous utilisez un appareil Android au lieu d'un émulateur, veillez à activer le mode développeur. Associez ensuite l'appareil Android à votre ordinateur.
Ajoutez à
local.propertiesune seule ligne comme celle-ci :MAPS_API_KEY=YOUR_API_KEY
Où YOUR_API_KEY correspond à la clé API obtenue, comme décrit dans Utiliser des clés API.
- 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.