Polygon

Polygone à la surface de la Terre. Un polygone peut être convexe ou concave, il peut s'étendre sur les 180 méridiens et comporter des trous non remplis. Il a 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 dans le sens inverse des aiguilles d'une montre. Il n'est pas nécessaire que les points de départ et d'arrivée coïncident. Si ce n'est pas le cas, le polygone se fermera automatiquement. Les 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 région à l'intérieur du polygone qui n'est pas remplie. Un trou est spécifié exactement de la même manière que le contour. Un 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.

Largeur du trait

Largeur de segment de ligne en pixels à 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 segment de ligne au format ARVB, le même que celui utilisé par Color. La valeur par défaut est "0xff000000" (noir).

Type d'articulation du trait

Le type de jointure définit la forme à utiliser pour joindre des segments de ligne adjacents à tous les sommets du polygone. Pour connaître les types de jointures compatibles, consultez JointType. La valeur par défaut est DEFAULT.

Motif du trait

Solide (par défaut, représenté par null) ou séquence d'objets PatternItem à répéter le long du polygone. 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 polygone, diamètre défini par la largeur du trait en pixels).

Couleur de remplissage

Couleur de remplissage au format ARVB, même que celui utilisé par Color. La valeur par défaut est transparente (0x00000000). Si la géométrie du polygone n'est pas correctement spécifiée (voir "Contours et trous") ci-dessus, aucun remplissage ne sera dessiné.

z-index

Ordre dans lequel ce polygone est dessiné par rapport aux autres superpositions, y compris Polyline, Circle, GroundOverlay et TileOverlay, mais pas les 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 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 tracé, 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 en tant que géodésiques, par opposition aux lignes droites de la projection de Mercator. Une géodésique est le chemin 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.

Clicabilité

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 pour les GoogleMap.OnPolygonClickListener enregistrés via setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).

Tag

Object associé au polygone. Par exemple, Object peut contenir des données sur ce que le polygone représente. C'est plus facile que de stocker un Map<Polygon, 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 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.