org.osmdroid.views.overlay.mylocation

Class MyLocationNewOverlay

java.lang.Object

org.osmdroid.views.overlay.Overlay

org.osmdroid.views.overlay.mylocation.MyLocationNewOverlay

All Implemented Interfaces:

IOverlayMenuProvider, IMyLocationConsumer, Overlay.Snappable, OverlayConstants

public class MyLocationNewOverlay
extends Overlay
implements IMyLocationConsumer, IOverlayMenuProvider, Overlay.Snappable

Author:

Marc Kurtz, Manuel Stahl

Nested Class Summary

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

Overlay.Snappable

Field Summary

Fields

Modifier and Type	Field and Description
protected android.graphics.Paint	mCirclePaint
protected android.graphics.Bitmap	mDirectionArrowBitmap
protected float	mDirectionArrowCenterX
protected float	mDirectionArrowCenterY
protected boolean	mDrawAccuracyEnabled
static int	MENU_MY_LOCATION
protected boolean	mIsFollowing
protected MapView	mMapView
IMyLocationProvider	mMyLocationProvider
protected android.graphics.Paint	mPaint
protected android.graphics.Bitmap	mPersonBitmap
protected android.graphics.PointF	mPersonHotspot Coordinates the feet of the person are located scaled for display density.

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

mResourceProxy, mScale, SHADOW_X_SKEW, SHADOW_Y_SCALE

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

DEBUGMODE, DEFAULT_ZOOMLEVEL_MINIMAP_DIFFERENCE, NOT_SET

Constructor Summary

Constructors

Constructor and Description
MyLocationNewOverlay(android.content.Context context, IMyLocationProvider myLocationProvider, MapView mapView)
MyLocationNewOverlay(android.content.Context context, MapView mapView)
MyLocationNewOverlay(IMyLocationProvider myLocationProvider, MapView mapView, ResourceProxy resourceProxy)

Method Summary

Methods

Modifier and Type	Method and Description
void	disableFollowLocation() Disables "follow" functionality.
void	disableMyLocation() Disable location updates
protected void	draw(android.graphics.Canvas c, MapView mapView, boolean shadow) Draw the overlay over the map.
protected void	drawMyLocation(android.graphics.Canvas canvas, MapView mapView, android.location.Location lastFix)
void	enableFollowLocation() Enables "follow" functionality.
boolean	enableMyLocation() Enable receiving location updates from the provided IMyLocationProvider and show your location on the maps.
boolean	enableMyLocation(IMyLocationProvider myLocationProvider)
android.location.Location	getLastFix()
GeoPoint	getMyLocation() Return a GeoPoint of the last known location, or null if not known.
protected android.graphics.Rect	getMyLocationDrawingBounds(int zoomLevel, android.location.Location lastFix, android.graphics.Rect reuse)
IMyLocationProvider	getMyLocationProvider()
boolean	isDrawAccuracyEnabled() If enabled, an accuracy circle will be drawn around your current position.
boolean	isFollowLocationEnabled() If enabled, the map will center on your current location and automatically scroll as you move.
boolean	isMyLocationEnabled() If enabled, the map is receiving location updates and drawing your location on the map.
boolean	isOptionsMenuEnabled() Can be used to signal to external callers that this Overlay should not be used for providing option menu items.
boolean	onCreateOptionsMenu(android.view.Menu pMenu, int pMenuIdOffset, MapView pMapView)
void	onDetach(MapView mapView) Override to perform clean up of resources before shutdown.
void	onLocationChanged(android.location.Location location, IMyLocationProvider source) Call when a provider has a new location to consume.
boolean	onOptionsItemSelected(android.view.MenuItem pItem, int pMenuIdOffset, MapView pMapView)
boolean	onPrepareOptionsMenu(android.view.Menu pMenu, int pMenuIdOffset, MapView pMapView)
boolean	onSnapToItem(int x, int y, android.graphics.Point snapPoint, IMapView mapView) Checks to see if the given x and y are close enough to an item resulting in snapping the current action (e.g.
boolean	onTouchEvent(android.view.MotionEvent event, MapView mapView) You can prevent all(!) other Touch-related events from happening! By default does nothing (return false).
boolean	runOnFirstFix(Runnable runnable) Queues a runnable to be executed as soon as we have a location fix.
void	setDrawAccuracyEnabled(boolean drawAccuracyEnabled) If enabled, an accuracy circle will be drawn around your current position.
protected void	setLocation(android.location.Location location)
protected void	setMyLocationProvider(IMyLocationProvider myLocationProvider)
void	setOptionsMenuEnabled(boolean pOptionsMenuEnabled)
void	setPersonHotspot(float x, float y)
void	setPersonIcon(android.graphics.Bitmap icon) enabls you to change the my location 'person' icon at runtime.
protected void	stopLocationProvider()

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

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

Methods inherited from class java.lang.Object

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

Field Detail

mPaint

protected final android.graphics.Paint mPaint

mCirclePaint

protected final android.graphics.Paint mCirclePaint

mPersonBitmap

protected android.graphics.Bitmap mPersonBitmap

mDirectionArrowBitmap

protected final android.graphics.Bitmap mDirectionArrowBitmap

mMapView

protected final MapView mMapView

mMyLocationProvider

public IMyLocationProvider mMyLocationProvider

mIsFollowing

protected boolean mIsFollowing

mDrawAccuracyEnabled

protected boolean mDrawAccuracyEnabled

mPersonHotspot

protected final android.graphics.PointF mPersonHotspot

Coordinates the feet of the person are located scaled for display density.

mDirectionArrowCenterX

protected final float mDirectionArrowCenterX

mDirectionArrowCenterY

protected final float mDirectionArrowCenterY

MENU_MY_LOCATION

public static final int MENU_MY_LOCATION

Constructor Detail

MyLocationNewOverlay

public MyLocationNewOverlay(android.content.Context context,
                    MapView mapView)

MyLocationNewOverlay

public MyLocationNewOverlay(android.content.Context context,
                    IMyLocationProvider myLocationProvider,
                    MapView mapView)

MyLocationNewOverlay

public MyLocationNewOverlay(IMyLocationProvider myLocationProvider,
                    MapView mapView,
                    ResourceProxy resourceProxy)

Method Detail

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

setDrawAccuracyEnabled

public void setDrawAccuracyEnabled(boolean drawAccuracyEnabled)

If enabled, an accuracy circle will be drawn around your current position.

Parameters:

drawAccuracyEnabled - whether the accuracy circle will be enabled

isDrawAccuracyEnabled

public boolean isDrawAccuracyEnabled()

If enabled, an accuracy circle will be drawn around your current position.

Returns:

true if enabled, false otherwise

getMyLocationProvider

public IMyLocationProvider getMyLocationProvider()

setMyLocationProvider

protected void setMyLocationProvider(IMyLocationProvider myLocationProvider)

setPersonHotspot

public void setPersonHotspot(float x,
                    float y)

drawMyLocation

protected void drawMyLocation(android.graphics.Canvas canvas,
                  MapView mapView,
                  android.location.Location lastFix)

getMyLocationDrawingBounds

protected android.graphics.Rect getMyLocationDrawingBounds(int zoomLevel,
                                               android.location.Location lastFix,
                                               android.graphics.Rect reuse)

draw

protected void draw(android.graphics.Canvas c,
        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.

Specified by:

draw in class Overlay

onSnapToItem

public boolean onSnapToItem(int x,
                   int y,
                   android.graphics.Point snapPoint,
                   IMapView mapView)

Description copied from interface: Overlay.Snappable

Checks to see if the given x and y are close enough to an item resulting in snapping the current action (e.g. zoom) to the item.

Specified by:

onSnapToItem in interface Overlay.Snappable

Parameters:

x - The x in screen coordinates.

y - The y in screen coordinates.

snapPoint - To be filled with the the interesting point (in screen coordinates) that is closest to the given x and y. Can be untouched if not snapping.

mapView - The MapView that is requesting the snap. Use MapView.getProjection() to convert between on-screen pixels and latitude/longitude pairs.

Returns:

Whether or not to snap to the interesting point.

onTouchEvent

public boolean onTouchEvent(android.view.MotionEvent event,
                   MapView mapView)

Description copied from class: Overlay

You can prevent all(!) other Touch-related events from happening!
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:

onTouchEvent in class Overlay

setOptionsMenuEnabled

public void setOptionsMenuEnabled(boolean pOptionsMenuEnabled)

Specified by:

setOptionsMenuEnabled in interface IOverlayMenuProvider

isOptionsMenuEnabled

public boolean isOptionsMenuEnabled()

Description copied from interface: IOverlayMenuProvider

Can be used to signal to external callers that this Overlay should not be used for providing option menu items.

Specified by:

isOptionsMenuEnabled in interface IOverlayMenuProvider

onCreateOptionsMenu

public boolean onCreateOptionsMenu(android.view.Menu pMenu,
                          int pMenuIdOffset,
                          MapView pMapView)

Specified by:

onCreateOptionsMenu in interface IOverlayMenuProvider

onPrepareOptionsMenu

public boolean onPrepareOptionsMenu(android.view.Menu pMenu,
                           int pMenuIdOffset,
                           MapView pMapView)

Specified by:

onPrepareOptionsMenu in interface IOverlayMenuProvider

onOptionsItemSelected

public boolean onOptionsItemSelected(android.view.MenuItem pItem,
                            int pMenuIdOffset,
                            MapView pMapView)

Specified by:

onOptionsItemSelected in interface IOverlayMenuProvider

getMyLocation

public GeoPoint getMyLocation()

Return a GeoPoint of the last known location, or null if not known.

getLastFix

public android.location.Location getLastFix()

enableFollowLocation

public void enableFollowLocation()

Enables "follow" functionality. The map will center on your current location and automatically scroll as you move. Scrolling the map in the UI will disable.

disableFollowLocation

public void disableFollowLocation()

Disables "follow" functionality.

isFollowLocationEnabled

public boolean isFollowLocationEnabled()

If enabled, the map will center on your current location and automatically scroll as you move. Scrolling the map in the UI will disable.

Returns:

true if enabled, false otherwise

onLocationChanged

public void onLocationChanged(android.location.Location location,
                     IMyLocationProvider source)

Description copied from interface: IMyLocationConsumer

Call when a provider has a new location to consume. This can be called on any thread.

Specified by:

onLocationChanged in interface IMyLocationConsumer

setLocation

protected void setLocation(android.location.Location location)

enableMyLocation

public boolean enableMyLocation(IMyLocationProvider myLocationProvider)

enableMyLocation

public boolean enableMyLocation()

Enable receiving location updates from the provided IMyLocationProvider and show your location on the maps. You will likely want to call enableMyLocation() from your Activity's Activity.onResume() method, to enable the features of this overlay. Remember to call the corresponding disableMyLocation() in your Activity's Activity.onPause() method to turn off updates when in the background.

disableMyLocation

public void disableMyLocation()

Disable location updates

stopLocationProvider

protected void stopLocationProvider()

isMyLocationEnabled

public boolean isMyLocationEnabled()

If enabled, the map is receiving location updates and drawing your location on the map.

Returns:

true if enabled, false otherwise

runOnFirstFix

public boolean runOnFirstFix(Runnable runnable)

Queues a runnable to be executed as soon as we have a location fix. If we already have a fix, we'll execute the runnable immediately and return true. If not, we'll hang on to the runnable and return false; as soon as we get a location fix, we'll run it in in a new thread.

setPersonIcon

public void setPersonIcon(android.graphics.Bitmap icon)

enabls you to change the my location 'person' icon at runtime. note that the hotspot is not updated with this method. see setPersonHotspot(float, float)

Parameters:

icon -