GoogleMap

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.
la classe finale publique GoogleMap étend les objets

Il s'agit de la classe principale du SDK Google Maps pour Android. C'est le point d'entrée de toutes les méthodes liées à la carte. Vous ne pouvez pas instancier directement un objet GoogleMap. Vous devez en obtenir un à partir de la méthode getMapAsync() sur un MapFragment ou un MapView que vous avez ajouté à votre application.

Remarque: Comme pour un objet View, GoogleMap ne peut être lu et modifié qu'à partir du thread UI Android. L'appel des méthodes GoogleMap à partir d'un autre thread entraînera une exception.

Vous pouvez ajuster le point de vue d'une carte en modifiant la position de la caméra (plutôt que de déplacer la carte). Vous pouvez utiliser la caméra de la carte pour définir des paramètres tels que le lieu, le niveau de zoom, l'angle d'inclinaison et l'orientation. Pour en savoir plus, consultez Caméra et vue.

Guide du développeur

Pour commencer, consultez le guide du développeur du SDK Google Maps pour Android.

Récapitulatif des classes imbriquées

interface GoogleMap.CancelableCallback Interface de rappel pour la création de rapports lorsqu'une tâche est terminée ou annulée
interface GoogleMap.InfoWindowAdapter Fournit des vues permettant un affichage personnalisé des fenêtres d'informations. 
interface GoogleMap.OnCameraChangeListener Cette interface est obsolète. Remplacé par GoogleMap.OnCameraMoveStartedListener, GoogleMap.OnCameraMoveListener et GoogleMap.OnCameraIdleListener. L'ordre dans lequel la méthode obsolète onCameraChange est appelée par rapport aux méthodes des nouveaux écouteurs de changement de caméra n'est pas défini.  
interface GoogleMap.OnCameraIdleListener Interface de rappel lorsque le mouvement de la caméra est terminé
interface GoogleMap.OnCameraMoveCanceledListener Interface de rappel lorsque le mouvement de la caméra est arrêté ou lorsqu'elle commence à se déplacer pour une autre raison
interface GoogleMap.OnCameraMoveListener Interface de rappel lorsque la caméra change de position
interface GoogleMap.OnCameraMoveStartedListener Interface de rappel lorsque le mouvement de la caméra commence. 
interface GoogleMap.OnCircleClickListener Interface de rappel pour les clics sur un cercle
interface GoogleMap.OnGroundOverlayClickListener Interface de rappel pour les clics sur une superposition au sol
interface GoogleMap.OnIndoorStateChangeListener Un écouteur pour les cas où l'état intérieur change. 
interface GoogleMap.OnInfoWindowClickListener Interface de rappel pour les événements de clic ou d'appui sur une fenêtre d'informations d'un repère
interface GoogleMap.OnInfoWindowCloseListener Interface de rappel pour les événements de fermeture sur la fenêtre d'informations d'un repère
interface GoogleMap.OnInfoWindowLongClickListener Interface de rappel lorsque l'utilisateur appuie de manière prolongée sur la fenêtre d'informations d'un repère
interface GoogleMap.OnMapClickListener Interface de rappel lorsque l'utilisateur appuie sur la carte
interface GoogleMap.OnMapLoadedCallback Interface de rappel lorsque le rendu de la carte est terminé
interface GoogleMap.OnMapLongClickListener Interface de rappel lorsque l'utilisateur appuie de manière prolongée sur la carte
interface GoogleMap.OnMarkerClickListener Définit les signatures des méthodes appelées lorsqu'un utilisateur clique ou appuie sur un repère. 
interface GoogleMap.OnMarkerDragListener Interface de rappel pour les événements de déplacement sur les repères
interface GoogleMap.OnMyLocationButtonClickListener Interface de rappel pour les clics sur le bouton "Ma position"
interface GoogleMap.OnMyLocationChangeListener Cette interface est obsolète. Utilisez plutôt com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi améliore la détection de la position et utilise davantage d'énergie. Il est utilisé par le point bleu "Ma position". Consultez le tutoriel Sélectionner le lieu actuel qui utilise FusedLocationProviderApi ou le guide du développeur de lieux.  
interface GoogleMap.OnMyLocationClickListener Interface de rappel pour les clics sur le point "Ma position" (signifiant la position de l'utilisateur)
interface GoogleMap.OnPoiClickListener Un écouteur pour les appuis sur des POI. 
interface GoogleMap.OnPolygonClickListener Interface de rappel pour les clics sur un polygone
interface GoogleMap.OnPolylineClickListener Interface de rappel pour les clics sur une polyligne
interface GoogleMap.SnapshotReadyCallback Interface de rappel pour vous avertir lorsque l'instantané a été pris

Récapitulatif des constantes

int MAP_TYPE_HYBRID Cartes satellite présentant un calque transparent de rues principales.
int MAP_TYPE_NONE Aucune carte de base.
int TYPE_NORMAL Cartes de base
int MAP_TYPE_SATELLITE Cartes satellite sans libellés.
int MAP_TYPE_TERRAIN Cartes du relief.

Récapitulatif des méthodes publiques

Circle
addCircle(options CircleOptions)
Ajouter un cercle à cette carte
GroundOverlay
addGroundOverlay(options GroundOverlayOptions)
Ajoute une image à cette carte.
Marker
addMarker(options MarkerOptions)
Ajoute un repère à cette carte.
Polygon
addPolygon(options PolygonOptions)
Ajoute un polygone à cette carte.
Polyline
addPolyline(options Polyline)
Ajoute une polyligne à cette carte.
TileOverlay
addTileOverlay(Options de TileOverlayOptions)
Ajoute une superposition de tuiles à cette carte.
void
animateCamera(mise à jour de CameraUpdate)
Anime le mouvement de la caméra de la position actuelle à la position définie dans la mise à jour.
void
animateCamera(mise à jour de CameraUpdate, rappel GoogleMap.CancelableCallback)
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.
void
animateCamera(mise à jour de CameraUpdate, durée intM, rappel GoogleAnnuler.CancelableCallback)
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.
void
clear()
Supprime tous les repères, les polylignes, les polygones, les superpositions, etc. de la carte.
CameraPosition (Position de la caméra)
getCameraPosition()
Récupère la position actuelle de la caméra.
Intérieur
getFocusedBuilding
Récupère le bâtiment actuellement ciblé.
int
getMapType
Récupère le type de carte actuellement affiché.
float (nombre à virgule flottante)
getMaxZoomLevel()
Renvoie le niveau de zoom maximal pour la position actuelle de la caméra.
float (nombre à virgule flottante)
getMinZoomLevel()
Affiche le niveau de zoom minimal.
Emplacement
getMyLocation()
Cette méthode est obsolète. Utilisez com.google.android.gms.location.FusedLocationProviderApi à la place. FusedLocationProviderApi améliore la détection de la position et utilise davantage d'énergie. Il est utilisé par le point bleu "Ma position". Consultez MyLocationDemoActivity dans le dossier d'exemples d'applications pour obtenir un exemple de code ou le guide du développeur de l'emplacement.
Projection
getProjection
Renvoie un objet Projection que vous pouvez utiliser pour convertir des coordonnées d'écran en coordonnées de latitude/longitude.
Paramètres utilisateur
getUiSettings()
Récupère les paramètres de l'interface utilisateur pour la carte.
booléen
isBuildingsEnabled()
Indique si les données géographiques "Bâtiments 3D" sont activées.
booléen
isIndoorEnabled()
Détermine si les plans d'intérieur sont actuellement activés.
booléen
isMyLocationEnabled()
Récupère l'état du calque my-location.
booléen
isTrafficEnabled()
Vérifie si la carte extrait les données de trafic.
void
moveCamera(mise à jour de CameraUpdate)
Repositionne la caméra selon les instructions définies dans la mise à jour.
void
resetMinMaxZoomPréférence
Supprime les limites de zoom supérieure et inférieure précédemment spécifiées.
void
setBuildingsEnabled(valeur booléenne activée)
Active ou désactive les données géographiques "Bâtiments 3D".
void
setContentDescription(description de chaîne)
Définit une description de contenu pour la carte.
booléen
setIndoorEnabled(valeur booléenne activée)
Ce paramètre indique si les plans d'intérieur doivent être activés.
void
setInfoWindowAdapter(adaptateur GoogleMap.InfoWindowAdapter)
Définit un moteur de rendu personnalisé pour le contenu des fenêtres d'informations.
void
setLatLngBoundsForCameraTarget(limites LatLngBounds)
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.
void
setLocationSource(source LocationSource)
Remplace la source de localisation de la couche my-location.
booléen
setMapStyle(style MapStyleOptions)
Définit le style de la carte de base.
void
setMapType(type)
Définit le type de tuiles de carte à afficher.
void
setMaxZoomPréférence(float maxZoomPréférence)
Définit une limite supérieure pour le zoom de la caméra.
void
setMinZoomPréférence (floatMinZoomPréférence)
Définit une limite inférieure préférée pour le zoom de la caméra.
void
setMyLocationEnabled(valeur booléenne activée)
Active ou désactive le calque "Ma position".
void
void
setOnCameraIdleListener (écouteur GoogleMap.OnCameraIdleListener)
Définit un rappel appelé lorsque le mouvement de la caméra est terminé.
void
setOnCameraMoveCanceledListener (écouteur GoogleMap.OnCameraMoveCanceledListener)
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.
void
setOnCameraMoveListener (écouteur GoogleMap.OnCameraMoveListener)
Définit un rappel appelé plusieurs fois lorsque la caméra est en mouvement.
void
setOnCameraMoveStartedListener(écouteur GoogleMap.OnCameraMoveStartedListener)
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é.
void
setOnCircleClickListener(écouteur GoogleMap.OnCircleClickListener)
Définit un rappel appelé lorsqu'un utilisateur clique sur un cercle.
void
setOnGroundOverlayClickListener (écouteur GoogleMap.OnGroundOverlayClickListener)
Définit un rappel appelé lorsqu'un internaute clique sur une superposition au sol.
void
setOnIndoorStateChangeListener(écouteur GoogleMap.OnIndoorStateChangeListener)
Définit ou efface l'écouteur pour les événements en intérieur.
void
setOnInfoWindowClickListener(écouteur GoogleMap.OnInfoWindowClickListener)
Définit un rappel appelé lorsqu'un internaute clique sur une fenêtre d'informations sur le repère.
void
setOnInfoWindowCloseListener(écouteur GoogleMap.OnInfoWindowCloseListener)
Définit un rappel appelé lorsqu'un repère est fermé.
void
setOnInfoWindowLongClickListener(écouteur GoogleMap.OnInfoWindowLongClickListener)
Définit un rappel appelé lorsqu'un utilisateur appuie de manière prolongée sur la fenêtre d'informations d'un repère.
void
setOnMapClickListener(écouteur GoogleMap.OnMapClickListener)
Définit un rappel appelé lorsque l'utilisateur appuie sur la carte.
void
setOnMapLoadedCallback(GoogleMap.OnMapLoadedCallbackrappel)
Définit un rappel appelé lorsque l'affichage de la carte est terminé.
void
setOnMapLongClickListener (écouteur GoogleMap.OnMapLongClickListener)
Définit un rappel appelé lorsque l'utilisateur appuie de manière prolongée sur la carte.
void
setOnMarkerClickListener(écouteur GoogleMap.OnMarkerClickListener)
Définit un rappel appelé lorsqu'un utilisateur clique sur un repère.
void
setOnMarkerDragListener(écouteur GoogleMap.OnMarkerDragListener)
Définit un rappel appelé lorsqu'un repère est déplacé.
void
setOnMyLocationButtonClickListener(écouteur GoogleMap.OnMyLocationButtonClickListener)
Définit un rappel appelé lorsque l'utilisateur clique sur le bouton "My location" (Ma position).
void
setOnMyLocationChangeListener(écouteur GoogleMap.OnMyLocationChangeListener)
Cette méthode est obsolète. Utilisez com.google.android.gms.location.FusedLocationProviderApi à la place. FusedLocationProviderApi améliore la détection de la position et utilise davantage d'énergie. Il est utilisé par le point bleu "Ma position". Consultez MyLocationDemoActivity dans le dossier d'exemples d'applications pour obtenir un exemple de code ou le guide du développeur de l'emplacement.
void
setOnMyLocationClickListener(écouteur GoogleMap.OnMyLocationClickListener)
Définit un rappel appelé lorsque l'utilisateur clique sur le point "Ma position" (ce qui correspond à la position de l'utilisateur).
void
setOnPoiClickListener(écouteur GoogleMap.OnPoiClickListener)
Définit un écouteur qui se déclenche lorsque l'utilisateur clique ou appuie sur un POI.
void
setOnPolygonClickListener(écouteur GoogleMap.OnPolygonClickListener)
Définit un rappel appelé lorsqu'un utilisateur clique sur un polygone.
void
setOnPolylineClickListener(écouteur GoogleMap.OnPolylineClickListener)
Définit un rappel appelé lorsqu'un utilisateur clique sur une polyligne.
void
setPadding(int gauche, int haut, int droit, int bas)
Définit la marge intérieure sur la carte.
void
setTrafficEnabled(valeur booléenne activée)
Active ou désactive le calque de trafic.
void
snapshot(rappel GoogleMap.SnapshotReadyCallback)
Prendre un instantané de la carte
void
snapshot(rappel GoogleMap.SnapshotReadyCallback, bitmap bitmap)
Prendre un instantané de la carte
void
stopAnimation()
Arrête l'animation de la caméra si une image est en cours.

Récapitulatif des méthodes héritées

Constantes

public static final int MAP_TYPE_HYBRID

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

Valeur constante : 4

public static final int MAP_TYPE_NONE

Aucune carte de base.

Valeur constante: 0

public static final int MAP_TYPE_NORMAL

Cartes de base

Valeur constante : 1

public static final int MAP_TYPE_SATELLITE

Cartes satellite sans libellés.

Valeur constante: 2

public static final int MAP_TYPE_TERRAIN

Cartes du relief.

Valeur constante : 3

Méthodes publiques

public Cercle addCircle (Options du cercle)

Ajouter un cercle à cette carte

Paramètres
options Un objet d'options de cercle qui définit comment afficher le cercle
Renvoie
  • L'objet Circle ajouté à la carte

public GroundOverlay addGroundOverlay (Options GroundOverlayOptions)

Ajoute une image à cette carte.

Paramètres
options Objet d'options de superposition au sol qui définit comment afficher la superposition. Une option (AnchoredBitmap) et une position doivent être spécifiées pour les options.
Renvoie
Génère
IllegalArgumentException Si l'image ou la position n'est pas spécifiée dans les options.

public Repère addMarker (options Marker)

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.

Paramètres
options Objet d'options de repère qui définit comment afficher le repère.
Renvoie

public Polygone addPolygon (Options PolygonOptions)

Ajoute un polygone à cette carte.

Paramètres
options Objet d'options de polygone définissant le rendu du polygone
Renvoie
  • L'objet Polygon ajouté à la carte

public Polyligne addPolyline (options Polyline)

Ajoute une polyligne à cette carte.

Paramètres
options Un objet d'options de polyligne qui définit comment afficher la polyligne
Renvoie
  • Objet Polyline qui a été ajouté à la carte.

public TileOverlay addTileOverlay (options TileOverlayOptions)

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.

Paramètres
options Objet d'options de superposition de tuiles qui définit comment afficher la superposition. Vous devez spécifier un TileProvider pour les options, sinon un IllegalArgumentException sera généré.
Renvoie
Génère
IllegalArgumentException Si TileProvider n'est pas spécifié dans les options.

public void animateCamera (mise à jour de CameraUpdate)

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.

Paramètres
update Changement à appliquer à la caméra.

public void animateCamera (mise à jour de CameraUpdate, rappel GoogleCancel.CancelableCallback)

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.

Paramètres
update Changement à appliquer à la caméra.
rappel Rappel à invoquer à partir du thread UI Android lorsque l'animation s'arrête. Si l'animation se termine normalement, onFinish() est appelé. Sinon, onCancel() est appelé. Veillez à ne pas mettre à jour ni animer la caméra à partir de onCancel().

public void animateCamera (mise à jour de CameraUpdate, durée intMM, rappel GoogleCancel.CancelableCallback)

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.

Paramètres
update
duréeMs Durée de l'animation, en millisecondes. Elle doit être strictement positive, sinon une exception IllegalArgumentException sera générée.
rappel Rappel facultatif à avertir à partir du thread UI Android lorsque l'animation s'arrête. Si l'animation s'arrête en raison de son achèvement naturel, le rappel sera notifié avec onFinish(). Si l'animation s'arrête en raison d'une interruption suite à un mouvement de la caméra ou à un geste de l'utilisateur, la méthode onCancel() est appelée. Le rappel ne doit pas essayer de déplacer ni d'animer la caméra dans sa méthode d'annulation. Si un rappel n'est pas nécessaire, laissez null.

public void clear ()

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

public CameraPosition getCameraPosition ()

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.

Renvoie
  • Position actuelle de la caméra.

public IndoorBuilding getFocusedBuilding ()

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

Renvoie
  • Bâtiment ciblé actuel ou null si aucun bâtiment n'est ciblé.

int getMapType ()

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 type de carte

float public getMaxZoomLevel ()

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.

Renvoie
  • Niveau de zoom maximal disponible pour la position actuelle de la caméra.

float public getMinZoomLevel ()

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
  • Niveau de zoom minimal disponible.

public Location getMyLocation ()

Cette méthode est obsolète.
Utilisez com.google.android.gms.location.FusedLocationProviderApi à la place. FusedLocationProviderApi améliore la détection de la position et utilise davantage d'énergie. Il est utilisé par le point bleu "Ma position". Reportez-vous à MyLocationDemoActivity dans le dossier d'exemples d'applications pour voir un exemple de code ou consultez le guide du développeur du lieu.

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

Renvoie
Génère
IllegalStateException si la couche my-location n'est pas activée.

public Projection getProjection ()

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.

Renvoie

public UiSettings getUiSettings ()

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

Renvoie

public booléen isBuildingsEnabled ()

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

Renvoie
  • true si les bâtiments sont activés ; false dans le cas contraire.

public boolean isIndoorEnabled ()

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

Renvoie
  • true si les plans d'intérieur sont activés ; false si les plans d'intérieur sont désactivés ;

public boolean isMyLocationEnabled ()

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

Renvoie
  • true si la couche my-location est activée ; false dans le cas contraire.

public booleanisTrafficEnabled()

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

Renvoie
  • true si les données sur le trafic sont activées ; false dans le cas contraire.

public void moveCamera (mise à jour de CameraUpdate)

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.

Paramètres
update Changement à appliquer à la caméra.

public void resetMinMaxZoomPréférence ()

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

public void setBuildingsEnabled (valeur booléenne activée)

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

Paramètres
activé true pour activer le calque des bâtiments 3D ; false pour désactiver les bâtiments 3D.

public void setContentDescription (description de chaîne)

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"

Paramètres
description Chaîne à utiliser comme description.

public boolean setIndoorEnabled (valeur booléenne activée)

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.

Paramètres
activé true pour essayer d'activer les plans d'intérieur ; false pour les désactiver.
Renvoie
  • s'il était possible d'activer les plans d'intérieur.

public void setInfoWindowAdapter (adaptateur GoogleMap.InfoWindowAdapter)

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.

Paramètres
adaptateur L'adaptateur à utiliser pour le contenu de la fenêtre d'informations ou null pour utiliser le rendu du contenu par défaut dans les fenêtres d'informations.

void public setLatLngBoundsForCameraTarget (LatLngBounds limites)

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).

Paramètres
limites Limites permettant de limiter la cible de la caméra.

public void setLocationSource (source LocationSource)

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

Paramètres
source Source de localisation à utiliser dans le calque "Ma position" Définissez la valeur sur null pour utiliser la source de localisation par défaut.

public boolean setMapStyle (StyleStyleOptions)

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.

Paramètres
style
Renvoie
  • true si le style a bien été analysé ; false si des problèmes ont été détectés avec MapStyleOptions, tels que des erreurs de style JSON, un type de fonctionnalité non reconnu, un type d'élément non reconnu ou des clés de styler non valides. Si la valeur renvoyée est false, le style actuel reste inchangé.

public void setMapType (int type)

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

Paramètres
type Type de carte à afficher.

public void setMaxZoomPréférence (float maxZoomPréférence)

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.

Paramètres
Préférence de zoom max Limite supérieure à privilégier.

public void setMinZoomPréférence (float minZoomPréférence)

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.

Paramètres
Préférence de zoom min Limite inférieure à privilégier.

public void setMyLocationEnabled (valeur booléenne activée)

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.

Paramètres
activé true pour l'activer ; false pour la désactiver.
Génère
SecurityException si l'autorisation d'accéder à la position n'est pas accordée.

public void setOnCameraChangeListener (écouteur GoogleMap.OnCameraChangeListener)

Cette méthode est obsolète.
remplacé par setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener), setOnCameraMoveListener(GoogleMap.OnCameraMoveListener), setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener) et setOnCameraIdleListener(GoogleMap.OnCameraIdleListener).

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

Paramètres
écouteur Rappel appelé lorsque la caméra change. Pour annuler le rappel, utilisez null.

public void setOnCameraIdleListener (écouteur GoogleMap.OnCameraIdleListener)

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

Paramètres
écouteur Rappel appelé. Pour annuler le rappel, utilisez null.

public void setOnCameraMoveCanceledListener (écouteur GoogleMap.OnCameraMoveCanceledListener)

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.

Paramètres
écouteur Rappel appelé. Pour annuler le rappel, utilisez null. Veillez à ne pas mettre à jour ni animer la caméra à partir de onCameraMoveCanceled().

public void setOnCameraMoveListener (écouteur GoogleMap.OnCameraMoveListener)

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.

Paramètres
écouteur Rappel appelé. Pour annuler le rappel, utilisez null.

public void setOnCameraMoveStartedListener (GoogleMap.OnCameraMoveStartedListener)

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é.

Paramètres
écouteur Rappel appelé. Pour annuler le rappel, utilisez null. Veillez à ne pas mettre à jour ni animer la caméra à partir de onCameraMoveStarted().

public void setOnCircleClickListener (écouteur GoogleMap.OnCircleClickListener)

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

Paramètres
écouteur Rappel invoqué lors d'un clic sur un cercle Pour annuler le rappel, utilisez null.

public void setOnGroundOverlayClickListener (écouteur GoogleMap.OnGroundOverlayClickListener)

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

Paramètres
écouteur Rappel invoqué lors d'un clic sur une superposition au sol. Pour annuler le rappel, utilisez null.

public void setOnIndoorStateChangeListener (écouteur GoogleMap.OnIndoorStateChangeListener)

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.

Paramètres
écouteur Paramètre "Listener" pour les événements d'intérieur s'il n'est pas nul ; sinon, efface l'écouteur

public void setOnInfoWindowClickListener (écouteur GoogleMap.OnInfoWindowClickListener)

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

Paramètres
écouteur Rappel invoqué lors d'un clic sur une fenêtre d'informations sur le repère. Pour annuler le rappel, utilisez null.

public void setOnInfoWindowCloseListener (écouteur GoogleMap.OnInfoWindowCloseListener)

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

Paramètres
écouteur Rappel invoqué lors de la fermeture d'une fenêtre d'informations d'un repère. Pour annuler le rappel, utilisez null.

public void setOnInfoWindowLongClickListener (écouteur GoogleMap.OnInfoWindowLongClickListener)

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

Paramètres
écouteur Rappel invoqué lorsqu'un utilisateur appuie de manière prolongée sur la fenêtre d'informations d'un repère. Pour annuler le rappel, utilisez null.

public void setOnMapClickListener (écouteur GoogleMap.OnMapClickListener)

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

Paramètres
écouteur Rappel invoqué lorsque l'utilisateur appuie sur la carte. Pour annuler le rappel, utilisez null.

public void setOnMapLoadedCallback (GoogleMap.OnMapLoadedCallback rappel)

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.

Paramètres
rappel Rappel appelé lorsque l'affichage de la carte est terminé. Pour annuler le rappel, utilisez null.

public void setOnMapLongClickListener (écouteur GoogleMap.OnMapLongClickListener)

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

Paramètres
écouteur Rappel invoqué lorsque vous appuyez de manière prolongée sur la carte. Pour annuler le rappel, utilisez null.

public void setOnMarkerClickListener (écouteur GoogleMap.OnMarkerClickListener)

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

Paramètres
écouteur Rappel invoqué lors d'un clic sur un repère. Pour annuler le rappel, utilisez null.

public void setOnMarkerDragListener (écouteur GoogleMap.OnMarkerDragListener)

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

Paramètres
écouteur Rappel appelé lors d'événements de déplacement de repère. Pour annuler le rappel, utilisez null.

public void setOnMyLocationButtonClickListener (écouteur GoogleMap.OnMyLocationButtonClickListener)

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).

Paramètres
écouteur Rappel invoqué lors d'un clic sur le bouton "Ma position".

public void setOnMyLocationChangeListener (écouteur GoogleMap.OnMyLocationChangeListener)

Cette méthode est obsolète.
Utilisez com.google.android.gms.location.FusedLocationProviderApi à la place. FusedLocationProviderApi améliore la détection de la position et utilise davantage d'énergie. Il est utilisé par le point bleu "Ma position". Reportez-vous à MyLocationDemoActivity dans le dossier d'exemples d'applications pour voir un exemple de code ou consultez le guide du développeur du lieu.

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

Paramètres
écouteur Rappel appelé lorsque le point Ma position change.

public void setOnMyLocationClickListener (écouteur GoogleMap.OnMyLocationClickListener)

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

Paramètres
écouteur Rappel invoqué lors d'un clic sur le point "Ma position".

public void setOnPoiClickListener (écouteur GoogleMap.OnPoiClickListener)

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

Transmettez null pour effacer l'écouteur.

Paramètres
écouteur

public void setOnPolygonClickListener (écouteur GoogleMap.OnPolygonClickListener)

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

Paramètres
écouteur Rappel invoqué lors d'un clic sur un polygone. Pour annuler le rappel, utilisez null.

public void setOnPolylineClickListener (écouteur GoogleMap.OnPolylineClickListener)

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

Paramètres
écouteur Rappel invoqué lors d'un clic sur une polyligne. Pour annuler le rappel, utilisez null.

public void setPadding (int left, int top, int right, int bottom)

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.

Paramètres
gauche Nombre de pixels de marge intérieure à ajouter à gauche de la carte
top Nombre de pixels de marge intérieure à ajouter en haut de la carte
ok Nombre de pixels de marge intérieure à ajouter à droite de la carte.
bas Nombre de pixels de marge intérieure à ajouter en bas de la carte.

public void setTrafficEnabled (valeur booléenne activée)

Active ou désactive le calque de trafic.

Paramètres
activé

public void instantané (GoogleMap.SnapshotReadyCallback rappel)

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é.

Paramètres
rappel Méthode de rappel appelée lorsque l'instantané est pris.

public void instantané (GoogleMap.SnapshotReadyCallback rappel, bitmap bitmap)

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.

Paramètres
rappel Méthode de rappel appelée lorsque l'instantané est pris.
bitmap Bitmap pré-alloué. Si la valeur est null, se comporte comme snapshot(SnapshotReadyCallback).

public void stopAnimation ()

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.