Repère

la classe publique finale Marker étend l'objet

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 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 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 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é.

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
setIcon(BitmapDescriptor iconDescriptor)
Définit l'icône du repère.
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
setPosition(LatLng latlng)
Définit l'emplacement du repère.
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)

Teste si Marker est égal à un autre.

Paramètres
other un Object.
Renvoie
  • Valeur "true" si les deux objets sont le même objet, autrement dit, == 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, renvoie false.

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

Définit l'emplacement du repère.

Paramètres
Latlng

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