Polygon

A polygon on the earth's surface. A polygon can be convex or concave, it may span the 180
meridian and it can have holes that are not filled in. It has the following properties:

Outline

The outline is specified by a list of vertices in clockwise or counterclockwise order.
It is not necessary for the start and end points to coincide; if they do not, the polygon
will be automatically closed. Line segments are drawn between consecutive points in the
shorter of the two directions (east or west).

Holes

A hole is a region inside the polygon that is not filled. A hole is specified in
exactly the same way as the outline. A hole must be fully contained within the outline.
Multiple holes can be specified, however overlapping holes are not supported.

Stroke Width

Line segment width in screen pixels. The width is constant and independent of the
camera's zoom level. The default value is 10.

Stroke Color

Line segment color in ARGB format, the same format used by Color. The
default value is black (0xff000000).

Stroke Joint Type

The joint type defines the shape to be used when joining adjacent line segments at all
vertices of the polygon's outline. See JointType
for supported joint types. The default value is DEFAULT.

Stroke pattern

Solid (default, represented by null) or a sequence of PatternItem
objects to be repeated along the polygon's outline. Available PatternItem
types: Gap (defined by
gap length in pixels), Dash (defined
by stroke width and dash length in pixels) and Dot (circular,
centered on the polygon's outline, diameter defined by stroke width in pixels).

Fill Color

Fill color in ARGB format, the same format used by Color. The
default value is transparent (0x00000000). If the polygon geometry is not
specified correctly (see above for Outline and Holes), then no fill will be drawn.

Z-Index

The order in which this polygon is drawn with respect to other overlays, including
Polylines,
Circles,
GroundOverlays
and TileOverlays,
but not Markers. An
overlay with a larger z-index is drawn over overlays with smaller z-indices. The order of
overlays with the same z-index value is arbitrary. The default is 0.

Visibility

Indicates if the polygon is visible or invisible, i.e., whether it is drawn on the map.
An invisible polygon is not drawn, but retains all of its other properties. The default is
true, i.e., visible.

Geodesic status

Indicates whether the segments of the polygon should be drawn as geodesics, as opposed
to straight lines on the Mercator projection. A geodesic is the shortest path between two
points on the Earth's surface. The geodesic curve is constructed assuming the Earth is a
sphere

An Object associated with the polygon. For example, the
Object can contain data about what the polygon represents. This is easier than
storing a separate Map<Polygon, Object>. As another example, you can
associate a String ID corresponding to the ID from a data set. Google Maps SDK
for Android neither reads nor writes this property.

Methods in this class must be called on the Android UI thread. If not, an IllegalStateException
will be thrown at runtime.

Returns

public intgetFillColor()

Returns

Returns a snapshot of the holes of this polygon at this time . The list returned is
a copy of the list of holes and so changes to the polygon's holes will not be reflected
by this list, nor will changes to this list be reflected by the polygon.

Returns a snapshot of the vertices of this polygon at this time . The list returned
is a copy of the list of vertices and so changes to the polygon's vertices will not be
reflected by this list, nor will changes to this list be reflected by the polygon. To
change the vertices of the polygon, call
setPoints(List).

public intgetStrokeColor()

Gets the stroke color of this polygon.

Returns

the color in ARGB format.

public intgetStrokeJointType()

Gets the stroke joint type used at all vertices of the polygon's outline. See
JointType
for possible values.

public voidsetStrokeWidth(float
width)

Parameters

You can use this property to associate an arbitrary Object with this
polygon. For example, the Object can contain data about what the polygon
represents. This is easier than storing a separate Map<Polygon,
Object>. As another example, you can associate a String ID
corresponding to the ID from a data set. Google Maps SDK for Android neither reads nor
writes this property. It is your responsibility to call setTag(null) to
clear the tag when you no longer need it, to prevent memory leaks in your app.

Parameters

tag

if null, the tag is cleared.

public voidsetVisible(boolean
visible)

Sets the visibility of this polygon. When not visible, a polygon is not drawn, but
it keeps all its other properties.

Parameters

visible

if true, then the polygon is visible; if false, it is
not.

public voidsetZIndex(float zIndex)

Sets the zIndex of this polygon. Polygons with higher zIndices are drawn above those
with lower indices.