GoogleMap

La classe publique finale GoogleMap étend l'objet

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 associé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 objet MapFragment ou MapView que vous avez ajouté à votre application.

Remarque: Comme pour un objet View, un GoogleMap ne peut être lu et modifié qu'à partir du thread UI Android. L'appel de méthodes GoogleMap à partir d'un autre thread génère une exception.

Vous pouvez ajuster le point de vue d'une carte en modifiant la position de la caméra (au lieu de déplacer la carte). Vous pouvez utiliser la caméra de la carte pour définir des paramètres tels que la position, le niveau de zoom, l'angle d'inclinaison et l'orientation. Pour en savoir plus, consultez la section 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 permettant de signaler qu'une tâche est terminée ou annulée. 
interface GoogleMap.InfoWindowAdapter Fournit des vues permettant de personnaliser l'affichage 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 sera 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 a été arrêté ou lorsque la caméra commence à bouger pour une nouvelle raison. 
interface GoogleMap.OnCameraMoveListener Interface de rappel utilisée lorsque la caméra change de position. 
interface GoogleMap.OnCameraMoveStartedListener Interface de rappel utilisée lorsque le mouvement de la caméra commence. 
interface GoogleMap.OnCircleClickListener Interface de rappel utilisée lorsqu'un utilisateur clique sur un cercle
interface GoogleMap.OnGroundOverlayClickListener Interface de rappel utilisée lorsqu'un utilisateur clique sur une superposition au sol. 
interface GoogleMap.OnIndoorStateChangeListener Un écouteur pour les changements d'état intérieur
interface GoogleMap.OnInfoWindowClickListener Interface de rappel pour les événements de clic ou d'appui sur la fenêtre d'informations d'un repère. 
interface GoogleMap.OnInfoWindowCloseListener Interface de rappel pour les événements de fermeture dans la fenêtre d'informations d'un repère. 
interface GoogleMap.OnInfoWindowLongClickListener Interface de rappel utilisée 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 utilisée 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 utilisée lorsque l'utilisateur appuie de manière prolongée sur la carte. 
interface GoogleMap.OnMarkerClickListener Définit les signatures pour les méthodes appelées lorsque l'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 utilisée lorsque l'utilisateur clique sur le bouton "Ma position".
interface GoogleMap.OnMyLocationChangeListener Cette interface est obsolète. Utilisez com.google.android.gms.location.FusedLocationProviderApi à la place. FusedLocationProviderApi améliore la localisation et la consommation d'énergie. Il est utilisé par le point bleu "Ma position". Consultez le tutoriel sur la sélection du lieu actuel, qui utilise FusedLocationProviderApi, ou le guide du développeur de localisation.  
interface GoogleMap.OnMyLocationClickListener Interface de rappel utilisée lorsque l'utilisateur clique sur le point "Ma position" (qui indique la position de l'utilisateur).
interface GoogleMap.OnPoiClickListener Écouteur des pressions sur des POI. 
interface GoogleMap.OnPolygonClickListener Interface de rappel utilisée lorsqu'un utilisateur clique sur un polygone. 
interface GoogleMap.OnPolylineClickListener Interface de rappel utilisée lorsqu'un utilisateur clique sur une polyligne. 
interface GoogleMap.SnapshotReadyCallback Interface de rappel pour avertir lorsque l'instantané a été pris. 

Récapitulatif des constantes

int MAP_TYPE_HYBRID Cartes satellite avec un calque transparent des rues principales.
int MAP_TYPE_NONE Aucune tuile de carte de base.
int MAP_TYPE_NORMAL Cartes basiques
int MAP_TYPE_SATELLITE Cartes satellite sans libellé.
int MAP_TYPE_TERRAIN Cartes de relief.

Récapitulatif des méthodes publiques

Circle
addCircle(options de CircleOptions)
Ajoutez 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 PolylineOptions)
Ajoute une polyligne à cette carte.
TileOverlay
addTileOverlay(options TileOverlayOptions)
Ajoute une superposition de tuiles à cette carte.
void
animateCamera(mise à jour de CameraUpdate)
Anime le mouvement de la caméra depuis la position actuelle vers la position définie dans la mise à jour.
void
animateCamera(mise à jour de CameraUpdate, rappel GoogleMap.CancelableCallback)
Anime le mouvement de la caméra depuis la position actuelle vers 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 int, rappel GoogleMap.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, polylignes, polygones, superpositions, etc. de la carte.
CameraPosition
getCameraPosition()
Récupère la position actuelle de la caméra.
IndoorBuilding
getFocusedBuilding()
Récupère le bâtiment actuellement sélectionné.
int
getMapType()
Récupère le type de carte affiché.
float
getMaxZoomLevel()
Renvoie le niveau de zoom maximal pour la position actuelle de la caméra.
float
getMinZoomLevel()
Renvoie le niveau de zoom minimal.
Emplacement
getMyLocation()
Cette méthode est obsolète. use com.google.android.gms.location.FusedLocationProviderApi instead. FusedLocationProviderApi améliore la localisation et la consommation d'énergie. Il est utilisé par le point bleu "Ma position". Consultez MyLocationDemoActivity dans le dossier d'exemples d'applications (exemple de code) ou consultez le Guide du développeur de données de localisation.
Projection
getProjection()
Renvoie un objet Projection que vous pouvez utiliser pour convertir des coordonnées à l'écran en coordonnées de latitude/longitude.
UiSettings
getUiSettings()
Récupère les paramètres de l'interface utilisateur pour la carte.
boolean
isBuildingsEnabled()
Indique si les calques 3D sont activés.
boolean
isIndoorEnabled()
Détermine si les plans d'intérieur sont actuellement activés.
boolean
isMyLocationEnabled()
Récupère l'état du calque "Ma position".
boolean
isTrafficEnabled()
Vérifie si la carte dessine des données de trafic.
void
moveCamera(mise à jour de CameraUpdate)
Repositionne la caméra conformément aux instructions définies dans la mise à jour.
void
resetMinMaxZoomPreference()
Supprime les limites de zoom supérieure et inférieure précédemment spécifiées.
void
setBuildingsEnabled(booléen activé)
Active ou désactive les calques 3D.
void
setContentDescription(description de chaîne)
Définit une contentDescription pour la carte.
boolean
setIndoorEnabled(valeur booléenne activée)
Détermine 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 de LatLngBounds)
Spécifie un paramètre LatLngBounds permettant de contraindre la cible de la caméra, de sorte que lorsque les utilisateurs font défiler la carte et effectuent un panoramique, la cible de la caméra ne dépasse pas ces limites.
void
setLocationSource(source LocationSource)
Remplace la source de localisation du calque "Ma position".
boolean
setMapStyle(style MapStyleOptions)
Définit le style de la carte de base.
void
setMapType(type entier)
Définit le type de tuiles de carte à afficher.
void
setMaxZoomPreference(float maxZoomPreference)
Définit la limite supérieure préférée du zoom de la caméra.
void
setMinZoomPreference(float minZoomPreference)
Définit la limite inférieure préférée du zoom de la caméra.
void
setMyLocationEnabled(valeur booléenne activée)
Active ou désactive le calque "my-location".
void
void
setOnCameraIdleListener(écouteur GoogleMap.OnCameraIdleListener)
Définit un rappel invoqué lorsque le déplacement de la caméra est terminé.
void
setOnCameraMoveCanceledListener(écouteur GoogleMap.OnCameraMoveCanceledListener)
Définit un rappel 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 qui est invoqué à plusieurs reprises 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 la raison du mouvement de la caméra change.
void
setOnCircleClickListener(écouteur GoogleMap.OnCircleClickListener)
Définit un rappel qui est invoqué lorsqu'un utilisateur clique sur un cercle.
void
setOnGroundOverlayClickListener(écouteur GoogleMap.OnGroundOverlayClickListener)
Définit un rappel qui est invoqué lorsque l'utilisateur 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 qui est invoqué lorsqu'un internaute clique sur la fenêtre d'informations d'un repère.
void
setOnInfoWindowCloseListener(écouteur GoogleMap.OnInfoWindowCloseListener)
Définit un rappel qui est invoqué lorsque la fenêtre d'informations d'un repère est fermée.
void
setOnInfoWindowLongClickListener(écouteur GoogleMap.OnInfoWindowLongClickListener)
Définit un rappel qui est invoqué lorsque l'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 qui est invoqué lorsque l'utilisateur appuie sur la carte.
void
setOnMapLoadedCallback(rappel GoogleMap.OnMapLoadedCallback)
Définit un rappel qui est invoqué lorsque le rendu de cette carte est terminé.
void
setOnMapLongClickListener(écouteur GoogleMap.OnMapLongClickListener)
Définit un rappel qui est invoqué lorsque l'utilisateur appuie de manière prolongée sur la carte.
void
setOnMarkerClickListener(écouteur GoogleMap.OnMarkerClickListener)
Définit un rappel invoqué lorsqu'un utilisateur clique sur un repère.
void
setOnMarkerDragListener(écouteur GoogleMap.OnMarkerDragListener)
Définit un rappel invoqué lorsqu'un repère est déplacé.
void
setOnMyLocationButtonClickListener(écouteur GoogleMap.OnMyLocationButtonClickListener)
Définit un rappel qui est invoqué lorsque l'utilisateur clique sur le bouton "Ma position".
void
setOnMyLocationChangeListener(écouteur GoogleMap.OnMyLocationChangeListener)
Cette méthode est obsolète. use com.google.android.gms.location.FusedLocationProviderApi instead. FusedLocationProviderApi améliore la localisation et la consommation d'énergie. Il est utilisé par le point bleu "Ma position". Consultez MyLocationDemoActivity dans le dossier d'exemples d'applications (exemple de code) ou consultez le Guide du développeur de données de localisation.
void
setOnMyLocationClickListener(écouteur GoogleMap.OnMyLocationClickListener)
Définit un rappel qui est invoqué lorsque l'utilisateur clique sur le point "Ma position" (qui indique 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 qui est invoqué lorsque l'utilisateur clique sur un polygone.
void
setOnPolylineClickListener(écouteur GoogleMap.OnPolylineClickListener)
Définit un rappel qui est invoqué lorsque l'utilisateur clique sur une polyligne.
void
setPadding(int left, int top, int right, int bottom)
Définit la marge extérieure sur la carte.
void
setTrafficEnabled(valeur booléenne activée)
Active ou désactive le calque de trafic.
void
snapshot(rappel GoogleMap.SnapshotReadyCallback)
Prend un instantané de la carte.
void
snapshot(rappel GoogleMap.SnapshotReadyCallback, bitmap bitmap)
Prend un instantané de la carte.
void
stopAnimation()
Arrête l'animation de la caméra, le cas échéant.

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

Constantes

public static final int MAP_TYPE_HYBRID

Cartes satellite avec un calque transparent des rues principales.

Valeur de la constante: 4

public static final int MAP_TYPE_NONE

Aucune tuile de carte de base.

Valeur de la constante: 0

public static final int MAP_TYPE_NORMAL

Cartes basiques

Valeur de la constante: 1

public static final int MAP_TYPE_SATELLITE

Cartes satellite sans libellé.

Valeur de la constante: 2

public static final int MAP_TYPE_TERRAIN

Cartes de relief.

Valeur de la constante: 3

Méthodes publiques

public Circle addCircle (CircleOptions options)

Ajoutez un cercle à cette carte.

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

public GroundOverlay addGroundOverlay (GroundOverlayOptions options)

Ajoute une image à cette carte.

Paramètres
options Objet d'options de superposition au sol qui définit le rendu de la superposition. Une image (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 Marker addMarker (options MarkerOptions)

Ajoute un repère à cette carte.

L'icône du repère est affichée sur la carte à l'emplacement Marker.position. Cliquez sur le repère pour centrer la caméra sur le repère. Si Marker.title est défini, la carte affiche une zone d'informations avec le titre et l'extrait du repère. Si le repère est déplaçable, vous pouvez le déplacer en cliquant dessus de manière prolongée, puis en le faisant glisser.

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

public Polygon addPolygon (PolygonOptions)

Ajoute un polygone à cette carte.

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

public Polyline addPolyline (PolylineOptions)

Ajoute une polyligne à cette carte.

Paramètres
options Objet d'options de polyligne qui définit le mode d'affichage de la polyligne.
Renvoie
  • L'objet Polyline ajouté à la carte

public TileOverlay addTileOverlay (TileOverlayOptions)

Ajoute une superposition de tuiles à cette carte. Pour en savoir plus, consultez les 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 ajoutées à nouveau manuellement.

Paramètres
options Objet d'options de superposition de tuiles qui définit le rendu de la superposition. Les options doivent avoir un TileProvider spécifié, sinon une IllegalArgumentException sera générée.
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 depuis la position actuelle vers la position définie dans la mise à jour. Pendant l'animation, un appel à getCameraPosition() renvoie un emplacement intermédiaire de l'appareil photo.

Consultez CameraUpdateFactory pour obtenir un ensemble de mises à jour.

Paramètres
update Modification à appliquer à l'appareil photo.

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

Anime le mouvement de la caméra depuis la position actuelle vers 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 l'appareil photo.

Paramètres
update Modification à appliquer à l'appareil photo.
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 depuis onCancel().

public void animateCamera (mise à jour de CameraUpdate, rappel int durationMs, rappel GoogleMap.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 getCameraPosition() est appelé pendant l'animation, il renvoie la position actuelle de la caméra en vol.

Paramètres
update
durationMs Durée de l'animation en millisecondes. Cette valeur doit être strictement positive, sinon une IllegalArgumentException sera générée.
rappel Rappel facultatif à notifier à partir du thread UI Android lorsque l'animation s'arrête. Si l'animation s'arrête naturellement, le rappel est averti par onFinish(). Si l'animation s'arrête en raison d'un mouvement ultérieur de la caméra ou d'un geste de l'utilisateur, onCancel() est appelé. Le rappel ne doit pas tenter de déplacer ni d'animer la caméra dans sa méthode d'annulation. Si un rappel n'est pas requis, laissez-le par null.

public vide clear ()

Supprime tous les repères, polylignes, polygones, 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 n'est pas automatiquement mis à jour lorsque la caméra bouge.

Pour savoir comment changer la position de la caméra, consultez Caméra et vue.

Renvoie
  • Position actuelle de la caméra.

public IndoorBuilding getFocusedBuilding ()

Récupère le bâtiment actuellement sélectionné.

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

public int getMapType ()

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

Renvoie
  • Le type de carte

public float getMaxZoomLevel ()

Renvoie le niveau de zoom maximal pour la position actuelle de la caméra. Cela tient compte du type de carte actuellement utilisé. Par exemple, le niveau de zoom maximal pour le satellite ou le relief peut être inférieur à celui des tuiles de la carte de base.

Pour plus d'informations sur la modification du niveau de zoom de la caméra, consultez Caméra et vue.

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

public float getMinZoomLevel ()

Renvoie le niveau de zoom minimal. Il en va de même pour tous les points géographiques (contrairement au niveau de zoom maximal), mais cela peut varier selon les appareils et les tailles de carte.

Pour plus d'informations 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.
utilise com.google.android.gms.location.FusedLocationProviderApi à la place. FusedLocationProviderApi améliore la localisation et la consommation d'énergie. Il est utilisé par le point bleu "Ma position". Consultez MyLocationDemoActivity dans le dossier d'exemples d'applications (exemple de code) ou consultez le Guide du développeur de données de localisation.

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

Renvoie
Génère
IllegalStateException si le calque "my-location" n'est pas activé.

public Projection getProjection ()

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

Le Projection renvoyé est un instantané de la projection en cours et n'est pas automatiquement mis à jour lorsque la caméra bouge. Comme cette opération est coûteuse, vous ne devez 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 boolean isBuildingsEnabled ()

Indique si les calques 3D sont activés.

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 "Ma position".

Renvoie
  • true si le calque "ma position" est activé, false dans le cas contraire.

public boolean isTrafficEnabled ()

Vérifie si la carte dessine des données de trafic. Cette action dépend de la disponibilité des données de 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 conformément aux instructions définies dans la mise à jour. Le déplacement est instantané, et une getCameraPosition() ultérieure reflétera la nouvelle position. Consultez CameraUpdateFactory pour obtenir un ensemble de mises à jour.

Paramètres
update Modification à appliquer à l'appareil photo.

public vide resetMinMaxZoomPreference ()

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

public void setBuildingsEnabled (boolean enabled)

Active ou désactive les calques 3D.

Paramètres
activé true pour activer les bâtiments 3D et false pour désactiver les bâtiments 3D.

public void setContentDescription (Description de la chaîne)

Définit une contentDescription pour la carte.

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

Paramètres
description une chaîne à utiliser comme description.

public boolean setIndoorEnabled (boolean enabled)

Détermine si les plans d'intérieur doivent être activés. Actuellement, les plans d'intérieur ne peuvent être affichés que sur une 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 alors qu'ils sont activés sur une autre carte, rien ne se passera et cette opération renverra false. Lorsque la fonctionnalité Indoor n'est pas activée pour une carte, toutes les méthodes associées à l'intérieur renvoient null ou false.

Paramètres
activé true pour essayer d'activer les plans d'intérieur ; false pour les désactiver.
Renvoie
  • si l'activation des plans d'intérieur était possible.

public void setInfoWindowAdapter (adaptateur GoogleMap.InfoWindowAdapter)

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

Comme pour les écouteurs d'événements de la carte, cet état n'est pas sérialisé avec la carte. Si la carte est recréée (en raison d'une modification de la configuration, par exemple), vous devez 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 l'affichage par défaut du contenu dans les fenêtres d'informations.

public vide setLatLngBoundsForCameraTarget (limites LatLngBounds)

Spécifie un paramètre LatLngBounds permettant de contraindre la cible de la caméra, de sorte que lorsque les utilisateurs font défiler la carte et effectuent un panoramique, la cible de la caméra ne dépasse pas 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 l'appareil photo pour respecter ces limites, si possible. Notez qu'en raison de certaines considérations techniques, le SDK peut empêcher la cible de la caméra de respecter strictement les limites. (erreurs d'arrondi de précision à virgule flottante ou niveau de zoom très faible, par exemple).

Paramètres
limites Limites dans lesquelles la cible de la caméra doit être appliquée.

public void setLocationSource (LocationSource source)

Remplace la source de localisation du calque "Ma position".

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 (style MapStyleOptions)

Définit le style de la carte de base.

Les options de style vous permettent d'appliquer des styles personnalisés aux éléments géographiques et aux éléments de la carte. Consultez MapStyleOptions pour en savoir plus sur la définition des styles.

Définissez la valeur sur "null" pour effacer tout style personnalisé précédent.

Paramètres
style
Renvoie
  • true si le style a bien été analysé ; false si des problèmes ont été détectés avec MapStyleOptions, y compris, par exemple, un style JSON non analysable, un type d'élément géographique 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 (type entier)

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 setMaxZoomPreference (float maxZoomPreference)

Définit la limite supérieure préférée du 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 ce maximum, si possible. Notez qu'en raison de certaines considérations techniques, il est possible que le SDK ne permette pas aux utilisateurs d'effectuer un zoom trop profond sur la carte. Par exemple, une carte satellite ou en relief peut avoir un zoom maximal moins élevé que les tuiles de la carte de base.

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

Paramètres
maxZoomPreference La limite supérieure préférée.

public void setMinZoomPreference (float minZoomPreference)

Définit la limite inférieure préférée du 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 qu'en raison de certaines considérations techniques, il est possible que le SDK ne permette pas aux utilisateurs d'effectuer un zoom trop faible.

Le SDK résout les conflits de valeurs minimale et maximale. Si vous définissez le niveau de zoom minimal sur un niveau de zoom supérieur au niveau de zoom maximal actuel, le SDK utilise la nouvelle valeur minimale pour les valeurs minimale et maximale. Si vous définissez le zoom maximal sur un niveau de zoom inférieur au niveau minimal, le SDK utilise la nouvelle valeur maximale pour les valeurs minimale et maximale. Par exemple, supposons que le zoom minimal actuel soit de 8 et que le niveau maximal 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
minZoomPreference La limite inférieure préférée.

public void setMyLocationEnabled (boolean enabled)

Active ou désactive le calque "my-location".

Lorsque cette option est activée et que la position est disponible, le calque "Ma position" indique en permanence la position actuelle de l'utilisateur et sa direction, 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 l'orientation par la caméra).

Pour utiliser la fonctionnalité du calque "my-location", vous devez demander l'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érifie pas si les autorisations ci-dessus ont été accordées. Toutefois, vous devez vous assurer que l'utilisateur a accordé toutes les autorisations requises pour votre source d'emplacement personnalisée.

Paramètres
activé true pour activer, false pour 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 invoqué lorsque la caméra change.

Paramètres
écouteur Rappel invoqué lorsque la caméra change. Pour annuler la définition du rappel, utilisez null.

public void setOnCameraIdleListener (écouteur GoogleMap.OnCameraIdleListener)

Définit un rappel invoqué lorsque le déplacement de la caméra est terminé.

Paramètres
écouteur Rappel invoqué. Pour annuler la définition du rappel, utilisez null.

public void setOnCameraMoveCanceledListener (écouteur GoogleMap.OnCameraMoveCanceledListener)

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

Paramètres
écouteur Rappel invoqué. Pour annuler la définition du rappel, utilisez null. Ne mettez pas à jour ni n'animez la caméra depuis onCameraMoveCanceled().

public void setOnCameraMoveListener (écouteur GoogleMap.OnCameraMoveListener)

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

Paramètres
écouteur Rappel invoqué. Pour annuler la définition du rappel, utilisez null.

public void setOnCameraMoveStartedListener (écouteur GoogleMap.OnCameraMoveStartedListener)

Définit un rappel qui est invoqué lorsque la caméra commence à se déplacer ou lorsque la raison du mouvement de la caméra change.

Paramètres
écouteur Rappel invoqué. Pour annuler la définition du rappel, utilisez null. Ne mettez pas à jour ni n'animez la caméra depuis onCameraMoveStarted().

public void setOnCircleClickListener (écouteur GoogleMap.OnCircleClickListener)

Définit un rappel qui est invoqué lorsqu'un utilisateur clique sur un cercle.

Paramètres
écouteur Rappel invoqué lorsqu'un utilisateur clique sur un cercle. Pour annuler la définition du rappel, utilisez null.

public void setOnGroundOverlayClickListener (écouteur GoogleMap.OnGroundOverlayClickListener)

Définit un rappel qui est invoqué lorsque l'utilisateur clique sur une superposition au sol.

Paramètres
écouteur Rappel invoqué lorsque l'utilisateur clique sur une superposition au sol. Pour annuler la définition du rappel, utilisez null.

public void setOnIndoorStateChangeListener (écouteur GoogleMap.OnIndoorStateChangeListener)

Définit ou efface l'écouteur pour les événements en intérieur. Vous ne pouvez définir qu'un seul écouteur. La définition d'un nouvel écouteur supprime l'écouteur précédent.

Paramètres
écouteur Écouteur des événements d'intérieur s'ils ne sont pas nuls (sinon, il efface l'écouteur)

public void setOnInfoWindowClickListener (écouteur GoogleMap.OnInfoWindowClickListener)

Définit un rappel qui est invoqué lorsqu'un internaute clique sur la fenêtre d'informations d'un repère.

Paramètres
écouteur Rappel invoqué lorsqu'un utilisateur clique sur la fenêtre d'informations d'un repère. Pour annuler la définition du rappel, utilisez null.

public void setOnInfoWindowCloseListener (écouteur GoogleMap.OnInfoWindowCloseListener)

Définit un rappel qui est invoqué lorsque la fenêtre d'informations d'un repère est fermée.

Paramètres
écouteur Rappel invoqué lorsque la fenêtre d'informations d'un repère est fermée. Pour annuler la définition du rappel, utilisez null.

public void setOnInfoWindowLongClickListener (écouteur GoogleMap.OnInfoWindowLongClickListener)

Définit un rappel qui est invoqué lorsque l'utilisateur appuie de manière prolongée sur la fenêtre d'informations d'un repère.

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

public void setOnMapClickListener (écouteur GoogleMap.OnMapClickListener)

Définit un rappel qui est invoqué lorsque l'utilisateur appuie sur la carte.

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

public void setOnMapLoadedCallback (rappel GoogleMap.OnMapLoadedCallback)

Définit un rappel qui est invoqué lorsque le rendu de cette carte est terminé. Le rappel ne sera invoqué qu'une seule fois.

Si cette méthode est appelée lorsque le rendu de la carte est terminé, le rappel est invoqué immédiatement. Cet événement ne se déclenchera pas si la carte ne se charge jamais en raison de problèmes de connectivité, ou si la carte est modifiée en permanence et ne se charge jamais en raison d'interactions constantes de l'utilisateur avec la carte.

Paramètres
rappel Rappel invoqué lorsque le rendu de la carte est terminé. Pour annuler la définition du rappel, utilisez null.

public void setOnMapLongClickListener (écouteur GoogleMap.OnMapLongClickListener)

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

Paramètres
écouteur Rappel invoqué lorsque l'utilisateur appuie de manière prolongée sur la carte. Pour annuler la définition du rappel, utilisez null.

public void setOnMarkerClickListener (écouteur GoogleMap.OnMarkerClickListener)

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

Paramètres
écouteur Rappel invoqué lorsqu'un utilisateur clique sur un repère. Pour annuler la définition du rappel, utilisez null.

public void setOnMarkerDragListener (écouteur GoogleMap.OnMarkerDragListener)

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

Paramètres
écouteur Rappel invoqué lors des événements de déplacement d'un repère. Pour annuler la définition du rappel, utilisez null.

public void setOnMyLocationButtonClickListener (écouteur GoogleMap.OnMyLocationButtonClickListener)

Définit un rappel qui est invoqué lorsque l'utilisateur clique sur le bouton "Ma position".

Si listener renvoie true, l'événement est consommé, et le comportement par défaut ne se produira pas. Si la valeur false est renvoyée, 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é lorsque l'utilisateur clique sur le bouton "Ma position".

public void setOnMyLocationChangeListener (écouteur GoogleMap.OnMyLocationChangeListener)

Cette méthode est obsolète.
utilise com.google.android.gms.location.FusedLocationProviderApi à la place. FusedLocationProviderApi améliore la localisation et la consommation d'énergie. Il est utilisé par le point bleu "Ma position". Consultez MyLocationDemoActivity dans le dossier d'exemples d'applications (exemple de code) ou consultez le Guide du développeur de données de localisation.

Définit un rappel qui est invoqué lorsque le point "Ma position" change de position.

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

public void setOnMyLocationClickListener (écouteur GoogleMap.OnMyLocationClickListener)

Définit un rappel qui est invoqué lorsque l'utilisateur clique sur le point "Ma position" (qui indique la position de l'utilisateur).

Paramètres
écouteur Rappel invoqué lorsque l'utilisateur clique 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 qui est invoqué lorsque l'utilisateur clique sur un polygone.

Paramètres
écouteur Rappel invoqué lorsque l'utilisateur clique sur un polygone. Pour annuler la définition du rappel, utilisez null.

public void setOnPolylineClickListener (écouteur GoogleMap.OnPolylineClickListener)

Définit un rappel qui est invoqué lorsque l'utilisateur clique sur une polyligne.

Paramètres
écouteur Rappel invoqué lorsque l'utilisateur clique sur une polyligne. Pour annuler la définition du rappel, utilisez null.

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

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

Cette méthode vous permet de définir une région visible sur la carte afin de signaler à la carte que certaines parties de la carte autour des bords peuvent être masquées, en définissant une marge exté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 déplacés par rapport au centre de la zone visible, etc.

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

public void setTrafficEnabled (boolean enabled)

Active ou désactive le calque de trafic.

Paramètres
activé

public void instantané (rappel GoogleMap.SnapshotReadyCallback)

Prend un instantané de la carte.

Vous pouvez utiliser des instantanés dans votre application lorsqu'il est difficile, voire impossible, d'utiliser une carte interactive. Par exemple, les images produites 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 lui permettant de reconstruire la carte pour le nouvel utilisateur au lieu d'un instantané.

Paramètres
rappel Méthode de rappel invoquée lors de la prise de l'instantané.

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

Prend un instantané de la carte.

Cette méthode est équivalente à snapshot(SnapshotReadyCallback), mais vous permet de fournir un Bitmap préalloué. Si le bitmap ne correspond pas aux dimensions actuelles de la carte, un autre bitmap correspondant aux dimensions de la carte est alloué.

Bien que, dans la plupart des cas, l'objet transmis par la méthode de rappel soit le même que celui indiqué dans le paramètre de cette méthode, il arrive que l'objet renvoyé soit différent (par exemple, si les dimensions de la vue ont changé au moment où l'instantané est pris). Vous ne devez donc faire confiance qu'au contenu du bitmap transmis par la méthode de rappel.

Paramètres
rappel Méthode de rappel invoquée lors de la prise de l'instantané.
bitmap Bitmap préalloué. Si la valeur est null, le comportement est semblable à snapshot(SnapshotReadyCallback).

public vide stopAnimation ()

Arrête l'animation de la caméra, le cas échéant. Lorsque la méthode est appelée, la caméra cesse immédiatement de se déplacer et reste dans cette position.