Aide-mémoire du SDK Maps pour Android

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

Packages officiels du SDK Maps pour Android :

  • maven: com.google.android.gms:play-services-maps

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 avec java.lang.NoClassDefFoundError. Correction : Ajoutez dans la balise du fichier AndroidManifest.xml de 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 valeur MapsInitializer.Renderer transmise à OnMapsSdkInitializedCallback.onMapsSdkInitialized(), ou vérifiez GoogleMap.getMapCapabilities(). Si l'appareil utilise LEGACY, 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

SDK Maps pour Android : styles basés sur les données pour les ensembles de données

SDK Maps pour Android : ensembles de données

SDK Maps pour Android : Maps

SDK Maps pour Android : annotations de cartes

SDK Maps pour Android : style de carte

SDK Maps pour Android : Street View