Aide-mémoire du SDK Maps 3D pour Android

Le SDK Maps 3D pour Android permet aux applications Android d'afficher des cartes 3D interactives créées à partir des images 3D de Google. Elle fournit des repères, des popovers, des polylignes, des polygones, des modèles 3D glTF, des animations de trajectoire de caméra, ainsi que des commandes pour l'interaction utilisateur et le mouvement de la caméra.

SDK Maps 3D pour Android : informations clés

  • Produit : SDK Maps 3D pour Android
  • Également appelé : SDK Maps 3D 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 3D pour Android
  • Disponibilité régionale : limitée. La disponibilité varie selon les pays et les régions. Consultez la colonne "Maps 3D (JavaScript, Android, iOS)" sur la page de couverture de Google Maps Platform. (détails de la couverture)

SDK Maps 3D pour Android : quand l'utiliser

Utilisez le SDK Maps 3D pour Android dans les cas suivants :

  • Vous devez afficher une carte 3D photoréaliste interactive de lieux réels dans une application Android.
  • Vous avez besoin de repères, de popovers, de polylignes, de polygones ou de modèles 3D glTF placés sur une carte 3D dans une application Android.
  • Vous avez besoin d'animations de caméra prédéfinies (survol, rotation) qui guident les utilisateurs entre différents points d'une carte 3D.
  • Vous devez contrôler les mouvements de caméra et les commandes d'interface utilisateur que les utilisateurs peuvent utiliser sur une carte 3D dans une application Android.

N'utilisez pas le SDK Maps 3D pour Android dans les cas suivants :

  • Vous créez une application Web qui nécessite des cartes en 3D. Utilisez plutôt l'API Maps JavaScript.
  • Vous créez une application iOS qui nécessite des cartes 3D. Utilisez plutôt le SDK Maps 3D pour iOS.
  • Vous avez besoin d'un plan de ville 2D standard prêt pour la production dans une application Android (le mode ROADMAP de ce SDK est expérimental). Utilisez plutôt le SDK Maps pour Android.

SDK Maps 3D pour Android : configuration

Packages officiels du SDK Maps 3D pour Android :

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

SDK Maps 3D pour Android : erreurs courantes

  • Problème : Si le mode Plan n'est pas spécifié lors du chargement de la carte, celle-ci ne se charge pas. Correction : Définissez toujours un Map3DMode (SATELLITE, HYBRID ou ROADMAP) dans le fichier XML de mise en page (map3d:mapMode) ou avec setMapMode/Map3DInitConfig. Consultez /maps/documentation/maps-3d/android-sdk/map-modes.
  • Problème : Les écouteurs de clics (clics sur la carte et les repères) ne s'exécutent pas sur le thread UI principal. Par conséquent, les mises à jour directes de l'UI à partir du gestionnaire échouent. Solution : passez au thread principal avant de mettre à jour l'UI, par exemple avec lifecycleScope.launch(Dispatchers.Main). Consultez /maps/documentation/maps-3d/android-sdk/add-a-marker.
  • Problème : l'état de la carte est partagé entre les instances Map3DView. Par conséquent, les repères, les superpositions et la position de la caméra d'une ancienne vue sont reportés sur une nouvelle vue. Correction : ne conservez qu'un seul Map3DView actif. Appelez onDestroy() sur l'ancienne instance, puis effacez manuellement les repères et les superpositions, et réinitialisez la caméra via GoogleMap3D. Consultez /maps/documentation/maps-3d/android-sdk/add-a-3d-map.
  • Problème : Par défaut, appuyer sur un point d'intérêt de la carte de base affiche le widget d'interface utilisateur Places, qui nécessite également la dépendance du SDK Places. Correction : Ajoutez la dépendance du SDK Places pour Android et renvoyez true depuis onMap3DClick dans OnMap3DClickListener pour supprimer le widget par défaut si vous ne le souhaitez pas. Consultez /maps/documentation/maps-3d/android-sdk/points-of-interest.

Ce que vous pouvez faire avec le SDK Maps 3D pour Android

Consultez les guides associés ci-dessous pour chaque tâche ou comparez les produits dans l'explorateur de fonctionnalités.