com.nutiteq.datasources.raster

Class MBTilesRasterDataSource

java.lang.Object

com.nutiteq.rasterdatasources.AbstractRasterDataSource

com.nutiteq.datasources.raster.MBTilesRasterDataSource

All Implemented Interfaces:

UTFGridDataSource, com.nutiteq.rasterdatasources.RasterDataSource

public class MBTilesRasterDataSource
extends com.nutiteq.rasterdatasources.AbstractRasterDataSource
implements UTFGridDataSource

A raster data source class for reading map tiles from local Sqlite database. The database must contain table tiles with the following fields:

zoom_level (zoom level of the tile), tile_column, tile_row, tile_data (compressed tile bitmap)

Nested Class Summary

Nested classes/interfaces inherited from interface com.nutiteq.rasterdatasources.RasterDataSource

com.nutiteq.rasterdatasources.RasterDataSource.OnChangeListener

Field Summary

Fields inherited from class com.nutiteq.rasterdatasources.AbstractRasterDataSource

maxZoom, minZoom, projection

Constructor Summary

Constructors

Constructor and Description
MBTilesRasterDataSource(com.nutiteq.projections.Projection projection, int minZoom, int maxZoom, String path, boolean tmsY, android.content.Context ctx) Default constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Close database file.
MBTilesDbHelper	getDatabase() Get database helper instance.
com.nutiteq.components.TileBitmap	loadTile(com.nutiteq.components.MapTile tile)
UtfGridHelper.MBTileUTFGrid	loadUTFGrid(com.nutiteq.components.MapTile tile) Load UTF grid data for given tile.
void	reopen(String path, boolean tmsY, android.content.Context ctx) Reopen database file

Methods inherited from class com.nutiteq.rasterdatasources.AbstractRasterDataSource

addOnChangeListener, getMaxZoom, getMinZoom, getProjection, notifyTilesChanged, removeOnChangeListener

Methods inherited from class java.lang.Object

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

Constructor Detail

MBTilesRasterDataSource

public MBTilesRasterDataSource(com.nutiteq.projections.Projection projection,
                       int minZoom,
                       int maxZoom,
                       String path,
                       boolean tmsY,
                       android.content.Context ctx)
                        throws IOException

Default constructor.

Parameters:

projection - projection for the data source (practically always EPSG3857)

minZoom - minimum zoom supported by the data source.

maxZoom - maximum zoom supported by the data source.

path - path to the local Sqlite database file. SQLiteException will be thrown if the database does not exist or can not be opened in read-only mode.

tmsY - flag describing if tiles are vertically flipped or not

ctx - Android application context.

Throws:

IOException - exception if file not exists

Method Detail

reopen

public void reopen(String path,
          boolean tmsY,
          android.content.Context ctx)
            throws IOException

Reopen database file

Parameters:

path - path to the local Sqlite database file. SQLiteException will be thrown if the database does not exist or can not be opened in read-only mode.

tmsY - flag describing if tiles are vertically flipped or not

ctx - Android application context.

Throws:

IOException - exception if file not exists

close

public void close()

Close database file. After calling this, new tiles will not be read from the database.

getDatabase

public MBTilesDbHelper getDatabase()

Get database helper instance.

Returns:

database helper instance if database is open, or null if closed.

loadTile

public com.nutiteq.components.TileBitmap loadTile(com.nutiteq.components.MapTile tile)

Specified by:

loadTile in interface com.nutiteq.rasterdatasources.RasterDataSource

loadUTFGrid

public UtfGridHelper.MBTileUTFGrid loadUTFGrid(com.nutiteq.components.MapTile tile)

Description copied from interface: UTFGridDataSource

Load UTF grid data for given tile.

Specified by:

loadUTFGrid in interface UTFGridDataSource

Parameters:

tile - input tile

Returns:

UTF grid data for the tile or null if not available.