org.osmdroid.views.overlay

Class Polygon

java.lang.Object

org.osmdroid.views.overlay.Overlay

org.osmdroid.views.overlay.OverlayWithIW

org.osmdroid.views.overlay.Polygon

All Implemented Interfaces:

OverlayConstants

public class Polygon
extends OverlayWithIW

A polygon on the earth's surface that can have a popup-InfoWindow (a bubble). Mimics the Polygon class from Google Maps Android API v2 as much as possible. Main differences:
- Doesn't support: Z-Index, Geodesic mode
- Supports InfoWindow.

See Also:

Google Maps Polygon

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) class	Polygon.LinearRing inner class holding one ring: the polygon outline, or a hole inside the polygon

Nested classes/interfaces inherited from class org.osmdroid.views.overlay.Overlay

Overlay.Snappable

Field Summary

Fields

Modifier and Type	Field and Description
protected Paint	mFillPaint Paint settings.
protected Paint	mOutlinePaint

Fields inherited from class org.osmdroid.views.overlay.OverlayWithIW

mInfoWindow, mRelatedObject, mSnippet, mSubDescription, mTitle

Fields inherited from class org.osmdroid.views.overlay.Overlay

SHADOW_X_SKEW, SHADOW_Y_SCALE

Fields inherited from interface org.osmdroid.views.util.constants.OverlayConstants

DEFAULT_ZOOMLEVEL_MINIMAP_DIFFERENCE, NOT_SET

Constructor Summary

Constructors

Constructor and Description
Polygon()
Polygon(Context ctx) Deprecated.

Method Summary

Modifier and Type	Method and Description
boolean	contains(MotionEvent event) Important note: this function returns correct results only if the Polygon has been drawn before, and if the MapView positioning has not changed.
void	draw(Canvas canvas, MapView mapView, boolean shadow) Draw the overlay over the map.
int	getFillColor()
List<ArrayList<GeoPoint>>	getHoles()
Paint	getOutlinePaint()
List<GeoPoint>	getPoints()
int	getStrokeColor()
float	getStrokeWidth()
boolean	isVisible()
void	onDetach(MapView mapView) Override to perform clean up of resources before shutdown.
boolean	onSingleTapConfirmed(MotionEvent event, MapView mapView) By default does nothing (return false).
static ArrayList<GeoPoint>	pointsAsCircle(GeoPoint center, double radiusInMeters) Build a list of GeoPoint as a circle.
static ArrayList<IGeoPoint>	pointsAsRect(BoundingBox rectangle) Build a list of GeoPoint as a rectangle.
static ArrayList<IGeoPoint>	pointsAsRect(BoundingBoxE6 rectangle) Deprecated.
static ArrayList<IGeoPoint>	pointsAsRect(GeoPoint center, double lengthInMeters, double widthInMeters) Build a list of GeoPoint as a rectangle.
void	setFillColor(int fillColor)
void	setHoles(List<? extends List<GeoPoint>> holes)
void	setPoints(List<GeoPoint> points) This method will take a copy of the points.
void	setStrokeColor(int color)
void	setStrokeWidth(float width)
void	setVisible(boolean visible)

Methods inherited from class org.osmdroid.views.overlay.OverlayWithIW

closeInfoWindow, getInfoWindow, getRelatedObject, getSnippet, getSubDescription, getTitle, isInfoWindowOpen, onDestroy, setInfoWindow, setRelatedObject, setSnippet, setSubDescription, setTitle

Methods inherited from class org.osmdroid.views.overlay.Overlay

drawAt, getSafeMenuId, getSafeMenuIdSequence, isEnabled, onDoubleTap, onDoubleTapEvent, onDown, onFling, onKeyDown, onKeyUp, onLongPress, onScroll, onShowPress, onSingleTapUp, onTouchEvent, onTrackballEvent, setEnabled

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

mFillPaint

protected Paint mFillPaint

Paint settings.

mOutlinePaint

protected Paint mOutlinePaint

Constructor Detail

Polygon

@Deprecated
public Polygon(Context ctx)

Deprecated.

Use Polygon() instead

Polygon

public Polygon()

Method Detail

getFillColor

public int getFillColor()

getStrokeColor

public int getStrokeColor()

getStrokeWidth

public float getStrokeWidth()

getOutlinePaint

public Paint getOutlinePaint()

Returns:

the Paint used for the outline. This allows to set advanced Paint settings.

getPoints

public List<GeoPoint> getPoints()

Returns:

a copy of the list of polygon's vertices.

isVisible

public boolean isVisible()

setFillColor

public void setFillColor(int fillColor)

setStrokeColor

public void setStrokeColor(int color)

setStrokeWidth

public void setStrokeWidth(float width)

setVisible

public void setVisible(boolean visible)

setPoints

public void setPoints(List<GeoPoint> points)

This method will take a copy of the points.

setHoles

public void setHoles(List<? extends List<GeoPoint>> holes)

getHoles

public List<ArrayList<GeoPoint>> getHoles()

pointsAsCircle

public static ArrayList<GeoPoint> pointsAsCircle(GeoPoint center,
                                                 double radiusInMeters)

Build a list of GeoPoint as a circle.

Parameters:

center - center of the circle

radiusInMeters -

Returns:

the list of GeoPoint

pointsAsRect

@Deprecated
public static ArrayList<IGeoPoint> pointsAsRect(BoundingBoxE6 rectangle)

Deprecated.

Build a list of GeoPoint as a rectangle.

Parameters:

rectangle - defined as a BoundingBox

Returns:

the list of 4 GeoPoint

pointsAsRect

public static ArrayList<IGeoPoint> pointsAsRect(BoundingBox rectangle)

Build a list of GeoPoint as a rectangle.

Parameters:

rectangle - defined as a BoundingBox

Returns:

the list of 4 GeoPoint

pointsAsRect

public static ArrayList<IGeoPoint> pointsAsRect(GeoPoint center,
                                                double lengthInMeters,
                                                double widthInMeters)

Build a list of GeoPoint as a rectangle.

Parameters:

center - of the rectangle

lengthInMeters - on longitude

widthInMeters - on latitude

Returns:

the list of 4 GeoPoint

draw

public void draw(Canvas canvas,
                 MapView mapView,
                 boolean shadow)

Description copied from class: Overlay

Draw the overlay over the map. This will be called on all active overlays with shadow=true, to lay down the shadow layer, and then again on all overlays with shadow=false. Callers should check isEnabled() before calling draw(). By default, draws nothing. changed for 5.6 to be public see https://github.com/osmdroid/osmdroid/issues/466

Specified by:

draw in class Overlay

contains

public boolean contains(MotionEvent event)

Important note: this function returns correct results only if the Polygon has been drawn before, and if the MapView positioning has not changed.

Parameters:

event -

Returns:

true if the Polygon contains the event position.

onSingleTapConfirmed

public boolean onSingleTapConfirmed(MotionEvent event,
                                    MapView mapView)

Description copied from class: Overlay

By default does nothing (return false). If you handled the Event, return true , otherwise return false. If you returned true none of the following Overlays or the underlying MapView has the chance to handle this event.

Overrides:

onSingleTapConfirmed in class Overlay

onDetach

public void onDetach(MapView mapView)

Description copied from class: Overlay

Override to perform clean up of resources before shutdown. By default does nothing.

Overrides:

onDetach in class Overlay