Icône placée à un point particulier de la surface de la carte. Une icône de repère est dessinée avec une orientation à l'écran de l'appareil plutôt qu'à la surface de la carte ; c'est-à-dire qu'elle ne change pas nécessairement en cas de rotation, d'inclinaison ou de zoom de la carte.
Un repère a 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 50% à partir de la gauche et du bas de l'image. - Position
- Valeur
LatLng
correspondant à la position du repère sur la carte. Vous pouvez modifier cette valeur à l'adresse à 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.
- Extrait
- 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 l'icône n'est pas définie, une icône par défaut est
affiché. 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
. Toi peut 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 Billboard
- Si le repère est plat par rapport à la carte, il reste bloqué sur la carte en tant que caméra.
pivote et s'incline, mais conserve la même taille que la caméra, contrairement à une
GroundOverlay
. Si le repère est un panneau d'affichage, il est toujours dessiné de face à la caméra. peut pivoter et s'incliner en même temps que la caméra. 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 du repère. L'axe de rotation est perpendiculaire au repère. Une rotation de 0 correspond à la valeur la position du repère. Lorsque le repère est plat sur la carte, la position par défaut est le nord. et que 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 telle que le repère doit toujours être face à la caméra. La valeur par défaut est 0.
- zIndex
- Ordre de traçage du repère. Les marqueurs sont dessinés dans l'ordre du zIndex, avec les le repère zIndex le plus élevé est dessiné au-dessus. En définissant la propriété zIndex pour chaque repère, vous pouvez : contrôler l'élément tactile que 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. Autre exemple : vous pouvez associer un IDString
correspondant à l'identifiant d'un ensemble de données. Le SDK Google Maps pour Android ne se lit ni ne lit écrit cette propriété.
Les méthodes de cette classe doivent être appelées sur le thread UI Android. Si ce n'est pas le cas, 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 en savoir plus, consultez l'article du développeur de Markers. .
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 bases. étiquettes de carte. |
Récapitulatif des méthodes publiques
booléen | |
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()
|
vide |
hideInfoWindow()
Masque la fenêtre d'informations si elle est affichée à partir de ce repère.
|
booléen |
isDraggable()
Récupère le repère.
|
booléen |
isFlat()
Récupère le paramètre "plate" du repère.
|
booléen |
isInfoWindowShown()
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.
|
vide |
remove()
Supprime ce repère de la carte.
|
vide |
setAlpha(float alpha)
Définit la valeur alpha (opacité) du repère.
|
vide |
setAnchor(ancre flottanteU, ancre flottanteV)
Définit le point d'ancrage du repère.
|
vide |
setDraggable(boolean draggable)
Définit la déplaçabilité du repère.
|
vide |
setFlat(booléen plat)
Détermine si ce repère doit être plat par rapport à la carte
true ou à un panneau d'affichage face au
caméra false . |
vide | |
vide |
setInfoWindowAnchor(ancre flottanteU, ancre flottanteV)
Spécifie le point, dans l'image du repère, auquel ancrer la fenêtre d'informations lorsqu'elle se trouve
affiché.
|
vide | |
vide |
setRotation(rotation flottante)
Définit la rotation du repère en degrés dans le sens des aiguilles d'une montre par rapport au point d'ancrage du repère.
|
vide |
setSnippet(extrait de chaîne)
Définit l'extrait du repère.
|
vide |
setTag(tag d'objet)
Définit le tag du repère.
|
vide |
setTitle(Titre de la chaîne)
Définit le titre du repère.
|
vide |
setVisible(boolean visible)
Définit la visibilité de ce repère.
|
vide |
setZIndex(float zIndex)
Définit le zIndex du repère.
|
vide |
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 Booléen est égal(e) à (autre objet)
public se superposer getAlpha ()
Récupère la valeur alpha du repère.
Renvoie
- la valeur alpha du repère dans la plage [0, 1].
public Chaîne getId ()
Récupère l'identifiant de ce repère. Cet identifiant 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 se superposer 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 Chaîne getSnippet ()
Récupère l'extrait du repère.
Renvoie
- Chaîne contenant l'extrait du repère.
public Objet getTag ()
Récupère le tag du repère.
Renvoie
- le tag si un tag a été défini avec
setTag
;null
si aucune balise n'a été définie.
public Chaîne getTitle ()
Récupère le titre du repère.
Renvoie
- Chaîne contenant le titre du repère.
public se superposer getZIndex ()
Renvoie le zIndex du repère.
Renvoie
- le zIndex de ce repère.
public entier hashCode ()
public vide 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 Booléen isDraggable ()
Récupère le repère. Lorsqu'un repère est déplaçable, l'utilisateur peut le déplacer en en appuyant de manière prolongée sur le repère.
Renvoie
true
si le repère est déplaçable ; Sinon, renvoiefalse
.
public Booléen isFlat ()
Récupère le paramètre "plate" du repère.
Renvoie
true
si le repère est plat par rapport à la cartefalse
si le repère doit face à la caméra.
public Booléen isInfoWindowShown ()
Indique si la fenêtre d'informations est actuellement affichée au-dessus de ce repère. Cela ne tient pas compte si la fenêtre d'informations est réellement visible à l'écran.
public Booléen 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 contenue dans la fenêtre d'affichage de l'écran.
Renvoie
- la visibilité de ce repère.
public vide supprimer ()
Supprime ce repère de la carte. Une fois qu'un repère a été supprimé, le comportement de tous ses méthodes n'est pas définie.
public vide setAlpha (alpha flottant)
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 la valeur 1 signifie que le repère est complètement opaque.
Paramètres
alpha |
---|
public vide setAnchor (ancre flottanteU, ancre flottanteV)
Définit le point d'ancrage du repère.
L'ancre indique le point de l'icône qui est ancré à la position du repère. à 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 dans une image L x H est le point de grille discret le plus proche dans une image (W + 1) x (H+1), obtenue en effectuant une mise à l'échelle de l'arrondi. Par exemple, dans une image 4 x 2, le point d'ancrage (0,7, 0,6) se résout en 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, sous forme de ratio de la largeur de l'image (dans la plage [0, 1]). |
---|---|
anchorV | coordonnée v de l'ancre, sous forme de ratio de la hauteur de l'image (dans la plage [0, 1]). |
public vide setDraggable (booléen déplaçable)
Définit la déplaçabilité du repère. Lorsqu'un repère est déplaçable, l'utilisateur peut le déplacer en en appuyant de manière prolongée sur le repère.
Paramètres
déplaçable |
---|
public vide setFlat (booléen plat)
Détermine si ce repère doit être plat par rapport à la carte true
ou à un panneau d'affichage face au
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 (ancre flottanteU, ancre flottanteV)
Spécifie le point, dans l'image du repère, auquel ancrer la fenêtre d'informations lorsqu'elle se trouve
affiché. Ceci 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'ancrage de la fenêtre d'informations, exprimée sous la forme d'un ratio de la largeur de l'image (dans la (plage [0, 1]). |
---|---|
anchorV | v de l'ancre de la fenêtre d'informations, sous la forme d'un ratio de la hauteur de l'image (dans (plage [0, 1]). |
public vide setRotation (rotation flottante)
Définit la rotation du repère en degrés dans le sens des aiguilles d'une montre par rapport au 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 vide 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 élément Object
arbitraire à ce repère. Pour
Par exemple, le Object
peut contenir des données sur ce que le repère représente. C'est plus simple
que de stocker un Map<Marker, Object>
distinct. Autre exemple : vous pouvez associer
Identifiant String
correspondant à l'identifiant d'un ensemble de données. ni du SDK Google Maps pour Android
lit ni écrit cette propriété. Il est de votre responsabilité d'appeler setTag(null)
pour libérer
le tag lorsque vous n'en avez plus besoin, pour éviter les fuites de mémoire dans votre application.
Paramètres
tag | Si la valeur est nulle, le tag est effacé. |
---|
public vide setTitle (Titre de la chaîne)
Définit le titre du repère.
Paramètres
titre | Si la valeur est null, le titre est effacé. |
---|
public vide setVisible (valeur booléenne visible)
Définit la visibilité de ce repère. Si elle est définie sur false
et qu'une fenêtre d'informations est actuellement
s'affiche pour ce repère, la fenêtre d'informations est masquée.
Paramètres
visible |
---|
public vide 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 se trouve pas sur cette carte
|
---|