org.osmdroid.tileprovider

Class MapTileProviderArray

java.lang.Object

org.osmdroid.tileprovider.MapTileProviderBase

org.osmdroid.tileprovider.MapTileProviderArray

All Implemented Interfaces:

OpenStreetMapTileProviderConstants, IMapTileProviderCallback

Direct Known Subclasses:

MapTileProviderBasic

public class MapTileProviderArray
extends MapTileProviderBase

This top-level tile provider allows a consumer to provide an array of modular asynchronous tile providers to be used to obtain map tiles. When a tile is requested, the MapTileProviderArray first checks the MapTileCache (synchronously) and returns the tile if available. If not, then the MapTileProviderArray returns null and sends the tile request through the asynchronous tile request chain. Each asynchronous tile provider returns success/failure to the MapTileProviderArray. If successful, the MapTileProviderArray passes the result to the base class. If failed, then the next asynchronous tile provider is called in the chain. If there are no more asynchronous tile providers in the chain, then the failure result is passed to the base class. The MapTileProviderArray provides a mechanism so that only one unique tile-request can be in the map tile request chain at a time.

Author:

Marc Kurtz

Field Summary

Fields

Modifier and Type	Field and Description
protected List<MapTileModuleProviderBase>	mTileProviderList
protected HashMap<MapTile,MapTileRequestState>	mWorking

Fields inherited from class org.osmdroid.tileprovider.MapTileProviderBase

mTileCache, mTileRequestCompleteHandler, mUseDataConnection

Fields inherited from interface org.osmdroid.tileprovider.constants.OpenStreetMapTileProviderConstants

CACHE_MAPTILECOUNT_DEFAULT, DEBUG_TILE_PROVIDERS, DEBUGMODE, DEFAULT_MAXIMUM_CACHED_FILE_AGE, MAXIMUM_ZOOMLEVEL, MINIMUM_ZOOMLEVEL, NUMBER_OF_TILE_DOWNLOAD_THREADS, NUMBER_OF_TILE_FILESYSTEM_THREADS, ONE_DAY, ONE_HOUR, ONE_MINUTE, ONE_SECOND, ONE_WEEK, ONE_YEAR, OSMDROID_PATH, TILE_DOWNLOAD_MAXIMUM_QUEUE_SIZE, TILE_EXPIRY_TIME_MILLISECONDS, TILE_FILESYSTEM_MAXIMUM_QUEUE_SIZE, TILE_MAX_CACHE_SIZE_BYTES, TILE_PATH_BASE, TILE_PATH_EXTENSION, TILE_TRIM_CACHE_SIZE_BYTES

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	MapTileProviderArray(ITileSource pTileSource, IRegisterReceiver pRegisterReceiver) Creates an MapTileProviderArray with no tile providers.
	MapTileProviderArray(ITileSource pTileSource, IRegisterReceiver aRegisterReceiver, MapTileModuleProviderBase[] pTileProviderArray) Creates an MapTileProviderArray with the specified tile providers.

Method Summary

Methods

Modifier and Type	Method and Description
void	detach()
protected MapTileModuleProviderBase	findNextAppropriateProvider(MapTileRequestState aState) We want to not use a provider that doesn't exist anymore in the chain, and we want to not use a provider that requires a data connection when one is not available.
android.graphics.drawable.Drawable	getMapTile(MapTile pTile) Attempts to get a Drawable that represents a MapTile.
int	getMaximumZoomLevel() Gets the maximum zoom level this tile provider can provide
int	getMinimumZoomLevel() Gets the minimum zoom level this tile provider can provide
boolean	getProviderExists(MapTileModuleProviderBase provider)
void	mapTileRequestCompleted(MapTileRequestState aState, android.graphics.drawable.Drawable aDrawable) Called by implementation class methods indicating that they have completed the request as best it can.
void	mapTileRequestExpiredTile(MapTileRequestState aState, android.graphics.drawable.Drawable aDrawable) 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 aState) Called by implementation class methods indicating that they have failed to retrieve the requested map tile.
void	setTileSource(ITileSource aTileSource) Sets the tile source for this tile provider.

Methods inherited from class org.osmdroid.tileprovider.MapTileProviderBase

clearTileCache, createTileCache, ensureCapacity, getTileSource, putExpiredTileIntoCache, putTileIntoCache, rescaleCache, setTileRequestCompleteHandler, setUseDataConnection, useDataConnection

Methods inherited from class java.lang.Object

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

Field Detail

mWorking

protected final HashMap<MapTile,MapTileRequestState> mWorking

mTileProviderList

protected final List<MapTileModuleProviderBase> mTileProviderList

Constructor Detail

MapTileProviderArray

protected MapTileProviderArray(ITileSource pTileSource,
                    IRegisterReceiver pRegisterReceiver)

Creates an MapTileProviderArray with no tile providers.

Parameters:

pRegisterReceiver - a IRegisterReceiver

MapTileProviderArray

public MapTileProviderArray(ITileSource pTileSource,
                    IRegisterReceiver aRegisterReceiver,
                    MapTileModuleProviderBase[] pTileProviderArray)

Creates an MapTileProviderArray with the specified tile providers.

Parameters:

aRegisterReceiver - a IRegisterReceiver

pTileProviderArray - an array of MapTileModuleProviderBase

Method Detail

detach

public void detach()

Specified by:

detach in class MapTileProviderBase

getMapTile

public android.graphics.drawable.Drawable getMapTile(MapTile pTile)

Description copied from class: MapTileProviderBase

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.

Specified by:

getMapTile in class MapTileProviderBase

See Also:

ReusableBitmapDrawable

mapTileRequestCompleted

public void mapTileRequestCompleted(MapTileRequestState aState,
                           android.graphics.drawable.Drawable aDrawable)

Description copied from class: MapTileProviderBase

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

Overrides:

mapTileRequestCompleted in class MapTileProviderBase

Parameters:

aState - the map tile request state object

aDrawable - the Drawable of the map tile

mapTileRequestFailed

public void mapTileRequestFailed(MapTileRequestState aState)

Description copied from class: MapTileProviderBase

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

Overrides:

mapTileRequestFailed in class MapTileProviderBase

Parameters:

aState - the map tile request state object

mapTileRequestExpiredTile

public void mapTileRequestExpiredTile(MapTileRequestState aState,
                             android.graphics.drawable.Drawable aDrawable)

Description copied from class: MapTileProviderBase

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

Overrides:

mapTileRequestExpiredTile in class MapTileProviderBase

Parameters:

aState - the map tile request state object

aDrawable - the Drawable of the map tile

findNextAppropriateProvider

protected MapTileModuleProviderBase findNextAppropriateProvider(MapTileRequestState aState)

We want to not use a provider that doesn't exist anymore in the chain, and we want to not use a provider that requires a data connection when one is not available.

getProviderExists

public boolean getProviderExists(MapTileModuleProviderBase provider)

getMinimumZoomLevel

public int getMinimumZoomLevel()

Description copied from class: MapTileProviderBase

Gets the minimum zoom level this tile provider can provide

Specified by:

getMinimumZoomLevel in class MapTileProviderBase

Returns:

the minimum zoom level

getMaximumZoomLevel

public int getMaximumZoomLevel()

Description copied from class: MapTileProviderBase

Gets the maximum zoom level this tile provider can provide

Specified by:

getMaximumZoomLevel in class MapTileProviderBase

Returns:

the maximum zoom level

setTileSource

public void setTileSource(ITileSource aTileSource)

Description copied from class: MapTileProviderBase

Sets the tile source for this tile provider.

Overrides:

setTileSource in class MapTileProviderBase

Parameters:

aTileSource - the tile source