Le dépôt "Maps SDK for Android" sur GitHub inclut des exemples illustrant l'utilisation du SDK Maps pour Android dans votre application Android.
Le dépôt contient l'application ApiDemos. Il s'agit d'une application exemple qui vous permet de créer et d'exécuter les exemples à partir d'une seule application Android. Importez et créez l'application, ajoutez votre clé API, consultez la démonstration et utilisez l'exemple de code fourni comme point de départ pour votre application.
Lorsque vous exécutez l'application exemple, elle affiche une liste d'exemples disponibles que vous pouvez exécuter sur votre appareil. Sélectionnez l'une des options proposées. Par exemple, cliquez sur Basic Map (Carte de base).
Dépannage : Si l'application exemple s'exécute correctement, mais qu'aucune carte ne s'affiche, vérifiez que vous avez bien ajouté la clé API au fichier manifeste de l'application, comme indiqué dans Utiliser des clés API.
Liste d'applications exemples du SDK Maps pour Android
Les principaux exemples d'activités inclus dans l'application ApiDemos du SDK Maps pour Android sont listés ci-dessous et reproduits dans les pages liées pour que vous puissiez les retrouver rapidement. Pour obtenir la liste complète des exemples disponibles, consultez le dossier Kotlin ou Java.
Cloner et exécuter les exemples
Git est requis pour exécuter cet exemple en local. La commande suivante clone le dépôt de l'application exemple.
git clone git@github.com:googlemaps-samples/android-samples.git
Importez le projet exemple dans Android Studio :
- Dans Android Studio, sélectionnez File > New > Import Project (Fichier > Nouveau > Importer un projet).
Accédez à l'emplacement où vous avez enregistré le dépôt et sélectionnez le répertoire du projet pour Kotlin ou Java :
- Kotlin :
PATH-REPO/android-samples/ApiDemos/kotlin
- Java :
PATH-REPO/android-samples/ApiDemos/java
- Kotlin :
- Sélectionnez Ouvrir. Android Studio crée votre projet à l'aide de l'outil de compilation Gradle.
- Créez un fichier
secrets.properties
vide dans le même répertoire que le fichierlocal.properties
de votre projet. Pour en savoir plus, consultez Ajouter votre clé API au projet. Ajoutez la chaîne suivante à
secrets.properties
en remplaçant YOUR_API_KEY par la valeur de votre clé API :MAPS_API_KEY=YOUR_API_KEY
- Exécutez l'application.
Application exemple pour des cartes sous Wear OS
GitHub contient une application exemple pour le SDK Maps pour Android sous Wear OS, que vous pouvez utiliser comme point de départ afin de créer une appli pour wearables. Cet exemple montre comment configurer une carte Google Maps de base sous Wear OS.