org.openstreetmap.gui.jmapviewer.tilesources

Class TMSTileSource

java.lang.Object

org.openstreetmap.gui.jmapviewer.tilesources.AbstractTileSource

org.openstreetmap.gui.jmapviewer.tilesources.AbstractTMSTileSource

org.openstreetmap.gui.jmapviewer.tilesources.TMSTileSource

All Implemented Interfaces:

Attributed, TileSource

Direct Known Subclasses:

AbstractOsmTileSource, AbstractWMSTileSource, BingAerialTileSource, ScanexTileSource, TemplatedTMSTileSource

public class TMSTileSource
extends AbstractTMSTileSource

TMS tile source.

Field Summary

Fields

Modifier and Type	Field and Description
protected int	maxZoom
protected int	minZoom
protected OsmMercator	osmMercator

Fields inherited from class org.openstreetmap.gui.jmapviewer.tilesources.AbstractTMSTileSource

baseUrl, id, modTileFeatures, name, tileSize

Fields inherited from class org.openstreetmap.gui.jmapviewer.tilesources.AbstractTileSource

attributionImage, attributionImageURL, attributionLinkURL, attributionText, termsOfUseText, termsOfUseURL

Constructor Summary

Constructors

Constructor and Description
TMSTileSource(TileSourceInfo info) Constructs a new TMSTileSource.

Method Summary

Modifier and Type	Method and Description
TileRange	getCoveringTileRange(Tile tile, int newZoom) Returns a range of tiles, that cover a given tile, which is usually at a different zoom level.
double	getDistance(double lat1, double lon1, double lat2, double lon2) Gets the distance using Spherical law of cosines.
int	getMaxZoom() Specifies the maximum zoom value.
int	getMinZoom() Specifies the minimum zoom value.
java.lang.String	getServerCRS() Get coordinate reference system for this tile source.
boolean	isInside(Tile inner, Tile outer) Check if one tile is inside another tile.
TileXY	latLonToTileXY(double lat, double lon, int zoom) Transforms longitude and latitude to tile indices.
java.awt.Point	latLonToXY(double lat, double lon, int zoom) Transforms longitude and latitude to pixel space (as if all tiles at specified zoom level where joined).
TileXY	projectedToTileXY(IProjected p, int zoom) Convert projected coordinates to tile indices.
ICoordinate	tileXYToLatLon(int x, int y, int zoom) Transforms tile indices to longitude and latitude.
IProjected	tileXYtoProjected(int x, int y, int zoom) Convert tile indices (x/y/zoom) into projected coordinates of the tile origin.
ICoordinate	xyToLatLon(int x, int y, int zoom) Transforms a point in pixel space to longitude/latitude (WGS84).

Methods inherited from class org.openstreetmap.gui.jmapviewer.tilesources.AbstractTMSTileSource

getBaseUrl, getDefaultTileSize, getExtension, getId, getMetadata, getName, getTileId, getTilePath, getTileSize, getTileUrl, getTileXMax, getTileXMin, getTileYMax, getTileYMin, isModTileFeatures, isNoTileAtZoom, latLonToTileXY, latLonToXY, tileXYToLatLon, tileXYToLatLon, toString, xyToLatLon

Methods inherited from class org.openstreetmap.gui.jmapviewer.tilesources.AbstractTileSource

getAttributionImage, getAttributionImageURL, getAttributionLinkURL, getAttributionText, getTermsOfUseText, getTermsOfUseURL, requiresAttribution, setAttributionImage, setAttributionImageURL, setAttributionLinkURL, setAttributionText, setTermsOfUseText, setTermsOfUseURL

Methods inherited from class java.lang.Object

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

Field Detail

maxZoom

protected int maxZoom

minZoom

protected int minZoom

osmMercator

protected OsmMercator osmMercator

Constructor Detail

TMSTileSource

public TMSTileSource(TileSourceInfo info)

Constructs a new TMSTileSource.

Parameters:

info - tile source information

Method Detail

getMinZoom

public int getMinZoom()

Description copied from interface: TileSource

Specifies the minimum zoom value. This value is usually 0. Only for maps that cover a certain region up to a limited zoom level this method should return a value different than 0.

Specified by:

getMinZoom in interface TileSource

Overrides:

getMinZoom in class AbstractTMSTileSource

Returns:

minimum zoom value - usually 0

getMaxZoom

public int getMaxZoom()

Description copied from interface: TileSource

Specifies the maximum zoom value. The number of zoom levels is [0.. TileSource.getMaxZoom()].

Specified by:

getMaxZoom in interface TileSource

Overrides:

getMaxZoom in class AbstractTMSTileSource

Returns:

maximum zoom value that has to be smaller or equal to JMapViewer.MAX_ZOOM

getDistance

public double getDistance(double lat1,
                          double lon1,
                          double lat2,
                          double lon2)

Description copied from interface: TileSource

Gets the distance using Spherical law of cosines.

Parameters:

lat1 - latitude of first point

lon1 - longitude of first point

lat2 - latitude of second point

lon2 - longitude of second point

Returns:

the distance between first and second point, in m.

latLonToXY

public java.awt.Point latLonToXY(double lat,
                                 double lon,
                                 int zoom)

Description copied from interface: TileSource

Transforms longitude and latitude to pixel space (as if all tiles at specified zoom level where joined).

Parameters:

lat - latitude

lon - longitude

zoom - zoom level

Returns:

the pixel coordinates

xyToLatLon

public ICoordinate xyToLatLon(int x,
                              int y,
                              int zoom)

Description copied from interface: TileSource

Transforms a point in pixel space to longitude/latitude (WGS84).

Parameters:

x - X coordinate

y - Y coordinate

zoom - zoom level

Returns:

WGS84 Coordinates of given point

latLonToTileXY

public TileXY latLonToTileXY(double lat,
                             double lon,
                             int zoom)

Description copied from interface: TileSource

Transforms longitude and latitude to tile indices.

Parameters:

lat - latitude

lon - longitude

zoom - zoom level

Returns:

x and y tile indices

tileXYToLatLon

public ICoordinate tileXYToLatLon(int x,
                                  int y,
                                  int zoom)

Description copied from interface: TileSource

Transforms tile indices to longitude and latitude.

Parameters:

x - x tile index

y - y tile index

zoom - zoom level

Returns:

WGS84 coordinates of given tile

tileXYtoProjected

public IProjected tileXYtoProjected(int x,
                                    int y,
                                    int zoom)

Description copied from interface: TileSource

Convert tile indices (x/y/zoom) into projected coordinates of the tile origin.

Parameters:

x - x tile index

y - z tile index

zoom - zoom level

Returns:

projected coordinates of the tile origin

projectedToTileXY

public TileXY projectedToTileXY(IProjected p,
                                int zoom)

Description copied from interface: TileSource

Convert projected coordinates to tile indices.

Parameters:

p - projected coordinates

zoom - zoom level

Returns:

corresponding tile index x/y (floating point, truncate to integer for tile index)

isInside

public boolean isInside(Tile inner,
                        Tile outer)

Description copied from interface: TileSource

Check if one tile is inside another tile.

Parameters:

inner - the tile that is suspected to be inside the other tile

outer - the tile that might contain the first tile

Returns:

true if first tile is inside second tile (or both are identical), false otherwise

getCoveringTileRange

public TileRange getCoveringTileRange(Tile tile,
                                      int newZoom)

Description copied from interface: TileSource

Returns a range of tiles, that cover a given tile, which is usually at a different zoom level. In standard tile layout, 4 tiles cover a tile one zoom lower, 16 tiles cover a tile 2 zoom levels below etc. If the zoom level of the covering tiles is greater or equal, a single tile suffices.

Parameters:

tile - the tile to cover

newZoom - zoom level of the covering tiles

Returns:

TileRange of all covering tiles at zoom newZoom

getServerCRS

public java.lang.String getServerCRS()

Description copied from interface: TileSource

Get coordinate reference system for this tile source. E.g. "EPSG:3857" for Google-Mercator.

Returns:

code for the coordinate reference system in use