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
ROADMAPde ce SDK est expérimental). Utilisez plutôt le SDK Maps pour Android.
SDK Maps 3D pour Android : configuration
- Service à activer :
mapsandroid.googleapis.com - Authentification : clé API
- Premiers pas : Configurer le SDK Maps 3D pour Android
- Référence : Référence du SDK Maps 3D pour Android
- Tarification : Utilisation et facturation du SDK Maps 3D pour Android
- Règles : Règles du SDK Maps 3D pour Android
- Notes de version : Notes de version du SDK Maps 3D pour Android
Packages officiels du SDK Maps 3D pour Android :
- maven:
com.google.android.gms:play-services-maps3d
SDK Maps 3D pour Android : produits associés
- Souvent utilisé avec : SDK Places pour Android
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,HYBRIDouROADMAP) dans le fichier XML de mise en page (map3d:mapMode) ou avecsetMapMode/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 seulMap3DViewactif. AppelezonDestroy()sur l'ancienne instance, puis effacez manuellement les repères et les superpositions, et réinitialisez la caméra viaGoogleMap3D. 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
truedepuisonMap3DClickdansOnMap3DClickListenerpour 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.
- Ajoutez une carte 3D photoréaliste interactive à une page Web.
- Ajouter un repère à une carte 3D photoréaliste
- Personnaliser un repère sur une carte 3D photoréaliste
- Ajouter un modèle 3D à une carte 3D photoréaliste
- Ajouter une polyligne 3D à une carte 3D photoréaliste
- Ajoutez un polygone 3D à une carte 3D photoréaliste.
- Répondez aux interactions et aux événements des utilisateurs sur une carte 3D photoréaliste.
- Personnalisez les commandes qui s'affichent sur une carte 3D photoréaliste.
- Contrôlez la trajectoire de la caméra et les animations sur une carte 3D photoréaliste.
- Contrôlez les restrictions de la caméra sur une carte 3D photoréaliste.