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 estfalse
. - 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émentMap<Marker, Object>
distinct. Autre exemple, vous pouvez associer un IDString
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 |
hashCode()
|
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 | |
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 | |
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)
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, renvoiefalse
.
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
|
---|