GoogleMap

Cartes satellite présentant un calque transparent de rues principales.

Aucune carte de base.

Cartes de base

Cartes satellite sans libellés.

Cartes du relief.

Ajouter un cercle à cette carte

Ajoute une image à cette carte.

Ajoute un repère à cette carte.

L'icône du repère s'affiche sur la carte à l'emplacement Marker.position. Cliquez sur le repère pour centrer la caméra dessus. Si Marker.title est défini, une carte contenant le titre et l'extrait du repère s'affiche sur la carte. Si vous pouvez déplacer le repère, cliquez dessus de manière prolongée, puis faites-le glisser pour le déplacer.

Ajoute un polygone à cette carte.

Ajoute une polyligne à cette carte.

Ajoute une superposition de tuiles à cette carte. Pour en savoir plus, consultez TileOverlay.

Notez que, contrairement aux autres superpositions, si la carte est recréée, les superpositions de tuiles ne sont pas automatiquement restaurées et doivent être rajoutées manuellement.

Anime le mouvement de la caméra de la position actuelle à la position définie dans la mise à jour. Pendant l'animation, un appel à getCameraPosition() renvoie un emplacement intermédiaire de la caméra.

Consultez CameraUpdateFactory pour obtenir un ensemble de mises à jour.

Anime le mouvement de la caméra de la position actuelle à la position définie dans la mise à jour et appelle un rappel facultatif une fois l'opération terminée. Consultez CameraUpdateFactory pour obtenir un ensemble de mises à jour.

Pendant l'animation, un appel à getCameraPosition() renvoie un emplacement intermédiaire de la caméra.

Déplace la carte en fonction de la mise à jour avec une animation sur une durée spécifiée, et appelle un rappel facultatif une fois l'opération terminée. Consultez CameraUpdateFactory pour obtenir un ensemble de mises à jour.

Si la fonction getCameraPosition() est appelée pendant l'animation, elle renvoie la position actuelle de la caméra en cours de diffusion.

Supprime tous les repères, les polylignes, les polygones, les superpositions, etc. de la carte.

Récupère la position actuelle de la caméra.

Le CameraPosition renvoyé est un instantané de la position actuelle et ne se met pas à jour automatiquement lorsque la caméra se déplace.

Pour en savoir plus sur la modification de la position de la caméra, consultez la section Caméra et vue.

Récupère le bâtiment actuellement ciblé.

Récupère le type de carte actuellement affiché. Consultez les champs MAP_TYPE_NORMAL, MAP_TYPE_SATELLITE et MAP_TYPE_TERRAIN pour connaître les valeurs possibles.

Renvoie le niveau de zoom maximal pour la position actuelle de la caméra. Tout dépend du type de carte en cours d'utilisation. Par exemple, le niveau de zoom maximal d'un satellite ou d'un relief peut être inférieur à celui des tuiles de la carte de base.

Pour en savoir plus sur la modification du niveau de zoom de la caméra, consultez Caméra et vue.

Affiche le niveau de zoom minimal. Le fonctionnement est le même pour tous les lieux (contrairement au niveau de zoom maximal), mais il peut varier en fonction des appareils et de la taille des cartes.

Pour en savoir plus sur la modification du niveau de zoom de la caméra, consultez Caméra et vue.

Renvoie la position géographique actuellement affichée, ou null si aucune donnée de localisation n'est disponible.

Renvoie un objet Projection que vous pouvez utiliser pour convertir des coordonnées d'écran en coordonnées de latitude/longitude.

Le Projection renvoyé est un instantané de la projection actuelle et ne se met pas à jour automatiquement lorsque la caméra se déplace. Cette opération étant coûteuse, vous ne devriez obtenir la projection qu'une seule fois par écran. Google Maps utilise la projection de Mercator pour créer ses cartes à partir de données géographiques et convertir les points de la carte en coordonnées géographiques.

Récupère les paramètres de l'interface utilisateur pour la carte.

Indique si les données géographiques "Bâtiments 3D" sont activées.

Détermine si les plans d'intérieur sont actuellement activés.

Récupère l'état du calque my-location.

Vérifie si la carte extrait les données de trafic. sous réserve de disponibilité des données sur le trafic.

Repositionne la caméra selon les instructions définies dans la mise à jour. Le déplacement est instantané, et la valeur getCameraPosition() suivante reflète la nouvelle position. Consultez CameraUpdateFactory pour obtenir un ensemble de mises à jour.

Supprime les limites de zoom supérieure et inférieure précédemment spécifiées.

Active ou désactive les données géographiques "Bâtiments 3D".

Définit une description de contenu pour la carte.

Permet de fournir une description vocale de la carte en mode d'accessibilité. La valeur par défaut est &qut;Google Map"

Ce paramètre indique si les plans d'intérieur doivent être activés. Actuellement, les plans d'intérieur ne peuvent être affichés que sur une seule carte à la fois. Par défaut, il s'agit de la première carte ajoutée à votre application. Pour activer les plans d'intérieur sur une autre carte, vous devez d'abord désactiver les plans d'intérieur sur la carte d'origine. Si vous essayez d'activer les plans d'intérieur lorsqu'il est activé sur une autre carte, rien ne se passe, et false est renvoyé. Lorsque les plans d'intérieur ne sont pas activés pour une carte, toutes les méthodes liées à l'intérieur affichent null ou false.

Définit un moteur de rendu personnalisé pour le contenu des fenêtres d'informations.

Comme les écouteurs d'événements de la carte, cet état n'est pas sérialisé avec la carte. Si la carte est recréée (par exemple, en raison d'une modification de la configuration), vous devez vous assurer de rappeler cette méthode afin de conserver la personnalisation.

Spécifie une valeur LatLngBounds pour contraindre la cible de la caméra. Ainsi, lorsque les utilisateurs font défiler la carte et effectuez un panoramique, la cible de la caméra ne se déplace pas en dehors de ces limites.

Définissez la valeur sur "null" pour effacer complètement le cadre de délimitation. Les nouvelles limites remplacent tout cadre de délimitation précédemment spécifié.

Lorsque la valeur LatLngBounds change, le SDK ajuste toutes les mises à jour ultérieures de la caméra pour respecter ces limites, si possible. Notez que des considérations techniques peuvent empêcher le SDK de maintenir la cible de la caméra strictement dans les limites. (par exemple, des erreurs d'arrondi à la précision à virgule flottante ou un niveau de zoom très faible).

Remplace la source de localisation de la couche my-location.

Définit le style de la carte de base.

À l'aide des options de style, vous pouvez appliquer des styles personnalisés aux éléments géographiques et aux éléments de la carte. Pour en savoir plus sur la définition du style, consultez MapStyleOptions.

Définissez la valeur sur "null" pour effacer tous les styles personnalisés précédents.

Définit le type de tuiles de carte à afficher. Les valeurs autorisées sont les suivantes:

• MAP_TYPE_NORMAL: carte de base.
• MAP_TYPE_SATELLITE: images satellite.
• MAP_TYPE_HYBRID : images satellite avec routes et libellés.
• MAP_TYPE_TERRAIN: données topographiques.
• MAP_TYPE_NONE: aucune tuile de carte de base.

Définit une limite supérieure pour le zoom de la caméra.

Lorsque le zoom maximal change, le SDK ajuste toutes les mises à jour ultérieures de la caméra pour respecter, si possible, cette valeur maximale. Notez que des considérations techniques peuvent empêcher le SDK de permettre aux utilisateurs d'effectuer un zoom trop profond sur la carte. Par exemple, le zoom maximal d'un satellite ou d'un relief peut être inférieur à celui des tuiles de la carte de base.

Le SDK résout tous les conflits entre les valeurs minimale et maximale. Si vous définissez un niveau de zoom minimal supérieur à la valeur maximale actuelle, le SDK utilisera la nouvelle valeur minimale pour les valeurs minimale et maximale. Si vous définissez un niveau de zoom inférieur à celui du minimum, le SDK utilisera la nouvelle valeur maximale pour la valeur minimale et la valeur maximale. Par exemple, supposons que le zoom minimal actuel soit de 8 et que le maximum soit de 14. Vous réglez ensuite le zoom maximal sur 6. Le SDK utilise un zoom minimal de 6 et un zoom maximal de 6.

Définit une limite inférieure préférée pour le zoom de la caméra.

Lorsque le zoom minimal change, le SDK ajuste toutes les mises à jour ultérieures de la caméra pour respecter ce minimum, si possible. Notez que des considérations techniques peuvent empêcher le SDK d'autoriser les utilisateurs à effectuer un zoom trop faible.

Le SDK résout tous les conflits entre les valeurs minimale et maximale. Si vous définissez un niveau de zoom minimal supérieur à la valeur maximale actuelle, le SDK utilisera la nouvelle valeur minimale pour les valeurs minimale et maximale. Si vous définissez un niveau de zoom inférieur à celui du minimum, le SDK utilisera la nouvelle valeur maximale pour la valeur minimale et la valeur maximale. Par exemple, supposons que le zoom minimal actuel soit de 8 et que le maximum soit de 14. Vous définissez ensuite le zoom minimal sur 16. Le SDK utilise un zoom minimal de 16 et un zoom maximal de 16.

Active ou désactive le calque "Ma position".

Lorsqu'elle est activée et que la position est disponible, le calque "Ma position" dessine en permanence les indications de la position et de l'orientation actuelles d'un utilisateur, et affiche des commandes d'interface utilisateur qui permettent à l'utilisateur d'interagir avec sa position (par exemple, pour activer ou désactiver le suivi de la position et de la direction de la caméra).

Pour utiliser la fonctionnalité my-location-layer, vous devez demander une autorisation pour ACCESS_COARSE_LOCATION ou ACCESS_FINE_LOCATION, sauf si vous avez défini une source de localisation personnalisée.

Si vous avez défini une source de localisation personnalisée via setLocationSource(LocationSource), le SDK Google Maps pour Android ne vérifiera pas si les autorisations ci-dessus ont été accordées. Toutefois, vous devez toujours vous assurer que l'utilisateur a accordé toutes les autorisations requises pour votre source de localisation personnalisée.

Définit un rappel appelé lorsque la caméra change.

Définit un rappel appelé lorsque le mouvement de la caméra est terminé.

Définit un rappel qui est invoqué lorsque le mouvement de la caméra est arrêté ou interrompu par un nouveau type d'animation.

Définit un rappel appelé plusieurs fois lorsque la caméra est en mouvement. Le rappel peut être invoqué aussi souvent qu'une fois par image et ne doit pas nécessiter d'opérations coûteuses.

Définit un rappel qui est invoqué lorsque la caméra commence à se déplacer ou lorsque le mouvement de la caméra a changé.

Définit un rappel appelé lorsqu'un utilisateur clique sur un cercle.

Définit un rappel appelé lorsqu'un internaute clique sur une superposition au sol.

Définit ou efface l'écouteur pour les événements en intérieur. Un seul écouteur peut être défini. Définir un nouvel écouteur supprime l'écouteur précédent.

Définit un rappel appelé lorsqu'un internaute clique sur une fenêtre d'informations sur le repère.

Définit un rappel appelé lorsqu'un repère est fermé.

Définit un rappel appelé lorsqu'un utilisateur appuie de manière prolongée sur la fenêtre d'informations d'un repère.

Définit un rappel appelé lorsque l'utilisateur appuie sur la carte.

Définit un rappel appelé lorsque l'affichage de la carte est terminé. Le rappel ne sera invoqué qu'une seule fois.

Si cette méthode est appelée lorsque la carte est entièrement affichée, le rappel est invoqué immédiatement. Cet événement ne se déclenche pas si la carte ne se charge jamais en raison de problèmes de connectivité, ou si elle change constamment et ne se termine jamais parce que l'utilisateur interagit en permanence avec elle.

Définit un rappel appelé lorsque l'utilisateur appuie de manière prolongée sur la carte.

Définit un rappel appelé lorsqu'un utilisateur clique sur un repère.

Définit un rappel appelé lorsqu'un repère est déplacé.

Définit un rappel appelé lorsque l'utilisateur clique sur le bouton "My location" (Ma position).

Si listener renvoie true, l'événement est consommé et le comportement par défaut ne se produit pas. Si elle renvoie false, le comportement par défaut se produit (la caméra se déplace de manière à être centrée sur la position de l'utilisateur).

Définit un rappel appelé lorsque le point Ma position change d'emplacement.

Définit un rappel appelé lorsque l'utilisateur clique sur le point "Ma position" (ce qui correspond à la position de l'utilisateur).

Définit un écouteur qui se déclenche lorsque l'utilisateur clique ou appuie sur un POI.

Transmettez null pour effacer l'écouteur.

Définit un rappel appelé lorsqu'un utilisateur clique sur un polygone.

Définit un rappel appelé lorsqu'un utilisateur clique sur une polyligne.

Définit la marge intérieure sur la carte.

Cette méthode vous permet de définir une région visible sur la carte afin d'indiquer à celle-ci que les parties de la carte peuvent être masquées en définissant une marge intérieure sur chacun des quatre bords de la carte. Les fonctions de carte seront adaptées à la marge intérieure. Par exemple, les commandes de zoom, la boussole, les avis de droits d'auteur et le logo Google seront déplacés pour s'adapter à la zone définie. Les mouvements de la caméra seront effectués par rapport au centre de la zone visible, etc.

Active ou désactive le calque de trafic.

Prendre un instantané de la carte

Vous pouvez utiliser des instantanés dans votre application lorsqu'une carte interactive est difficile, voire impossible. Par exemple, les images générées avec la méthode snapshot() peuvent être utilisées pour afficher une vignette de la carte dans votre application ou un instantané dans le centre de notifications.

Remarque : Les images de la carte ne doivent pas être transmises à vos serveurs ni utilisées en dehors de l'application. Si vous devez envoyer une carte à une autre application ou à un autre utilisateur, envoyez des données qui lui permettront de reconstruire la carte pour le nouvel utilisateur au lieu d'un instantané.

Prendre un instantané de la carte

Cette méthode équivaut à snapshot(SnapshotReadyCallback), mais vous permet de fournir une ressource Bitmap allouée. Si le bitmap ne correspond pas aux dimensions actuelles de la carte, un autre bitmap sera alloué qui correspond aux dimensions de la carte.

Bien que dans la plupart des cas, l'objet transmis par la méthode de rappel soit identique à celui donné dans le paramètre de cette méthode, dans certains cas, l'objet renvoyé peut être différent (par exemple, si les dimensions de la vue ont changé au moment où l'instantané a été pris). Ainsi, vous ne devez faire confiance qu'au contenu du bitmap transmis par la méthode de rappel.

Arrête l'animation de la caméra si une image est en cours. Lorsque la méthode est appelée, la caméra cesse de se déplacer immédiatement et reste à cette position.