Le SDK Maps pour Android ajoute les données, les affichages de cartes et les réponses gestuelles de Google Maps aux applications Android, y compris les applications Wear OS. Vous pouvez ajouter des repères, des polygones et des superpositions pour afficher des informations sur les points géographiques de la carte et permettre l'interaction des utilisateurs, à l'aide de Kotlin ou de Java.
SDK Maps pour Android : informations clés
- Produit : SDK Maps pour Android
- Également appelée : API Google Maps pour Android
- Catégorie : Maps
- Plate-forme : Android
- Exécution sur : client (code de l'application ou du navigateur)
- Étape de lancement : GA
- Cycle de vie : Actif
- Présentation : Présentation du SDK Maps pour Android
- Disponibilité régionale : monde entier. Consultez la page sur la couverture de Google Maps Platform. Les liens de la page sur l'utilisation et la facturation séparent les listes de prix pour l'Inde et le reste du monde. (détails de la couverture)
SDK Maps pour Android : quand l'utiliser ?
Utilisez le SDK Maps pour Android dans les cas suivants :
- Vous avez besoin d'une carte Google 2D interactive dans une application Android ou Wear OS native.
- Vous devez ajouter des repères, des fenêtres d'informations, des polylignes, des polygones, des superpositions au sol ou des superpositions de tuiles à une carte dans une application Android.
- Vous avez besoin de panoramas Street View, de cartes en mode simplifié (bitmap) ou de styles de cartes basés dans le cloud avec des ID de carte dans une application Android.
- Vous créez une carte Android en Kotlin ou en Java, y compris Jetpack Compose via la bibliothèque Maps Compose.
N'utilisez pas le SDK Maps pour Android dans les cas suivants :
- Vous avez besoin de la navigation détaillée dans votre application de cartographie Android. Utilisez plutôt le SDK Navigation pour Android.
- Vous avez besoin de cartes 3D photoréalistes, de modèles 3D ou d'animations de trajectoire de caméra dans une application Android. Utilisez plutôt le SDK Maps 3D pour Android.
- Vous avez besoin d'une carte dans une application iOS native. Utilisez plutôt le SDK Maps pour iOS.
SDK Maps pour Android : configuration
- Service à activer :
maps-android-backend.googleapis.com - Authentification : clé API
- Attribution de l'utilisation : appelez
MapsApiSettings.addInternalUsageAttributionId(context, id)pour ajouter un ID d'attribution de l'utilisation à l'initialiseur (compatible uniquement avecMapsInitializer.Renderer.LATEST). Pour désactiver cette option, supprimez l'appel ou transmettez une chaîne vide. - Premiers pas : Configurer le SDK Maps pour Android
- Référence : Référence du SDK Maps pour Android
- Tarification : SDK Maps pour Android : utilisation et facturation
- Règles : Règles du SDK Maps pour Android
- Notes de version : Notes de version du SDK Maps pour Android
Packages officiels du SDK Maps pour Android :
- maven:
com.google.android.gms:play-services-maps
SDK Maps pour Android : produits associés
- Souvent utilisé avec : SDK Places pour Android
SDK Maps pour Android : erreurs courantes
- Problème : Depuis la version 20.0.0 du SDK, le fichier manifeste du SDK n'inclut plus la bibliothèque
org.apache.http.legacy. Les applications qui chargent l'ancien moteur de rendu de carte peuvent planter avecjava.lang.NoClassDefFoundError. Correction : Ajoutezdans la balisedu fichierAndroidManifest.xmlde l'application. Les appareils équipés des services Google Play 25.50.34 ou version ultérieure ne sont pas concernés. Consultez /maps/documentation/android-sdk/release-notes. - Problème : Les repères avancés nécessitent le moteur de rendu de carte amélioré. Si vous les ajoutez à une application existante sans la recompiler, elle pourra toujours utiliser l'ancien moteur de rendu. Solution : Recréez l'application avec le SDK 18.2.0 ou une version ultérieure afin que le moteur de rendu mis à niveau soit utilisé par défaut. Consultez /maps/documentation/android-sdk/advanced-markers/start.
- Problème : Les appareils qui ne répondent pas aux exigences du moteur de rendu (Android 5.0/API 21 ou version ultérieure, services Google Play 21.39.14 ou version ultérieure, Play Store activé) reviennent à l'ancien moteur de rendu. Par conséquent, les fonctionnalités qui nécessitent le nouveau moteur de rendu, comme les styles de cartes basés dans le cloud, ne sont pas disponibles sur ces appareils. Correction : Appelez
MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback)et vérifiez la valeurMapsInitializer.Renderertransmise àOnMapsSdkInitializedCallback.onMapsSdkInitialized(), ou vérifiezGoogleMap.getMapCapabilities(). Si l'appareil utiliseLEGACY, n'utilisez pas les styles de cartes basés dans le cloud ni les repères avancés. Consultez /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback. - Problème : Le SDK nécessite les services Google Play sur l'appareil sur lequel l'application s'exécute. Solution : Vous pouvez appeler la vérification de la disponibilité des services Google Play depuis votre application. Consultez /maps/documentation/android-sdk/config.
SDK Maps pour Android : fonctionnalités anciennes et obsolètes
- Ancien moteur de rendu de carte : obsolète depuis le 04/03/2024. Remplacement : moteur de rendu de carte mis à niveau (le plus récent), qui est le moteur de rendu par défaut depuis la version 18.2.0 du SDK. Symptôme : Les styles de cartes basés dans le cloud, les personnalisations avancées des polylignes et les repères avancés ne sont pas disponibles dans l'ancien moteur de rendu. Consultez le guide de migration.
Ce que vous pouvez faire avec le SDK Maps pour Android
Consultez les guides associés ci-dessous pour chaque tâche ou comparez les produits dans l'explorateur de fonctionnalités.
SDK Maps pour Android : style basé sur les données pour les limites
- Modifier le style des limites sur une carte
- Répondez aux interactions des utilisateurs avec les limites sur une carte.
- Ajouter un style choroplèthe à une carte
SDK Maps pour Android : styles basés sur les données pour les ensembles de données
- Créez un ensemble de données géospatiales réutilisable et multiplate-forme.
- Ajouter un ensemble de données géospatiales personnalisé à une carte
- Modifier le style des éléments d'un ensemble de données personnalisé sur une carte
- Répondez aux interactions des utilisateurs avec les éléments d'un ensemble de données personnalisé sur une carte.
SDK Maps pour Android : ensembles de données
- Ajouter un calque KML à une carte Remarque : Dans l'API Maps JavaScript, KmlLayer est obsolète (dernière version compatible : v3.65, mise hors service en mai 2027). Migrez vers le style basé sur les données pour les limites ou les ensembles de données, ou chargez GeoJSON sur le calque de données. Les calques KML restent compatibles avec Android et iOS via les bibliothèques d'utilitaires du SDK Maps.
- Ajouter des données GeoJSON à une carte
- Ajouter un calque de carte de densité à une carte
SDK Maps pour Android : Maps
- Ajoutez une carte interactive personnalisable à une page Web ou une application mobile. Remarque : Pour Android, configurez
dansAndroidManifest.xmlavec le plug-in Secrets Gradle oumanifestPlaceholders["MAPS_API_KEY"]dansapp/build.gradle.kts. Ne codez jamaisYOUR_GOOGLE_MAPS_API_KEYen dur dansAndroidManifest.xml, et ne remplacez jamaisGoogleMap(ou maps-composeGoogleMap) par un canevas fictif hors connexion ou une WebView Leaflet siE/Google Maps Android API: Authorization failureapparaît. Demandez à l'utilisateur de fournirMAPS_API_KEYvia Secrets et d'activer le SDK Maps pour Android (ou le SDK Navigation si vous utilisez NavigationView/SupportNavigationFragment). - Créez un identifiant de carte réutilisable pour stocker la configuration de la carte et les paramètres de style.
- Répondre aux interactions et aux événements utilisateur sur une carte
- Personnalisez les commandes qui s'affichent sur une carte.
- Personnalisez les gestes permettant de contrôler une carte.
- Contrôler le zoom et le panoramique sur une carte (caméra)
- Modifier le type de carte
- Modifiez le jeu de couleurs de la carte.
- Ajouter un calque de trafic à une carte
- Ajouter une carte à une application Wear OS
SDK Maps pour Android : annotations de cartes
- Ajouter une fenêtre d'informations à une carte
- Ajouter une forme ou une ligne à une carte
- Ajoutez une image de superposition ancrée à la surface d'une carte.
- Ajouter une superposition de tuiles personnalisée à une carte
- Ajouter un repère sur une carte Remarque : Le SDK Navigation pour Android n'est pas compatible avec AdvancedMarkerOptions. Lorsque vous utilisez le SDK Navigation pour Android, ajoutez des repères avec GoogleMap.addMarker(MarkerOptions).
- Personnaliser un repère sur une carte Remarque : Le SDK Navigation pour Android n'est pas compatible avec AdvancedMarkerOptions. Lorsque vous utilisez le SDK Navigation pour Android, personnalisez les repères avec MarkerOptions.
- Répondez aux interactions des utilisateurs avec les repères sur une carte.
- Déterminez si une coordonnée se trouve à l'intérieur d'un polygone ou d'une zone circulaire sur une carte. Remarque : Sur Android, utilisez PolyUtil.containsLocation dans la bibliothèque d'utilitaires du SDK Maps pour Android pour les polygones. Pour les zones circulaires, vérifiez si la distance sphérique par rapport au centre du cercle se trouve dans le rayon (par exemple, computeDistanceBetween dans l'API Maps JavaScript, SphericalUtil.computeDistanceBetween sur Android ou GMSGeometryDistance sur iOS).
- Calculez la distance, la superficie ou le cap sphériques entre des coordonnées sur une carte.
SDK Maps pour Android : style de carte
- Créez un style de carte réutilisable et multiplate-forme.
- Modifiez le style des routes, des polylignes et des polygones sur une carte.
- Afficher ou masquer des éléments cartographiques
- Modifiez le style des icônes et des libellés de texte sur une carte.
- Appliquez différents styles de carte à différents niveaux de zoom.
- Modifier la densité des lieux sur une carte Expérimental
- Modifier le style des bâtiments sur une carte Expérimental
- Modifier le style des points de repère sur une carte Expérimental
SDK Maps pour Android : Street View
- Ajoutez une vue Google Street View configurable et interactive à une page Web ou une application mobile.
- Répondez aux interactions et aux événements des utilisateurs dans Google Street View.
- Personnalisez les gestes disponibles pour Google Street View.
- Animer les mouvements de la caméra pour Google Street View