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 | |
GroundOverlay | |
Marker | |
Polygon | |
Polyline | |
TileOverlay | |
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 | |
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 |
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) .
|
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 | |
void | |
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.
public static final int MAP_TYPE_NONE
Aucune tuile de carte de base.
public static final int MAP_TYPE_NORMAL
Cartes basiques
public static final int MAP_TYPE_SATELLITE
Cartes satellite sans libellé.
public static final int MAP_TYPE_TERRAIN
Cartes de relief.
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
GroundOverlay
ajouté à la carte.
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
Marker
ajouté à la carte.
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
TileOverlay
ajouté à la carte.
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
- Le
user location
actuellement affiché.
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
- Le
Projection
de la carte dans son état actuel.
public UiSettings getUiSettings ()
Récupère les paramètres de l'interface utilisateur pour la carte.
Renvoie
UiSettings
pour cette carte.
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 avecMapStyleOptions
, 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 estfalse
, 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:
MAP_TYPE_NORMAL
: carte de base.MAP_TYPE_SATELLITE
: images satelliteMAP_TYPE_HYBRID
: images satellite avec routes et libellés.MAP_TYPE_TERRAIN
: données topographiquesMAP_TYPE_NONE
: aucune tuile de carte de base.
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.