Polygon

Polygone à la surface de la Terre. Un polygone peut être convexe ou concave, et s'étendre sur les 180 meridian et il peut y avoir des trous qui ne sont pas remplis. Il présente les propriétés suivantes:

Contour

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 pour que les points de départ et d'arrivée coïncident. Si ce n'est pas le cas, le polygone automatiquement. Des segments de ligne sont tracés entre des points consécutifs dans la partie 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é dans de la même manière que le plan. Un trou doit être entièrement contenu dans le contour. Multiples des trous peuvent être spécifiés, mais les trous se chevauchant ne sont pas pris en charge.

Épaisseur du trait

Largeur du segment de ligne en pixels de l'écran. La largeur est constante et indépendante de la le niveau de zoom. La valeur par défaut est 10.

Couleur du trait

Couleur du segment de ligne au format ARVB (même format que celui utilisé par Color) La valeur par défaut est le noir (0xff000000).

Type de jointure du trait

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

Motif du trait

Uni (par défaut, représenté par null) ou une séquence d'objets PatternItem le long du contour du polygone. Types de PatternItem disponibles: Gap (défini par la longueur de l'espace en pixels), Dash (défini par la largeur du trait et le tiret) longueur en pixels) et Dot (circulaire, centré sur le contour du polygone, diamètre définie par l'épaisseur du trait en pixels).

Couleur de remplissage

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

z-index

Ordre dans lequel ce polygone est tracé par rapport aux autres superpositions, y compris les éléments Polyline, Circle, GroundOverlay et TileOverlay, mais pas 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 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. Une un polygone invisible n'est pas tracé, mais il 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, et non en tant que sur des lignes droites dans la projection de Mercator. Une géodésique est le chemin le plus court entre à la surface de la Terre. La courbe géodésique s'obtient en supposant que la Terre 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 est définie sur true, votre application recevra des notifications à l'adresse GoogleMap.OnPolygonClickListener enregistrée 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. 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 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 la page dédiée au développeur de Shapes. .