Polygon

Class Overview

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).

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 and Circles 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.

Methods that modify a Polygon must be called on the main thread. If not, an IllegalStateException will be thrown at runtime.

 Map map;
 // ... get a map.
 // Add a triangle in the Gulf of Guinea
 Vector points = new Vector();
 points.add(new Location(0, 0));
 points.add(new Location(0, 5));
 points.add(new Location(3, 5));
 points.add(new Location(0, 0));
 map.add(new Polygon().setPoints(points).setStrokeColor(Color.RED).setFillColor(Color.BLUE));
 

Summary

[Expand] Inherited Methods
From class com.neomades.maps.overlay.Overlay int getZIndex() Returns the z-index.
From class com.neomades.maps.overlay.BaseOverlay String getId() Returns the overlay ID. boolean isVisible() Checks whether the overlay is visible. void remove() Removes this overlay from Map.
From class java.lang.Object boolean equals(Object obj) Indicates whether some other object is "equal to" this one. final Class<?> getClass() Returns the runtime class of an object. int hashCode() Returns a hash code value for the object. final void notify() Wakes up a single thread that is waiting on this object's monitor. final void notifyAll() Wakes up all threads that are waiting on this object's monitor. String toString() Returns a string representation of the object. final void wait(long timeout, int nanos) Causes current thread to wait until another thread invokes the notify() method or the notifyAll() method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed. final void wait(long timeout) Causes current thread to wait until either another thread invokes the notify() method or the notifyAll() method for this object, or a specified amount of time has elapsed. final void wait() Causes current thread to wait until another thread invokes the notify() method or the notifyAll() method for this object.