Repère

public final class Repère étend l'objet

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 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.
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 un Map<Marker, Object> distinct. Autre exemple : vous pouvez associer un ID String 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
equals(autre objet)
Vérifie si cette Marker est égale à une 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
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
setIcon(BitmapDescriptor iconDescriptor)
Définit l'icône du repère.
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
setPosition(latlng LatLng)
Définit l'emplacement du repère.
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)

Vérifie si cette Marker est égale à une autre.

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

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, renvoie false.

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 carte false 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 setPosition (latlng LatLng)

Définit l'emplacement du repère.

Paramètres
latlng

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