Repère

public final class Marker étend l'objet

Une icône placée à un point précis de la surface de la carte. Une icône de repère est orientée par rapport à l'écran de l'appareil et non par rapport à la surface de la carte. En d'autres termes, elle ne changera pas nécessairement d'orientation en raison d'une rotation, d'une inclinaison ou d'un zoom sur la carte.

Un repère possède les propriétés suivantes:

Alpha
Définit l'opacité du repère. La valeur par défaut est 1.0.
Anchor
Point sur l'image qui sera placé à la position LatLng du repère. La valeur par défaut est de 50% entre le bord gauche et le bas de l'image.
Poste
Valeur LatLng correspondant à la position du repère sur la carte. Vous pouvez modifier cette valeur à tout moment si vous souhaitez déplacer le repère.
Titre
Chaîne de texte qui s'affiche dans une fenêtre d'informations lorsque l'utilisateur appuie sur le repère. Vous pouvez modifier cette valeur à tout moment.
Snippet
Texte supplémentaire affiché sous le titre. Vous pouvez modifier cette valeur à tout moment.
Icon
Image bitmap affichée pour le repère. Si l'icône n'est pas définie, une icône par défaut s'affiche. Vous pouvez spécifier une autre couleur pour l'icône par défaut à l'aide de defaultMarker(float).
État du déplacement
Si vous souhaitez autoriser l'utilisateur à faire glisser le repère, définissez cette propriété sur true. Vous pouvez modifier cette valeur à tout moment. La valeur par défaut est false.
Visibilité
Par défaut, le repère est visible. Pour rendre le repère invisible, définissez cette propriété sur false. Vous pouvez modifier cette valeur à tout moment.
Flat ou Billboard
Si le repère est plat sur la carte, il reste bloqué sur la carte lorsque la caméra pivote et s'incline, mais sa taille reste la même lorsque la caméra zoome, contrairement à un GroundOverlay. Si le repère est un panneau d'affichage, il est toujours dessiné face à la caméra, et pivote et s'incline avec elle. La valeur par défaut est un panneau d'affichage (false).
Rotation
Rotation du repère en degrés dans le sens des aiguilles d'une montre autour de son point d'ancrage. L'axe de rotation est perpendiculaire au repère. Une rotation de 0 correspond à la position par défaut du repère. Lorsque le repère est plat sur la carte, la position par défaut est alignée sur le nord et la rotation est définie de sorte que le repère reste toujours à plat sur la carte. Lorsque le repère est un panneau d'affichage, la position par défaut est à la verticale vers le haut, et la rotation est définie pour que le repère soit toujours face à la caméra. La valeur par défaut est 0.
zIndex
Ordre de traçage du repère. Les repères sont dessinés dans l'ordre du zIndex, avec le repère zIndex le plus élevé au-dessus. En définissant la propriété zIndex pour chaque repère, vous pouvez contrôler l'élément tactile que votre utilisateur est le plus susceptible d'atteindre. La valeur par défaut est 0.
Tag
Object associé au repère. Par exemple, Object peut contenir des données sur ce que le repère représente. Cette opération est plus facile que de stocker un élément Map<Marker, Object> distinct. Autre exemple, vous pouvez associer un ID String correspondant à l'ID d'un ensemble de données. Le SDK Google Maps pour Android ne lit ni n'écrit cette propriété.

Les méthodes de cette classe doivent être appelées sur le thread UI Android. Dans le cas contraire, une exception IllegalStateException est générée au moment de l'exécution.

Exemple

GoogleMap map = ... // get a map.
 // Add a marker at San Francisco.
 Marker marker = map.addMarker(new MarkerOptions()
     .position(new LatLng(37.7750, 122.4183))
     .title("San Francisco")
     .snippet("Population: 776733"));
 

Guide du développeur

Pour en savoir plus, consultez le guide du développeur sur les repères.

Récapitulatif des classes imbriquées

@interface Marker.CollisionBehavior Indique comment le repère est traité en cas de collision avec d'autres repères ou libellés de la carte de base. 

Récapitulatif des méthodes publiques

boolean
est égal à(autre objet)
Vérifie si cet élément Marker est égal à un autre.
float
getAlpha()
Récupère la valeur alpha du repère.
Chaîne
getId()
Récupère l'identifiant de ce repère.
LatLng
getPosition()
Renvoie la position du repère.
float
getRotation()
Récupère la rotation du repère.
Chaîne
getSnippet()
Récupère l'extrait du repère.
Objet
getTag()
Récupère le tag du repère.
Chaîne
getTitle()
Récupère le titre du repère.
float
getZIndex()
Renvoie le zIndex du repère.
int
void
hideInfoWindow()
Masque la fenêtre d'informations si elle est affichée depuis ce repère.
boolean
isDraggable()
Récupère la possibilité de déplacement du repère.
boolean
isFlat()
Récupère le paramètre plat du repère.
boolean
isInfoWindowShown()
Indique si la fenêtre d'informations est actuellement affichée au-dessus de ce repère.
boolean
isVisible()
Récupère le paramètre de visibilité de ce repère.
void
supprimer()
Supprime ce repère de la carte.
void
setAlpha(float alpha)
Définit la valeur alpha (opacité) du repère.
void
setAnchor(float anchorU, float anchorV)
Définit le point d'ancrage du repère.
void
setDraggable(booléen déplaçable)
Définit la capacité de déplacement du repère.
void
setFlat(booléen plat)
Détermine si ce repère doit être plat sur la carte true ou sur un panneau d'affichage faisant face à la caméra false.
void
setIcon(BitmapDescriptor iconDescriptor)
Définit l'icône du repère.
void
setInfoWindowAnchor(float anchorU, float anchorV)
Spécifie le point de l'image du repère auquel ancrer la fenêtre d'informations lorsqu'elle est affichée.
void
setPosition(latlng LatLng)
Définit l'emplacement du repère.
void
setRotation(rotation de type float)
Définit la rotation du repère en degrés dans le sens des aiguilles d'une montre autour du point d'ancrage du repère.
void
setSnippet(extrait de chaîne)
Définit l'extrait du repère.
void
setTag(tag d'objet)
Définit le tag du repère.
void
setTitle(Titre de la chaîne)
Définit le titre du repère.
void
setVisible(booléen visible)
Définit la visibilité de ce repère.
void
setZIndex(zIndex flottant)
Définit le zIndex du repère.
void
showInfoWindow()
Affiche la fenêtre d'informations de ce repère sur la carte si ce repère est isVisible().

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

Méthodes publiques

public boolean est égal à (objet autre)

Vérifie si cet élément Marker est égal à un autre.

Paramètres
other un Object.
Renvoie
  • "true" si les deux objets sont le même, c'est-à-dire que ceci == other.

public float getAlpha ()

Récupère la valeur alpha du repère.

Renvoie
  • la valeur alpha du repère, dans la plage [0, 1].

public String getId ()

Récupère l'identifiant de ce repère. L'ID est unique parmi tous les repères d'une carte.

Renvoie
  • l'identifiant de ce repère.

public LatLng getPosition ()

Renvoie la position du repère.

Renvoie
  • Objet LatLng spécifiant la position actuelle du repère.

public float getRotation ()

Récupère la rotation du repère.

Renvoie
  • la rotation du repère en degrés dans le sens des aiguilles d'une montre à partir de la position par défaut.

public String getSnippet ()

Récupère l'extrait du repère.

Renvoie
  • Chaîne contenant l'extrait du repère.

objet public getTag ()

Récupère le tag du repère.

Renvoie
  • la balise si une balise a été définie avec setTag ; null si aucune balise n'a été définie.

public String getTitle ()

Récupère le titre du repère.

Renvoie
  • Chaîne qui contient le titre du repère.

public float getZIndex ()

Renvoie le zIndex du repère.

Renvoie
  • le zIndex de ce repère.

public int hashCode ()

public vide hideInfoWindow ()

Masque la fenêtre d'informations si elle est affichée depuis ce repère.

Cette méthode n'a aucun effet si ce repère n'est pas visible.

public boolean isDraggable ()

Récupère la possibilité de déplacement du repère. Lorsqu'un repère est déplaçable, l'utilisateur peut le déplacer en appuyant dessus de manière prolongée.

Renvoie
  • true si le repère est déplaçable ; sinon, renvoie false.

public boolean isFlat ()

Récupère le paramètre plat du repère.

Renvoie
  • true si le repère est plat sur la carte ; false si le repère doit faire face à la caméra.

public boolean isInfoWindowShown ()

Indique si la fenêtre d'informations est actuellement affichée au-dessus de ce repère. Cela ne prend pas en compte si la fenêtre d'informations est réellement visible à l'écran.

public boolean isVisible ()

Récupère le paramètre de visibilité de ce repère. Notez que cela n'indique pas si le repère se trouve dans la fenêtre d'affichage de l'écran. Elle indique si le repère sera dessiné s'il est contenu dans la fenêtre d'affichage de l'écran.

Renvoie
  • la visibilité de ce repère.

public vide remove ()

Supprime ce repère de la carte. Une fois qu'un repère a été supprimé, le comportement de toutes ses méthodes n'est plus défini.

public void setAlpha (float alpha)

Définit la valeur alpha (opacité) du repère. Il s'agit d'une valeur comprise entre 0 et 1, où 0 signifie que le repère est totalement transparent et 1 signifie que le repère est complètement opaque.

Paramètres
alpha

public void setAnchor (float anchorU, float anchorV)

Définit le point d'ancrage du repère.

L'ancre indique le point de l'image d'icône qui est ancré à la position du repère sur la surface de la Terre.

Le point d'ancrage est spécifié dans l'espace continu [0.0, 1.0] x [0.0, 1.0], où (0, 0) correspond à l'angle supérieur gauche de l'image et (1, 1) à l'angle inférieur droit. Le point d'ancrage d'une image L x H est le point de grille discrète le plus proche dans une grille (W + 1) x (H + 1), obtenu en mettant à l'échelle l'arrondi. Par exemple, dans une image 4 x 2, le point d'ancrage (0,7, 0,6) est résolu au point de grille (3, 1).

 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----+-----+
 |     |     |   X |     |   (U, V) = (0.7, 0.6)
 |     |     |     |     |
 *-----+-----+-----+-----*
 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----X-----+   (X, Y) = (3, 1)
 |     |     |     |     |
 |     |     |     |     |
 *-----+-----+-----+-----*
 

Paramètres
anchorU Coordonnée u de l'ancre, exprimée en ratio de la largeur de l'image (dans la plage [0, 1]).
anchorV Coordonnée v de l'ancre, exprimée en ratio avec la hauteur de l'image (dans la plage [0, 1]).

public void setDraggable (boolean draggable)

Définit la capacité de déplacement du repère. Lorsqu'un repère est déplaçable, l'utilisateur peut le déplacer en appuyant dessus de manière prolongée.

Paramètres
déplaçable

public void setFlat (boolean flat)

Détermine si ce repère doit être plat sur la carte true ou sur un panneau d'affichage faisant face à la caméra false.

Paramètres
inchangés

public vide setIcon (BitmapDescriptor iconDescriptor)

Définit l'icône du repère.

Paramètres
iconDescriptor Si la valeur est nulle, le repère par défaut est utilisé.

public vide setInfoWindowAnchor (float anchorU, float anchorV)

Spécifie le point de l'image du repère auquel ancrer la fenêtre d'informations lorsqu'elle est affichée. Cet élément est spécifié dans le même système de coordonnées que l'ancre. Pour en savoir plus, consultez setAnchor(float, float). La valeur par défaut est le milieu supérieur de l'image.

Paramètres
anchorU Coordonnée u de l'ancre de la fenêtre d'informations, exprimée sous forme de ratio de la largeur de l'image (dans la plage [0, 1]).
anchorV Coordonnée v de l'ancre de la fenêtre d'informations, exprimée sous forme de ratio de la hauteur de l'image (dans la plage [0, 1]).

public vide setPosition (Latlng LatLng)

Définit l'emplacement du repère.

Paramètres
latitude/longitude

public void setRotation (rotation à virgule flottante)

Définit la rotation du repère en degrés dans le sens des aiguilles d'une montre autour du point d'ancrage du repère. L'axe de rotation est perpendiculaire au repère. Une rotation de 0 correspond à la position par défaut du repère.

Paramètres
rotation

public void setSnippet (extrait de chaîne)

Définit l'extrait du repère.

Paramètres
extrait [context sensitive] Si la valeur est nulle, l'extrait est effacé.

public vide setTag (tag d'objet)

Définit le tag du repère.

Vous pouvez utiliser cette propriété pour associer un Object arbitraire à ce repère. Par exemple, Object peut contenir des données sur ce que le repère représente. Cette opération est plus facile que de stocker un élément Map<Marker, Object> distinct. Autre exemple, vous pouvez associer un ID String correspondant à l'ID d'un ensemble de données. Le SDK Google Maps pour Android ne lit ni n'écrit cette propriété. Vous êtes tenu d'appeler setTag(null) pour effacer la balise lorsque vous n'en avez plus besoin afin d'éviter les fuites de mémoire dans votre application.

Paramètres
tag Si la valeur est "null", la balise est effacée.

public void setTitle (Titre de la chaîne)

Définit le titre du repère.

Paramètres
title Si la valeur est nulle, le titre est effacé.

public void setVisible (boolean visible)

Définit la visibilité de ce repère. S'il est défini sur false et qu'une fenêtre d'informations s'affiche pour ce repère, cette option la masquera.

Paramètres
visible

public void setZIndex (float zIndex)

Définit le zIndex du repère.

Paramètres
zIndex

public vide showInfoWindow ()

Affiche la fenêtre d'informations de ce repère sur la carte si ce repère est isVisible().

Génère
IllegalArgumentException si marker ne figure pas sur cette carte