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

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.