org.osmdroid.tileprovider

Class MapTileProviderBase

java.lang.Object

org.osmdroid.tileprovider.MapTileProviderBase

All Implemented Interfaces:

IMapTileProviderCallback

Direct Known Subclasses:

MapTileProviderArray

public abstract class MapTileProviderBase
extends Object
implements IMapTileProviderCallback

This is an abstract class. The tile provider is responsible for:

• determining if a map tile is available,
• notifying the client, via a callback handler

see MapTile for an overview of how tiles are served by this provider.

Field Summary

Fields

Modifier and Type	Field and Description
protected MapTileCache	mTileCache
protected Drawable	mTileNotFoundImage
protected Handler	mTileRequestCompleteHandler
protected boolean	mUseDataConnection

Constructor Summary

Constructors

Constructor and Description
MapTileProviderBase(ITileSource pTileSource)
MapTileProviderBase(ITileSource pTileSource, Handler pDownloadFinishedListener)

Method Summary

Methods

Modifier and Type	Method and Description
void	clearTileCache() purges the cache of all tiles (default is the in memory cache)
MapTileCache	createTileCache() Creates a MapTileCache to be used to cache tiles in memory.
void	detach() classes that extend MapTileProviderBase must call this method to prevent memory leaks.
void	ensureCapacity(int pCapacity)
abstract Drawable	getMapTile(MapTile pTile) Attempts to get a Drawable that represents a MapTile.
abstract int	getMaximumZoomLevel() Gets the maximum zoom level this tile provider can provide
abstract int	getMinimumZoomLevel() Gets the minimum zoom level this tile provider can provide
ITileSource	getTileSource() Gets the tile source for this tile provider.
abstract IFilesystemCache	getTileWriter()
void	mapTileRequestCompleted(MapTileRequestState pState, Drawable pDrawable) Called by implementation class methods indicating that they have completed the request as best it can.
void	mapTileRequestExpiredTile(MapTileRequestState pState, Drawable pDrawable) Called by implementation class methods indicating that they have produced an expired result that can be used but better results may be delivered later.
void	mapTileRequestFailed(MapTileRequestState pState) Called by implementation class methods indicating that they have failed to retrieve the requested map tile.
protected void	putExpiredTileIntoCache(MapTileRequestState pState, Drawable pDrawable)
protected void	putTileIntoCache(MapTileRequestState pState, Drawable pDrawable)
void	rescaleCache(Projection pProjection, int pNewZoomLevel, int pOldZoomLevel, Rect pViewPort) Recreate the cache using scaled versions of the tiles currently in it
void	setTileLoadFailureImage(Drawable drawable) Sets the "sorry we can't load a tile for this location" image.
void	setTileRequestCompleteHandler(Handler handler)
void	setTileSource(ITileSource pTileSource) Sets the tile source for this tile provider.
void	setUseDataConnection(boolean pMode) Set whether to use the network connection if it's available.
boolean	useDataConnection() Whether to use the network connection if it's available.

Methods inherited from class java.lang.Object

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

Field Detail

mTileCache

protected final MapTileCache mTileCache

mTileRequestCompleteHandler

protected Handler mTileRequestCompleteHandler

mUseDataConnection

protected boolean mUseDataConnection

mTileNotFoundImage

protected Drawable mTileNotFoundImage

Constructor Detail

MapTileProviderBase

public MapTileProviderBase(ITileSource pTileSource)

MapTileProviderBase

public MapTileProviderBase(ITileSource pTileSource,
                   Handler pDownloadFinishedListener)

Method Detail

getMapTile

public abstract Drawable getMapTile(MapTile pTile)

Attempts to get a Drawable that represents a MapTile. If the tile is not immediately available this will return null and attempt to get the tile from known tile sources for subsequent future requests. Note that this may return a ReusableBitmapDrawable in which case you should follow proper handling procedures for using that Drawable or it may reused while you are working with it.

See Also:

ReusableBitmapDrawable

detach

public void detach()

classes that extend MapTileProviderBase must call this method to prevent memory leaks. Updated 5.2+

getMinimumZoomLevel

public abstract int getMinimumZoomLevel()

Gets the minimum zoom level this tile provider can provide

Returns:

the minimum zoom level

getMaximumZoomLevel

public abstract int getMaximumZoomLevel()

Gets the maximum zoom level this tile provider can provide

Returns:

the maximum zoom level

setTileSource

public void setTileSource(ITileSource pTileSource)

Sets the tile source for this tile provider.

Parameters:

pTileSource - the tile source

getTileSource

public ITileSource getTileSource()

Gets the tile source for this tile provider.

Returns:

the tile source

createTileCache

public MapTileCache createTileCache()

Creates a MapTileCache to be used to cache tiles in memory.

setTileLoadFailureImage

public void setTileLoadFailureImage(Drawable drawable)

Sets the "sorry we can't load a tile for this location" image. If it's null, the default view is shown, which is the standard grey grid controlled by the tiles overlay TilesOverlay.setLoadingLineColor(int) and TilesOverlay.setLoadingBackgroundColor(int)

Parameters:

drawable -

Since:

5.2+

mapTileRequestCompleted

public void mapTileRequestCompleted(MapTileRequestState pState,
                           Drawable pDrawable)

Called by implementation class methods indicating that they have completed the request as best it can. The tile is added to the cache, and a MAPTILE_SUCCESS_ID message is sent.

Specified by:

mapTileRequestCompleted in interface IMapTileProviderCallback

Parameters:

pState - the map tile request state object

pDrawable - the Drawable of the map tile

mapTileRequestFailed

public void mapTileRequestFailed(MapTileRequestState pState)

Called by implementation class methods indicating that they have failed to retrieve the requested map tile. a MAPTILE_FAIL_ID message is sent.

Specified by:

mapTileRequestFailed in interface IMapTileProviderCallback

Parameters:

pState - the map tile request state object

mapTileRequestExpiredTile

public void mapTileRequestExpiredTile(MapTileRequestState pState,
                             Drawable pDrawable)

Called by implementation class methods indicating that they have produced an expired result that can be used but better results may be delivered later. The tile is added to the cache, and a MAPTILE_SUCCESS_ID message is sent.

Specified by:

mapTileRequestExpiredTile in interface IMapTileProviderCallback

Parameters:

pState - the map tile request state object

pDrawable - the Drawable of the map tile

putTileIntoCache

protected void putTileIntoCache(MapTileRequestState pState,
                    Drawable pDrawable)

putExpiredTileIntoCache

protected void putExpiredTileIntoCache(MapTileRequestState pState,
                           Drawable pDrawable)

setTileRequestCompleteHandler

public void setTileRequestCompleteHandler(Handler handler)

ensureCapacity

public void ensureCapacity(int pCapacity)

clearTileCache

public void clearTileCache()

purges the cache of all tiles (default is the in memory cache)

useDataConnection

public boolean useDataConnection()

Whether to use the network connection if it's available.

Specified by:

useDataConnection in interface IMapTileProviderCallback

Returns:

true if data connection should be used, false otherwise

setUseDataConnection

public void setUseDataConnection(boolean pMode)

Set whether to use the network connection if it's available.

Parameters:

pMode - if true use the network connection if it's available. if false don't use the network connection even if it's available.

rescaleCache

public void rescaleCache(Projection pProjection,
                int pNewZoomLevel,
                int pOldZoomLevel,
                Rect pViewPort)

Recreate the cache using scaled versions of the tiles currently in it

Parameters:

pNewZoomLevel - the zoom level that we need now

pOldZoomLevel - the previous zoom level that we should get the tiles to rescale

pViewPort - the view port we need tiles for

getTileWriter

public abstract IFilesystemCache getTileWriter()