Cette page a été traduite par l'API Cloud Translation.

Circle

public final class Circle étend l'objet

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'objets PatternItem à répéter le long du contour du cercle. Types PatternItem 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) et Dot (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 et Polygon, mais pas les Marker). 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ément 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é.

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	getCenter() Renvoie le centre en tant que `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	setCenter(LatLng center) Définit le centre à l'aide d'un `LatLng`.
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	setStrokePattern(motif List<PatternItem>) Définit le motif du trait du contour du cercle.
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

De la classe java.lang.Object

boolean	est égal(e) à (objet arg0)
Dernière leçon<?>	getClass()
int	hashCode()
vide final	notify()
vide final	notifyAll()
Chaîne	toString()
vide final	wait(long arg0, int arg1)
vide final	wait(long arg0)
vide final	wait()

Méthodes publiques

public LatLng getCenter ()

Renvoie le centre en tant que LatLng.

Renvoie

Centre géographique en tant que LatLng.

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 et false 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)

Définit le centre à l'aide d'un LatLng.

Le centre ne doit pas être nul, car il n'existe pas de valeur par défaut.

Paramètres

central	Centre géographique du cercle, spécifié en tant que `LatLng`.

Génère

NullPointerException	si centre a une valeur nulle

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)

Définit la couleur de remplissage.

La couleur de remplissage est la couleur à l'intérieur du cercle, au format entier spécifié par Color. Si TRANSPARENT est utilisé, aucun remplissage n'est tracé.

Paramètres

couleur	Couleur au format `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)

Définit la couleur du trait.

La couleur du trait est la couleur du contour de ce cercle, au format entier spécifié par Color. Si TRANSPARENT est utilisé, aucun contour n'est tracé.

Paramètres

couleur	Couleur du trait au format `Color`.

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.