Circle

public final class Cercle étend l'objet

Cercle à la surface de la Terre (casque sphérique).

Un cercle possède les propriétés suivantes.

Centre
Le centre du cercle est spécifié en tant que LatLng.
Radius
Rayon du cercle, spécifié en mètres. Cette valeur 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 (même format que celui utilisé par Color). La valeur par défaut est le noir (0xff000000).
Motif du trait
Uni (par défaut, représenté par null) ou une séquence d'objets PatternItem doit être répété le long du contour du cercle. Types de PatternItem disponibles: Gap (définie par la longueur de l'espace en pixels), Dash (définie par la largeur du trait et la longueur des tirets en pixels) et Dot (circulaire, centré sur le contour du cercle, diamètre défini par épaisseur du trait en pixels).
Couleur de remplissage
Couleur de remplissage du cercle au format ARVB (même format utilisé par Color). La valeur par défaut est transparente (0x00000000).
z-index
Ordre dans lequel cette superposition de tuiles est tracée par rapport aux autres superpositions (y compris GroundOverlay, TileOverlay, Polyline et Polygon, mais et non des Marker). Une superposition avec un z-index plus grand s'affiche sur des superpositions dont la taille est plus petite z-indices. 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. Une le cercle invisible n'est pas dessiné, mais il conserve toutes ses autres propriétés. La valeur par défaut est true, c'est-à-dire visible.
Tag
Un Object associé au cercle. Par exemple, Object peut contenir des données sur ce que le cercle représente. C'est plus facile que de stocker un Map<Circle, Object> distinct. Autre exemple : vous pouvez associer un ID String correspondant à l'identifiant d'un ensemble de données. Le SDK Google Maps pour Android ne se lit ni ne lit écrit cette propriété.

Les méthodes de cette classe doivent être appelées sur le thread UI Android. Si ce n'est pas le cas, 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 le qui englobe le pôle Nord ou le pôle Sud. Cependant, le contour sera toujours dessiné correctement.

Guide du développeur

Pour en savoir plus, consultez la page dédiée au développeur de Shapes. .

Récapitulatif des méthodes publiques

LatLng
getCenter()
Affiche le centre en tant que LatLng.
int
getFillColor()
Affiche la couleur de remplissage de ce cercle.
Chaîne
getId()
Récupère l'ID de ce cercle.
double
getRadius()
Renvoie le rayon du cercle, en mètres.
int
getStrokeColor()
Affiche la couleur du trait.
List < PatternItem>
getStrokePattern()
Affiche le motif du trait du cercle.
float
getStrokeWidth()
Renvoie l'épaisseur du trait.
Objet
getTag()
Récupère le tag du cercle.
float
getZIndex()
Renvoie le zIndex.
booléen
isClickable()
Récupère la cliquabilité du cercle.
booléen
isVisible()
Vérifie si le cercle est visible.
vide
remove()
Supprime ce cercle de la carte.
vide
setCenter(LatLng au centre)
Définit le centre à l'aide d'un LatLng.
vide
setClickable(booléen cliquable)
Définit la cliquabilité du cercle.
vide
setFillColor(couleur entière)
Définit la couleur de remplissage.
vide
setRadius(double rayon)
Définit le rayon en mètres.
vide
setStrokeColor(couleur entière)
Définit la couleur du trait.
vide
setStrokePattern(List<PatternItem> motif)
Définit le motif du trait du cercle.
vide
setStrokeWidth(largeur flottante)
Définit l'épaisseur du trait.
vide
setTag(tag d'objet)
Définit le tag du cercle.
vide
setVisible(boolean visible)
Définit la visibilité du cercle.
vide
setZIndex(float zIndex)
Définit le zIndex.

Récapitulatif des méthodes héritées

Méthodes publiques

public LatLng getCenter ()

Affiche le centre en tant que LatLng.

Renvoie
  • Centre géographique sous forme de LatLng.

public entier getFillColor ()

Affiche la couleur de remplissage de ce cercle.

Renvoie
  • Couleur de remplissage du cercle au format ARVB.

public Chaîne getId ()

Récupère l'ID de ce cercle. Chaque cercle figurant sur une carte possède un identifiant unique.

public double getRadius ()

Renvoie le rayon du cercle, en mètres.

Renvoie
  • Rayon, en mètres.

public entier getStrokeColor ()

Affiche la couleur du trait.

Renvoie
  • Couleur du cercle au format ARVB.

public List<PatternItem> getStrokePattern ()

Affiche le motif du trait du cercle.

Renvoie
  • le motif du trait.

public se superposer getStrokeWidth ()

Renvoie l'épaisseur du trait.

Renvoie
  • Largeur en pixels à l'écran.

public Objet getTag ()

Récupère le tag du cercle.

Renvoie
  • le tag si un tag a été défini avec setTag ; null si aucune balise n'a été définie.

public se superposer getZIndex ()

Renvoie le zIndex.

Renvoie
  • zIndex de ce cercle.

public Booléen isClickable ()

Récupère la cliquabilité du cercle. S'il est cliquable, votre application reçoit des notifications au 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 s'il n'est pas cliquable.

public Booléen isVisible ()

Vérifie si le cercle est visible.

Renvoie
  • true si le cercle est visible ; false s'il est invisible.

public vide supprimer ()

Supprime ce cercle de la carte. Lorsqu'un cercle est supprimé, le comportement de l'ensemble de ses méthodes n'est pas définie.

public vide setCenter (LatLng au centre)

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
centre Centre géographique du cercle, spécifié en tant que LatLng.
Génère
NullPointerException si le centre est nul

public vide setClickable (valeur booléenne cliquable)

Définit la cliquabilité du cercle. S'il est cliquable, votre application reçoit des notifications au GoogleMap.OnCircleClickListener lorsque l'utilisateur clique sur le cercle. L'écouteur d'événements est enregistré via setOnCircleClickListener(GoogleMap.OnCircleClickListener).

Paramètres
cliquable Nouveau paramètre de cliquabilité pour le cercle.

public vide setFillColor (couleur int.)

Définit la couleur de remplissage.

La couleur de remplissage correspond à 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 vide 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 (couleur int.)

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 vide setStrokePattern (List<PatternItem> motif)

Définit le motif du trait du cercle. Le motif du trait par défaut est uni, représentée par null.

Paramètres
modèle le motif du trait.

public vide setStrokeWidth (largeur flottante)

Définit l'épaisseur du trait.

L'épaisseur du trait est la largeur du contour du cercle (en pixels à l'écran). Elle doit être nulle ou plus élevé. S'il est défini sur zéro, aucun contour n'est tracé. La valeur par défaut est 10.

Paramètres
largeur Largeur 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. Pour Par exemple, Object peut contenir des données sur ce que le cercle représente. C'est plus simple que de stocker un Map<Circle, Object> distinct. Autre exemple : vous pouvez associer Identifiant String correspondant à l'identifiant d'un ensemble de données. ni du SDK Google Maps pour Android lit ni écrit cette propriété. Il est de votre responsabilité d'appeler setTag(null) pour libérer le tag lorsque vous n'en avez plus besoin, pour éviter les fuites de mémoire dans votre application.

Paramètres
tag Si la valeur est nulle, le tag est effacé.

public vide setVisible (valeur booléenne visible)

Définit la visibilité du cercle.

S'il 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 la rendre invisible.

public vide setZIndex (float zIndex)

Définit le zIndex.

Les superpositions (telles que les cercles) dont les z-index sont les plus élevés apparaissent au-dessus de celles dont l'indice est plus faible.

Paramètres
zIndex Valeur zIndex.