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

Polygon

La classe publique finale Polygon étend l'objet

Polygone à la surface de la Terre. Un polygone peut être convexe ou concave, traverser le méridien 180 et comporter des trous non remplis. Elle présente les propriétés suivantes:

Outline: Le contour est spécifié par une liste de sommets dans le sens des aiguilles d'une montre ou en sens inverse. Il n'est pas nécessaire que les points de début et de fin coïncident. Si ce n'est pas le cas, le polygone sera automatiquement fermé. Des segments de ligne sont tracés entre des points consécutifs dans la plus courte des deux directions (est ou ouest).
Trous: Un trou est une zone à l'intérieur d'un polygone qui n'est pas remplie. Les trous sont spécifiés exactement de la même manière que le contour. Le trou doit être entièrement contenu dans le contour. Vous pouvez spécifier plusieurs trous, mais ceux qui se chevauchent ne sont pas acceptés.
Épaisseur du trait: Largeur du segment de ligne 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 des segments de ligne au format ARVB (format utilisé par Color). La valeur par défaut est le noir (0xff000000).
Type d'articulation: Le type de jointure définit la forme à utiliser lors de la jointure de segments de ligne adjacents à tous les sommets du contour du polygone. Consultez JointType pour connaître les types de jointures compatibles. La valeur par défaut est DEFAULT.
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 polygone. 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 polygone, diamètre défini par la largeur du trait en pixels).
Couleur de remplissage: Couleur de remplissage au format ARVB (format utilisé par Color). La valeur par défaut est transparente (0x00000000). Si la géométrie du polygone n'est pas spécifiée correctement (voir ci-dessus pour les contours et les trous), aucun remplissage ne sera tracé.
z-index: Ordre dans lequel ce polygone est dessiné par rapport aux autres superpositions, y compris les Polyline, Circle, GroundOverlay et TileOverlay, 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 la même valeur z-index est arbitraire. La valeur par défaut est 0.
Visibilité: Indique si le polygone est visible ou invisible, c'est-à-dire s'il est dessiné sur la carte. Un polygone invisible n'est pas dessiné, mais conserve toutes ses autres propriétés. La valeur par défaut est true, c'est-à-dire visible.
État géodésique: Indique si les segments du polygone doivent être tracés sous forme de géodésiques, par opposition aux lignes droites sur la projection de Mercator. Une géodésique est le tracé le plus court entre deux points sur la surface de la Terre. La courbe géodésique est construite en supposant que la Terre est une sphère.
Cliquabilité: Si vous souhaitez gérer les événements déclenchés lorsque l'utilisateur clique sur le polygone, définissez cette propriété sur true. Vous pouvez modifier cette valeur à tout moment. La valeur par défaut est false. Si cette propriété est définie sur true, votre application recevra des notifications au GoogleMap.OnPolygonClickListener enregistré via setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).
Tag: Object associé au polygone. Par exemple, Object peut contenir des données sur ce que représente le polygone. Cette opération est plus facile que de stocker un élément Map<Polygon, 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 triangle in the Gulf of Guinea
 Polygon polygon = map.addPolygon(new PolygonOptions()
     .add(new LatLng(0, 0), new LatLng(0, 5), new LatLng(3, 5), new LatLng(0, 0))
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));

Guide du développeur

Pour en savoir plus, consultez le guide du développeur Shapes.

Récapitulatif des méthodes publiques

boolean	est égal à(autre objet) Vérifie si cet élément `Polygon` est égal à un autre.
int	getFillColor() Récupère la couleur de remplissage de ce polygone.
List<List<LatLng>>	getHoles() Renvoie un instantané des trous de ce polygone à l'instant présent .
Chaîne	getId() Récupère l'identifiant de ce polygone.
List<LatLng>	getPoints() Renvoie un instantané des sommets de ce polygone à ce moment précis .
int	getStrokeColor() Récupère la couleur du trait de ce polygone.
int	getStrokeJointType() Récupère le type de jointure du trait utilisé à tous les sommets du contour du polygone.
List<PatternItem>	getStrokePattern() Récupère le motif du trait du contour de ce polygone.
float	getStrokeWidth() Récupère l'épaisseur du trait de ce polygone.
Objet	getTag() Récupère le tag du polygone.
float	getZIndex() Récupère le zIndex de ce polygone.
int	hashCode()
boolean	isClickable() Récupère la cliquabilité du polygone.
boolean	isGeodesic() Détermine si chaque segment de la ligne est tracé sous forme de géodésique.
boolean	isVisible() Récupère la visibilité de ce polygone.
void	supprimer() Supprime le polygone de la carte.
void	setClickable(valeur booléenne cliquable) Définit la cliquabilité du polygone.
void	setFillColor(nombre entier) Définit la couleur de remplissage de ce polygone.
void	setGeodesic(géodésique booléenne) Détermine si chaque segment de la ligne doit être dessiné sous forme de géodésique.
void	setHoles(La liste<? étend List<LatLng>> les trous) Définit les trous de ce polygone.
void	setPoints(List<LatLng> points) Définit les points de ce polygone.
void	setStrokeColor(nombre entier) Définit la couleur du trait de ce polygone.
void	setStrokeJointType(nombre entier jointType) Définit le type de jointure de tous les sommets du contour du polygone.
void	setStrokePattern(motif List<PatternItem>) Définit le motif du trait du contour du polygone.
void	setStrokeWidth(largeur flottante) Définit l'épaisseur du trait de ce polygone.
void	setTag(tag d'objet) Définit le tag du polygone.
void	setVisible(booléen visible) Définit la visibilité de ce polygone.
void	setZIndex(zIndex flottant) Définit le zIndex de ce polygone.

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 boolean est égal à (objet autre)

Vérifie si cet élément Polygon est égal à un autre.

Paramètres

other	un `Object`.

Renvoie

"true" si les deux objets sont le même, c'est-à-dire que ceci == other.

public int getFillColor ()

Récupère la couleur de remplissage de ce polygone.

Renvoie

la couleur au format ARVB.

public List<List<LatLng>> getHoles ()

Renvoie un instantané des trous de ce polygone à l'instant présent . La liste renvoyée est une copie de la liste des trous. Par conséquent, les modifications apportées aux trous du polygone ne seront pas reflétées par cette liste, et le polygone ne reflétera pas non plus les modifications apportées à cette liste.

public String getId ()

Récupère l'identifiant de ce polygone. L'ID est unique parmi tous les polygones d'une carte.

public List<LatLng> getPoints ()

Renvoie un instantané des sommets de ce polygone à ce moment précis . La liste renvoyée est une copie de la liste des sommets. Par conséquent, les modifications apportées aux sommets du polygone ne seront pas reflétées par cette liste, et le polygone ne reflétera pas les modifications apportées à cette liste. Pour modifier les sommets du polygone, appelez setPoints(List).

public int getStrokeColor ()

Récupère la couleur du trait de ce polygone.

Renvoie

la couleur au format ARVB.

public int getStrokeJointType ()

Récupère le type de jointure du trait utilisé à tous les sommets du contour du polygone. Consultez JointType pour connaître les valeurs possibles.

Renvoie

le type de jointure du trait.

public List<PatternItem> getStrokePattern ()

Récupère le motif du trait du contour de ce polygone.

Renvoie

le motif du trait.

public float getStrokeWidth ()

Récupère l'épaisseur du trait de ce polygone.

Renvoie

la largeur en pixels de l’écran.

objet public getTag ()

Récupère le tag du polygone.

Renvoie

la balise si une balise a été définie avec setTag ; null si aucune balise n'a été définie.

public float getZIndex ()

Récupère le zIndex de ce polygone.

Renvoie

la propriété zIndex du polygone.

public int hashCode ()

public boolean isClickable ()

Récupère la cliquabilité du polygone. Si le polygone est cliquable, votre application reçoit des notifications à GoogleMap.OnPolygonClickListener lorsque l'utilisateur clique sur le polygone. L'écouteur d'événements est enregistré via setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).

Renvoie

true si le polygone est cliquable. Sinon, renvoie false.

public boolean isGeodesic ()

Détermine si chaque segment de la ligne est tracé sous forme de géodésique.

Renvoie

true si chaque segment est dessiné sous forme de géodésique ; false si chaque segment est tracé sous forme de ligne droite sur la projection de Mercator.

public boolean isVisible ()

Récupère la visibilité de ce polygone.

Renvoie

la visibilité de ce polygone.

public vide remove ()

Supprime le polygone de la carte. Une fois qu'un polygone a été supprimé, le comportement de toutes ses méthodes n'est plus défini.

public void setClickable (booléen cliquable)

Définit la cliquabilité du polygone. Si le polygone est cliquable, votre application reçoit des notifications à GoogleMap.OnPolygonClickListener lorsque l'utilisateur clique sur le polygone. L'écouteur d'événements est enregistré via setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).

Paramètres

Vous pouvez appuyer.	Nouveau paramètre de cliquabilité pour le polygone.

public void setFillColor (int color)

Définit la couleur de remplissage de ce polygone.

Paramètres

couleur	la couleur au format ARVB.

public void setGeodesic (boolean geodesic)

Détermine si chaque segment de la ligne doit être dessiné sous forme de géodésique.

Paramètres

géodésique	Si la valeur est `true`, chaque segment est dessiné sous forme de géodésique. Si la valeur est `false`, chaque segment est tracé par une ligne droite sur la projection de Mercator.

public vide setHoles (Liste<? étend List<LatLng>> trous)

Définit les trous de ce polygone. Cette méthode utilise une copie des trous. Par conséquent, toute modification supplémentaire de holes n'aura aucun effet sur ce polygone.

Paramètres

trous	une liste de trous, où un trou est une liste de `LatLng`.

public void setPoints (List<LatLng> points)

Définit les points de ce polygone. Cette méthode utilisera une copie des points. Par conséquent, d'autres mutations de points n'auront aucun effet sur ce polygone.

Paramètres

points	une liste de `LatLng`, qui sont les sommets du polygone.

public vide setStrokeColor (nombre entier)

Définit la couleur du trait de ce polygone.

Paramètres

couleur	la couleur au format ARVB.

public void setStrokeJointType (int jointType)

Définit le type de jointure de tous les sommets du contour du polygone.

Consultez JointType pour connaître les valeurs autorisées. La valeur par défaut DEFAULT sera utilisée si le type de jointure n'est pas défini ou ne fait pas partie des valeurs autorisées.

Paramètres

jointType	le type de jointure du trait.

public void setStrokePattern (modèle List<PatternItem>)

Définit le motif du trait du contour du polygone. 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 de ce polygone.

Paramètres

largeur	la largeur en pixels d'affichage.

public vide setTag (tag d'objet)

Définit le tag du polygone.

Vous pouvez utiliser cette propriété pour associer un Object arbitraire à ce polygone. Par exemple, Object peut contenir des données sur ce que représente le polygone. Cette opération est plus facile que de stocker un élément Map<Polygon, 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é de ce polygone. Lorsqu'il n'est pas visible, le polygone n'est pas dessiné, mais il conserve toutes ses autres propriétés.

Paramètres

visible	Si la valeur est `true`, le polygone est visible. Si la valeur est `false`, ce n'est pas le cas.

public void setZIndex (float zIndex)

Définit le zIndex de ce polygone. Les polygones dont l'indice z est plus élevé sont dessinés au-dessus de ceux dont l'indice est inférieur.

Paramètres

zIndex	le zIndex de ce polygone.