Un cercle sur la surface de la Terre (chapeau sphérique).
Un cercle a les propriétés suivantes.
- d'aide
- Le centre du cercle est indiqué en tant que
LatLng
. - Radius
- Rayon du cercle, en mètres. Ce nombre doit être égal à zéro ou supérieur.
- Largeur du trait
- Largeur du contour du cercle (en pixels). 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, le même que celui utilisé par
Color
. La valeur par défaut est "0xff000000
" (noir). - Motif du trait
- Solide (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 d'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
- La couleur du cercle remplit le format ARVB, le même que celui utilisé par
Color
. La valeur par défaut est transparente (0x00000000
). - z-index
- Ordre dans lequel cette superposition de tuiles est dessinée par rapport aux autres superpositions (y compris
GroundOverlay
,TileOverlay
,Polyline
etPolygon
, mais pasMarker
). Une superposition avec un z-index plus grand est superposée aux superpositions avec des z-indices plus petits. L'ordre des superpositions ayant le même z-index est arbitraire. La valeur par défaut de la propriété zIndex 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 tracé, 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,Object
peut contenir des données sur ce que représente le cercle. C'est plus facile que de stocker unMap<Circle, 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 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 de carte actuel ne peut pas dessiner le remplissage du cercle si celui-ci comprend le pôle Nord ou le pôle Sud. Toutefois, le contour sera correctement dessiné.
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.
|
String |
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 (nombre à virgule flottante) |
getStrokeWidth
Renvoie l'épaisseur du trait.
|
Objet |
getTag
Récupère le tag du cercle.
|
float (nombre à virgule flottante) |
getZIndex
Renvoie la valeur zIndex.
|
booléen |
isClickable()
Récupère la cliquabilité du cercle.
|
booléen |
isVisible()
Vérifie si le cercle est visible.
|
void |
remove
Supprime ce cercle de la carte.
|
void | |
void |
setClickable (valeur cliquable cliquable)
Définit la cliquabilité du cercle.
|
void |
setFillColor(couleur d'ensemble)
Définit la couleur de remplissage.
|
void |
setRadius(double rayon)
Définit le rayon en mètres.
|
void |
setStrokeColor(couleur des objets)
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(valeur booléenne 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 intgetFillColor()
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 sera unique parmi tous les cercles de la carte.
public double getRadius ()
Renvoie le rayon du cercle, en mètres.
Renvoie
- Rayon en mètres.
public intgetStrokeColor()
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
- motif du trait.
float public getStrokeWidth ()
Renvoie l'épaisseur du trait.
Renvoie
- Largeur en pixels de l'écran.
public Object getTag ()
Récupère le tag du cercle.
Renvoie
- le tag si un tag a été défini avec
setTag
;null
si aucun tag n'a été défini.
float public getZIndex ()
Renvoie la valeur zIndex.
Renvoie
- zIndex de ce cercle.
public boolean isClickable ()
Récupère la cliquabilité du cercle. Si le cercle est cliquable, votre application reçoit des notifications pour GoogleMap.OnCircleClickListener
lorsque l'utilisateur clique sur le cercle.
L'écouteur d'événements est enregistré via setOnCircleClickListener(GoogleMap.OnCircleClickListener)
.
Renvoie
true
si le cercle est cliquable,false
dans le cas contraire.
public boolean isVisible ()
Vérifie si le cercle est visible.
Renvoie
true
si le cercle est visible ;false
s'il est invisible.
public void supprimer ()
Supprime ce cercle de la carte. Une fois qu'un cercle a été supprimé, le comportement de toutes ses méthodes n'est pas défini.
public void setCenter (Centre LatLng)
public voidsetClickable(booléen cliquable)
Définit la cliquabilité du cercle. Si le cercle est cliquable, votre application reçoit des notifications pour GoogleMap.OnCircleClickListener
lorsque l'utilisateur clique sur le cercle.
L'écouteur d'événements est enregistré via setOnCircleClickListener(GoogleMap.OnCircleClickListener)
.
Paramètres
Vous pouvez appuyer. | Nouveau paramètre de cliquabilité du cercle. |
---|
void public 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 voidsetStrokeColor(int color)
public void setStrokePattern (List<MotifÉlément> schéma)
Définit le motif du trait du contour du cercle. Le trait par défaut est un trait plein, représenté par null
.
Paramètres
pattern | motif du trait. |
---|
public void setStrokeWidth (largeur flottante)
Définit l'épaisseur du trait.
L'épaisseur du trait est l'épaisseur (en pixels de l'écran) du contour du cercle. Cette valeur doit être égale ou supérieure à zéro. S'il est égal à zéro, aucun contour n'est tracé. La valeur par défaut est 10.
Paramètres
largeur | Largeur du trait, en pixels à l'écran. |
---|
Génère
IllegalArgumentException | si la largeur est négative |
---|
public void 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 méthode est plus facile que de stocker un Map<Circle, 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 setVisible (valeur booléenne visible)
Définit la visibilité du cercle.
Si ce cercle n'est pas visible, il ne sera pas dessiné. 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 (telles que les cercles) ayant un zIndex plus élevé sont dessinées au-dessus de celles dont l'indice est inférieur.
Paramètres
z-index | Valeur zIndex. |
---|