Cercle à la surface de la Terre (couvercle sphérique).
Un cercle a les propriétés suivantes.
- Pivot
- Le centre du cercle est défini en tant que
LatLng
. - Radius
- Rayon du cercle, indiqué en mètres. Elle doit être égale ou supérieure à zéro.
- Épaisseur du trait
- Largeur du contour du cercle en pixels de l'écran. La largeur est constante et indépendante du niveau de zoom de la caméra. La valeur par défaut est 10.
- Couleur du trait
- Couleur du contour du cercle au format ARVB (format utilisé par
Color
). La valeur par défaut est le noir (0xff000000
). - Motif du trait
- Plein (par défaut, représenté par
null
) ou séquence d'objetsPatternItem
à répéter le long du contour du cercle. TypesPatternItem
disponibles:Gap
(défini par la longueur de l'espace en pixels),Dash
(défini par la largeur du trait et la longueur du tiret en pixels) etDot
(circulaire, centré sur le contour du cercle, diamètre défini par la largeur du trait en pixels). - Couleur de remplissage
- Couleur de remplissage du cercle au format ARVB, qui est également utilisé par
Color
. La valeur par défaut est "transparent" (0x00000000
). - z-index
- Ordre dans lequel cette superposition de tuiles est dessinée par rapport aux autres superpositions (y compris les
GroundOverlay
,TileOverlay
,Polyline
etPolygon
, mais pas lesMarker
). Une superposition avec un z-index plus grand apparaît sur des superpositions comportant des z-indices plus petits. L'ordre des superpositions ayant le même z-index est arbitraire. Le zIndex par défaut est 0. - Visibilité
- Indique si le cercle est visible ou invisible, c'est-à-dire s'il est dessiné sur la carte. Un cercle invisible n'est pas dessiné, mais conserve toutes ses autres propriétés. La valeur par défaut est
true
, c'est-à-dire visible. - Tag
Object
associé au cercle. Par exemple, l'élémentObject
peut contenir des données sur ce que représente le cercle. Cette opération est plus facile que de stocker un élémentMap<Circle, 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 circle in Sydney
Circle circle = map.addCircle(new CircleOptions()
.center(new LatLng(-33.87365, 151.20689))
.radius(10000)
.strokeColor(Color.RED)
.fillColor(Color.BLUE));
Notez que le moteur de rendu actuel de la carte n'est pas en mesure de tracer le remplissage du cercle si celui-ci englobe le pôle Nord ou le pôle Sud. Toutefois, le contour sera toujours tracé correctement.
Guide du développeur
Pour en savoir plus, consultez le guide du développeur Shapes.
Récapitulatif des méthodes publiques
LatLng | |
int |
getFillColor()
Renvoie la couleur de remplissage de ce cercle.
|
Chaîne |
getId()
Récupère l'identifiant de ce cercle.
|
double |
getRadius()
Renvoie le rayon du cercle, en mètres.
|
int |
getStrokeColor()
Renvoie la couleur du trait.
|
List<PatternItem> |
getStrokePattern()
Renvoie le motif du trait du contour de ce cercle.
|
float |
getStrokeWidth()
Renvoie l'épaisseur du trait.
|
Objet |
getTag()
Récupère le tag du cercle.
|
float |
getZIndex()
Renvoie le zIndex.
|
boolean |
isClickable()
Récupère la cliquabilité du cercle.
|
boolean |
isVisible()
Vérifie si le cercle est visible.
|
void |
supprimer()
Supprime ce cercle de la carte.
|
void | |
void |
setClickable(valeur booléenne cliquable)
Définit la cliquabilité du cercle.
|
void |
setFillColor(nombre entier)
Définit la couleur de remplissage.
|
void |
setRadius(double rayon)
Définit le rayon en mètres.
|
void |
setStrokeColor(nombre entier)
Définit la couleur du trait.
|
void | |
void |
setStrokeWidth(largeur flottante)
Définit l'épaisseur du trait.
|
void |
setTag(tag d'objet)
Définit le tag du cercle.
|
void |
setVisible(booléen visible)
Définit la visibilité du cercle.
|
void |
setZIndex(zIndex flottant)
Définit le zIndex.
|
Récapitulatif des méthodes héritées
Méthodes publiques
public LatLng getCenter ()
public int getFillColor ()
Renvoie la couleur de remplissage de ce cercle.
Renvoie
- Couleur de remplissage du cercle au format ARVB.
public String getId ()
Récupère l'identifiant de ce cercle. L'identifiant est unique parmi tous les cercles d'une carte.
public double getRadius ()
Renvoie le rayon du cercle, en mètres.
Renvoie
- Rayon en mètres.
public int getStrokeColor ()
Renvoie la couleur du trait.
Renvoie
- Couleur du cercle au format ARVB.
public List<PatternItem> getStrokePattern ()
Renvoie le motif du trait du contour de ce cercle.
Renvoie
- le motif du trait.
public float getStrokeWidth ()
Renvoie l'épaisseur du trait.
Renvoie
- Largeur en pixels de l'écran.
objet public getTag ()
Récupère le tag du cercle.
Renvoie
- la balise si une balise a été définie avec
setTag
;null
si aucune balise n'a été définie.
public float getZIndex ()
Renvoie le zIndex.
Renvoie
- zIndex de ce cercle.
public boolean isClickable ()
Récupère la cliquabilité du cercle. Si le cercle est cliquable, votre application recevra des notifications au GoogleMap.OnCircleClickListener
lorsque l'utilisateur cliquera dessus.
L'écouteur d'événements est enregistré via setOnCircleClickListener(GoogleMap.OnCircleClickListener)
.
Renvoie
true
si le cercle est cliquable etfalse
s'il ne l'est pas.
public boolean isVisible ()
Vérifie si le cercle est visible.
Renvoie
true
si le cercle est visible ;false
s'il est invisible.
public vide remove ()
Supprime ce cercle de la carte. Une fois qu'un cercle a été supprimé, le comportement de toutes ses méthodes n'est plus défini.
public vide setCenter (LatLng center)
public void setClickable (booléen cliquable)
Définit la cliquabilité du cercle. Si le cercle est cliquable, votre application recevra des notifications au GoogleMap.OnCircleClickListener
lorsque l'utilisateur cliquera dessus.
L'écouteur d'événements est enregistré via setOnCircleClickListener(GoogleMap.OnCircleClickListener)
.
Paramètres
Vous pouvez appuyer. | Nouveau paramètre de cliquabilité pour le cercle. |
---|
public void setFillColor (int color)
public void setRadius (double rayon)
Définit le rayon en mètres.
Le rayon doit être supérieur ou égal à zéro.
Paramètres
rayon | Rayon, en mètres. |
---|
Génère
IllegalArgumentException | si le rayon est négatif |
---|
public vide setStrokeColor (nombre entier)
public void setStrokePattern (modèle List<PatternItem>)
Définit le motif du trait du contour du cercle. Le motif du trait par défaut est plein et représenté par null
.
Paramètres
modèle | le motif du trait. |
---|
public void setStrokeWidth (largeur flottante)
Définit l'épaisseur du trait.
L'épaisseur du trait correspond à la largeur (en pixels de l'écran) du contour du cercle. Elle doit être égale ou supérieure à zéro. S'il est égal à zéro, aucun contour n'est dessiné. La valeur par défaut est 10.
Paramètres
largeur | Épaisseur du trait, en pixels de l'écran. |
---|
Génère
IllegalArgumentException | si la largeur est négative |
---|
public vide setTag (tag d'objet)
Définit le tag du cercle.
Vous pouvez utiliser cette propriété pour associer un Object
arbitraire à ce cercle. Par exemple, Object
peut contenir des données sur ce que représente le cercle. Cette opération est plus facile que de stocker un élément Map<Circle, 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 setVisible (boolean visible)
Définit la visibilité du cercle.
Si ce cercle n'est pas visible, il ne sera pas tracé. Tous les autres états sont conservés. Les cercles sont visibles par défaut.
Paramètres
visible | true pour rendre ce cercle visible ; false pour le rendre invisible.
|
---|
public void setZIndex (float zIndex)
Définit le zIndex.
Les superpositions (comme les cercles) avec des indices z plus élevés sont dessinées au-dessus de celles ayant des indices plus bas.
Paramètres
zIndex | Valeur zIndex. |
---|