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 plutôt qu'à la surface de la carte. Autrement dit, elle ne change pas nécessairement d'orientation en cas de rotation de la carte, d'inclinaison ou de zoom.
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% à partir de la gauche et de la base de l'image. - Position
- Valeur
LatLng
de 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.
- Icône
- Image bitmap affichée pour le repère. Si cette icône n'est pas configurée, une icône par défaut s'affiche. Vous pouvez spécifier une autre couleur de 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. - Plat ou affichage
- Si le repère est plat par rapport à la carte, il reste attaché à la carte lorsque la caméra pivote et s'incline, mais reste la même que celle de son zoom, contrairement à
GroundOverlay
. Si le repère est un panneau d'affichage, il est toujours dessiné face à la caméra. Il 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 du 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 telle 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 de sorte que le repère soit toujours face à la caméra. La valeur par défaut est 0.
- z-index
- Ordre de traçage du repère. Les repères sont présentés dans l'ordre de la valeur zIndex, la plus élevée étant définie en haut. En définissant la propriété zIndex de chaque repère, vous pouvez contrôler l'élément tactile sur lequel l'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. C'est plus facile que de stocker unMap<Marker, Object>
distinct. Vous pouvez également 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. Sinon, une erreur 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 plus d'informations, consultez le guide du développeur Markers.
Récapitulatif des classes imbriquées
@interface | Marker.CollisionBehavior | Indique comment le repère est traité lorsqu'il est en collision avec d'autres repères ou libellés de carte de base. |
Récapitulatif des méthodes publiques
booléen |
est égal(e) à(Objet autre)
Teste si
Marker est égal à un autre. |
float (nombre à virgule flottante) |
getAlpha
Récupère la version alpha du repère.
|
String |
getId
Récupère l'identifiant de ce repère.
|
LatLng |
getPosition
Renvoie la position du repère.
|
float (nombre à virgule flottante) |
getRotation
Récupère la rotation du repère.
|
String |
getSnippet
Récupère l'extrait de code du repère.
|
Objet |
getTag
Récupère le tag du repère.
|
String |
getTitle
Récupère le titre du repère.
|
float (nombre à virgule flottante) |
getZIndex
Renvoie la valeur zIndex du repère.
|
int | |
void |
hideInfoWindow
Masque la fenêtre d'informations si elle est affichée à partir de ce repère.
|
booléen |
isDraggable()
Récupère la glabilité du repère.
|
booléen |
isFlat
Récupère les paramètres plats du repère.
|
booléen |
isInfoWindowShowing()
Indique si la fenêtre d'informations est actuellement affichée au-dessus de ce repère.
|
booléen |
isVisible()
Récupère le paramètre de visibilité de ce repère.
|
void |
remove
Supprime ce repère de la carte.
|
void |
setAlpha(alpha alpha flottant)
Définit la valeur alpha (opacité) du repère.
|
void |
setAnchor(ancre flottanteU, ancre flottanteV)
Définit le point d'ancrage du repère.
|
void |
setDraggable(valeur déplaçable booléenne)
Définit la glabilité du repère.
|
void |
setFlat(valeur booléenne)
Détermine si ce repère doit être plat par rapport à la carte
true ou par un panneau d'affichage face à la caméra false . |
void | |
void |
setInfoWindowAnchor(ancre flottanteU, ancre flottanteV)
Spécifie le point dans l'image de repère auquel ancrer la fenêtre d'informations lors de son affichage.
|
void | |
void |
setRotation (rotation flottante)
Définit la rotation du repère en degrés dans le sens des aiguilles d'une montre autour du point d'ancrage.
|
void |
setSnippet(Extrait de chaîne)
Définit l'extrait de code 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(valeur booléenne visible)
Définit la visibilité de ce repère.
|
void |
setZIndex(zIndex flottant)
Définit la valeur zIndex du repère.
|
void |
showInfoWindow
Affiche la fenêtre d'informations de ce repère sur la carte, s'il est
isVisible() . |
Récapitulatif des méthodes héritées
Méthodes publiques
public boolean est égal à (Object other)
float public getAlpha ()
Récupère la version 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'identifiant sera 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.
float public getRotation ()
Récupère la rotation du repère.
Renvoie
- 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 de code du repère.
Renvoie
- Chaîne contenant l'extrait de code du repère.
public Object getTag ()
Récupère le tag du repère.
Renvoie
- le tag si un tag a été défini avec
setTag
;null
si aucun tag n'a été défini.
public String getTitle ()
Récupère le titre du repère.
Renvoie
- Chaîne contenant le titre du repère.
float public getZIndex ()
Renvoie la valeur zIndex du repère.
Renvoie
- zIndex de ce repère.
public inthashCode()
public void hideInfoWindow ()
Masque la fenêtre d'informations si elle est affichée à partir de 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 glabilité du repère. Lorsqu'un repère peut être déplacé, l'utilisateur peut le déplacer en appuyant de manière prolongée sur le repère.
Renvoie
true
si le repère est déplaçable. Sinon, renvoiefalse
.
public boolean isFlat ()
Récupère les paramètres plats du repère.
Renvoie
true
si le repère est plat par rapport à la carte ;false
si le repère doit être face à la caméra.
public boolean isInfoWindowShowing ()
Indique si la fenêtre d'informations est actuellement affichée au-dessus de ce repère. Ce paramètre ne tient pas compte du fait que 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 tracé s'il est contenu dans la fenêtre d'affichage.
Renvoie
- la visibilité de ce repère.
public void supprimer ()
Supprime ce repère de la carte. Une fois un repère supprimé, le comportement de toutes ses méthodes n'est pas 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, qui signifie qu'il est complètement opaque.
Paramètres
alpha |
---|
public void setAnchor (ancre flottante, ancre flottanteV)
Définit le point d'ancrage du repère.
L'ancre indique le point de l'image d'icône 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 W x H est le point de grille discret le plus proche d'une grille (W + 1) x (H + 1), obtenu en appliquant la mise à l'échelle, puis l'arrondi. Par exemple, dans une image 4x2, le point d'ancrage (0.7, 0.6) correspond au point de grille (3, 1).
*-----+-----+-----+-----* | | | | | | | | | | +-----+-----+-----+-----+ | | | X | | (U, V) = (0.7, 0.6) | | | | | *-----+-----+-----+-----* *-----+-----+-----+-----* | | | | | | | | | | +-----+-----+-----X-----+ (X, Y) = (3, 1) | | | | | | | | | | *-----+-----+-----+-----*
Paramètres
ancre U | coordonnées u de l'ancre, exprimées en tant que ratio de la largeur de l'image (dans la plage [0, 1]). |
---|---|
ancreV | coordonnée v de l'ancre, exprimée par un ratio de hauteur d'image (dans la plage [0, 1]). |
public void setDraggable (booléen, déplaçable)
Définit la glabilité du repère. Lorsqu'un repère peut être déplacé, l'utilisateur peut le déplacer en appuyant de manière prolongée sur le repère.
Paramètres
déplaçable |
---|
public void setFlat (valeur booléenne)
Détermine si ce repère doit être plat par rapport à la carte true
ou par un panneau d'affichage face à la caméra false
.
Paramètres
stable |
---|
public void setIcon (BitmapDescriptor iconDescriptor)
Définit l'icône du repère.
Paramètres
icône iconDescriptor | Si la valeur est "null", le repère par défaut est utilisé. |
---|
public void setInfoWindowAnchor (ancre flottante, ancre flottanteV)
Spécifie le point dans l'image de repère auquel ancrer la fenêtre d'informations lors de son affichage. Celle-ci est spécifiée dans le même système de coordonnées que l'ancre. Consultez la section setAnchor(float, float)
pour plus d'informations. La valeur par défaut est le milieu supérieur de l'image.
Paramètres
ancre U | Coordonnée u de l'ancre de la fenêtre d'informations, exprimée par un ratio de largeur d'image (dans la plage [0, 1]). |
---|---|
ancreV | coordonnée v de l'ancre de la fenêtre d'informations, exprimée par un ratio de hauteur d'image (dans la plage [0, 1]). |
public void setRotation (rotation flottante)
Définit la rotation du repère en degrés dans le sens des aiguilles d'une montre autour du 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.
Paramètres
rotation |
---|
public void setSnippet (extrait de chaîne)
Définit l'extrait de code du repère.
Paramètres
extrait | Si la valeur est "null", l'extrait est effacé. |
---|
public void 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 méthode est plus facile que de stocker un Map<Marker, Object>
distinct. Vous pouvez également 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 devez appeler setTag(null)
pour supprimer le tag 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", le tag est effacé. |
---|
public void setTitle (titre de la chaîne)
Définit le titre du repère.
Paramètres
title | Si la valeur est "null", le titre est effacé. |
---|
public void setVisible (valeur booléenne visible)
Définit la visibilité de ce repère. Si la valeur est false
et qu'une fenêtre d'informations s'affiche actuellement pour ce repère, la fenêtre d'informations sera masquée.
Paramètres
visible |
---|
public void setZIndex (float zIndex)
Définit la valeur zIndex du repère.
Paramètres
z-index |
---|
public void showInfoWindow ()
Affiche la fenêtre d'informations de ce repère sur la carte, s'il est isVisible()
.
Génère
IllegalArgumentException | si marker n'est pas sur cette carte
|
---|