com.nutiteq.maps
Interface GeoMap

All Known Implementing Classes:

BaseKaMap, BaseMap, BlomOrthoMap, CloudMade, DbStoredMap, DigitalGlobeMap, EPSG3395, EPSG3785, EPSG4326, JaredOpenStreetMap, KaMap, Lambert, MultiStoredMap, NavteqMapTP, NutiteqStreamedMap, OpenStreetMap, QKMap, SimpleWMSMap, StoredMap, StreamedCloudMadeMap, StreamedKaMap, StreamedOpenAerialMap, TMSMap, UnstreamedDoubleSizedTilesMap

public interface GeoMap

Defines the basic properties for displayed map.

Method Summary

void	addTileOverlay(MapTileOverlay overlay) Add overlay for displaying tiles with additional data on map tiles.
Copyright	getCopyright() Map copyright string painted on screen
com.nutiteq.task.Task	getInitializationTask() Get task that will be executed after this is set with BasicMapComponent.setMap(GeoMap)
int	getMapHeight(int zoom) Get map height based on zoom level
int	getMapWidth(int zoom) Get map width based on zoom level
int	getMaxZoom() Maximum zoom level for implementing map.
int	getMinZoom() Minimum zoom level for implementing map.
com.nutiteq.wrappers.Image	getMissingTileImage() Get image used for showing missing image.
ZoomRange	getZoomRange() Get zoom range for the map
TileMapBounds	getTileMapBounds(int zoom) Get map bounds for given zoom level.
MapTileOverlay	getTileOverlay() Get overlay used for map
int	getTileSize() Get tile size for implemented map
Point	mapPosToWgs(MapPos pos) Convert a point on pixel map to WGS84 coordinates (decimal coordinates * 1000000)
void	setMissingTileImage(com.nutiteq.wrappers.Image missingTile) Set image used for missing tiles
MapPos	zoom(MapPos middlePoint, int zoomSteps) Do zoom calculations for screen middle point
MapPos	wgsToMapPos(Point wgs, int zoom) Convert WGS84 coordinates to pixel point on map

Method Detail

getInitializationTask

com.nutiteq.task.Task getInitializationTask()

Get task that will be executed after this is set with BasicMapComponent.setMap(GeoMap)

Returns:

Task to execute.

getMinZoom

int getMinZoom()

Minimum zoom level for implementing map.

Returns:

minimum zoom level

getMaxZoom

int getMaxZoom()

Maximum zoom level for implementing map.

Returns:

maximum zoom for the map

mapPosToWgs

Point mapPosToWgs(MapPos pos)

Convert a point on pixel map to WGS84 coordinates (decimal coordinates * 1000000)

Parameters:

pos - pixel point on the map (on 256x256 pixels map of the world 0E 0N is located at map pixel 128x : 128y)

Returns:

point in internally used WGS84 format (decimal degrees * 1000000)

wgsToMapPos

MapPos wgsToMapPos(Point wgs,
                   int zoom)

Convert WGS84 coordinates to pixel point on map

Parameters:

wgs - WGS84 coordinates (decimal coordinates * 1000000)

zoom - zoom level for the map

Returns:

pixel position on map for the coordinates

getTileSize

int getTileSize()

Get tile size for implemented map

Returns:

tile size in pixels

getMapWidth

int getMapWidth(int zoom)

Get map width based on zoom level

Parameters:

zoom - internal zoom (world in 256x256 pizels is 0)

Returns:

map width

getMapHeight

int getMapHeight(int zoom)

Get map height based on zoom level

Parameters:

zoom - internal zoom (world in 256x256 pizels is 0)

Returns:

map height

zoom

MapPos zoom(MapPos middlePoint,
            int zoomSteps)

Do zoom calculations for screen middle point

Parameters:

middlePoint - current middle point

zoomSteps - zoom steps (positive is zoom in, negative zoom out)

Returns:

return new screen middle point location on new zoom level

getZoomRange

ZoomRange getZoomRange()

Get zoom range for the map

Returns:

zoom range (min zoom, max zoom) for the map

getCopyright

Copyright getCopyright()

Map copyright string painted on screen

Returns:

copyright string

getTileMapBounds

TileMapBounds getTileMapBounds(int zoom)

Get map bounds for given zoom level. This is used to check if retrieved tile is valid and also stop panning outside map coverage.

Parameters:

zoom - current zoom level

Returns:

minimum and maximum points on the tile map

addTileOverlay

void addTileOverlay(MapTileOverlay overlay)

Add overlay for displaying tiles with additional data on map tiles.

Parameters:

overlay - overlay to be used for additional data

getTileOverlay

MapTileOverlay getTileOverlay()

Get overlay used for map

Returns:

overlay used for additional data

getMissingTileImage

com.nutiteq.wrappers.Image getMissingTileImage()

Get image used for showing missing image.

Returns:

image used

setMissingTileImage

void setMissingTileImage(com.nutiteq.wrappers.Image missingTile)

Set image used for missing tiles

Parameters:

missingTile - image used