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 estDEFAULT
. - Motif du trait
- Plein (par défaut, représenté par
null
) ou séquence d'objetsPatternItem
à répéter le long du contour du polygone. TypesPatternItem
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) etDot
(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
etTileOverlay
, mais pas lesMarker
. 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 estfalse
. Si cette propriété est définie surtrue
, votre application recevra des notifications auGoogleMap.OnPolygonClickListener
enregistré viasetOnPolygonClickListener(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émentMap<Polygon, Object>
distinct. Autre exemple, vous pouvez associer un IDString
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 | |
void | |
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 | |
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
Méthodes publiques
public boolean est égal à (objet autre)
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, renvoiefalse
.
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. |
---|