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

Circle

la classe finale publique Circle étend les objets

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

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	getCenter() Renvoie le centre en tant que `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	setCenter(centre LatLng) Définit le centre à l'aide d'un `LatLng`.
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	setStrokePattern(Format<ÉlémentÉlément> modèle) 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(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

De la classe java.lang.Object

booléen	equals(est égal à l'argument 0)
final Class<frontendg;	getClass()
int	hashCode()
dernière valeur	notify()
dernière valeur	notifyAll()
String	toString()
dernière valeur	wait(long arg0, int arg1)
dernière valeur	wait(long arg0)
dernière valeur	wait()

Méthodes publiques

public LatLng getCenter ()

Renvoie le centre en tant que LatLng.

Renvoie

Centre géographique en tant que LatLng.

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)

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

Le centre ne doit pas être null, car il n'y a pas de valeur par défaut.

Paramètres

centre	Centre géographique du cercle, spécifié comme `LatLng`.

Génère

NullPointerException	si le centre est nul

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)

Définit la couleur de remplissage.

La couleur de remplissage correspond à la couleur du cercle, au format entier spécifié par Color. Si vous utilisez TRANSPARENT, aucun remplissage ne sera effectué.

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 voidsetStrokeColor(int color)

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 vous utilisez TRANSPARENT, aucun contour ne sera dessiné.

Paramètres

couleur	Couleur du trait au format `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.