org.geotools.ows.wmts.client

Class WMTSTileService

Object

TileService

WMTSTileService

All Implemented Interfaces:

ImageLoader

public class WMTSTileService
extends TileService

A tile service for WMTS servers.

This is tied to a single layer, style and matrixset.

Author:

ian, Emanuele Tajariol (etj at geo-solutions dot it)

Field Summary

Fields

Modifier and Type	Field and Description
static String	DIMENSION_ELEVATION
static String	DIMENSION_TIME
static String	EXTRA_HEADERS
protected static Logger	LOGGER

Constructor Summary

Constructors

Constructor and Description
WMTSTileService(String templateURL, WMTSServiceType type, WMTSLayer layer, String styleName, TileMatrixSet tileMatrixSet) create a service directly with out parsing the capabilties again.
WMTSTileService(String templateURL, WMTSServiceType type, WMTSLayer layer, String styleName, TileMatrixSet tileMatrixSet, HTTPClient client) create a service directly with out parsing the capabilties again.

Method Summary

Modifier and Type	Method and Description
protected Tile	addTileToCache(Tile tile) Add a tile to the cache.
Set<Tile>	findTilesInExtent(ReferencedEnvelope requestedExtent, double scaleFactor, boolean recommendedZoomLevel, int maxNumberOfTiles)
ReferencedEnvelope	getBounds()
Map<String,String>	getDimensions()
Map<String,Object>	getExtrainfo()
String	getFormat()
String	getLayerName()
TileMatrixSet	getMatrixSet()
TileMatrixSetLink	getMatrixSetLink()
CoordinateReferenceSystem	getProjectedTileCrs() The projection the tiles are drawn in.
protected ReferencedEnvelope	getReqExtentInTileCrs(ReferencedEnvelope requestedExtent)
double[]	getScaleList() Returns a list that represents a mapping between zoom-levels and map scale.
String	getStyleName()
String	getTemplateURL()
TileFactory	getTileFactory() Returns the TileFactory which is used to call the method getTileFromCoordinate().
TileMatrix	getTileMatrix(int zoomLevel)
String	getTileMatrixSetName()
WMTSServiceType	getType()
WMTSZoomLevel	getZoomLevel(int zoom)
void	setFormat(String format)
void	setMatrixSet(TileMatrixSet matrixSet)
void	setStyleName(String styleName)
void	setTemplateURL(String templateURL)
void	setTileMatrixSetName(String tileMatrixSetName)
void	setType(WMTSServiceType type)

Methods inherited from class TileService

createSafeEnvelopeInWGS84, getBaseUrl, getHttpClient, getMaxZoomLevel, getMinZoomLevel, getName, getTileCrs, getTileHeight, getTileWidth, getZoomLevelFromMapScale, getZoomLevelToUse, loadImageTileImage, toString

Methods inherited from class Object

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

Field Detail

LOGGER

protected static final Logger LOGGER

DIMENSION_TIME

public static final String DIMENSION_TIME

See Also:

Constant Field Values

DIMENSION_ELEVATION

public static final String DIMENSION_ELEVATION

See Also:

Constant Field Values

EXTRA_HEADERS

public static final String EXTRA_HEADERS

See Also:

Constant Field Values

Constructor Detail

WMTSTileService

public WMTSTileService(String templateURL,
                       WMTSServiceType type,
                       WMTSLayer layer,
                       String styleName,
                       TileMatrixSet tileMatrixSet)

create a service directly with out parsing the capabilties again.

Parameters:

templateURL - - where to ask for tiles

type - - KVP or REST

layer - - the layer to request

styleName - - name of the style to use?

tileMatrixSet - - the tile matrix set to use

WMTSTileService

public WMTSTileService(String templateURL,
                       WMTSServiceType type,
                       WMTSLayer layer,
                       String styleName,
                       TileMatrixSet tileMatrixSet,
                       HTTPClient client)

create a service directly with out parsing the capabilties again.

Parameters:

templateURL - - where to ask for tiles

type - - KVP or REST

layer - - layer to request

styleName - - name of the style to use?

tileMatrixSet - - matrixset

client - - HttpClient instance to use for Tile requests.

Method Detail

getReqExtentInTileCrs

protected ReferencedEnvelope getReqExtentInTileCrs(ReferencedEnvelope requestedExtent)

findTilesInExtent

public Set<Tile> findTilesInExtent(ReferencedEnvelope requestedExtent,
                                   double scaleFactor,
                                   boolean recommendedZoomLevel,
                                   int maxNumberOfTiles)

Overrides:

findTilesInExtent in class TileService

addTileToCache

protected Tile addTileToCache(Tile tile)

Add a tile to the cache.

At the moment we are delegating the cache to the super class, which handles the cache as a soft cache. The soft cache has an un-controllable time to live, could last a split seconds or 100 years. However, WMTS services normally come with caching headers of some sort, e.g., do not cache, or keep for 1 hour, or 6 months and so on.

TODO: The code should account for that.

Overrides:

addTileToCache in class TileService

getType

public WMTSServiceType getType()

Returns:

the type

setType

public void setType(WMTSServiceType type)

Parameters:

type - the type to set

getLayerName

public String getLayerName()

Returns:

the layerName

getStyleName

public String getStyleName()

Returns:

the styleName

setStyleName

public void setStyleName(String styleName)

Parameters:

styleName - the styleName to set

getScaleList

public double[] getScaleList()

Description copied from class: TileService

Returns a list that represents a mapping between zoom-levels and map scale.

Array index: zoom-level Value at index: map scale High zoom-level -> more detailed map Low zoom-level -> less detailed map

Specified by:

getScaleList in class TileService

Returns:

mapping between zoom-levels and map scale

getBounds

public ReferencedEnvelope getBounds()

Specified by:

getBounds in class TileService

getProjectedTileCrs

public CoordinateReferenceSystem getProjectedTileCrs()

Description copied from class: TileService

The projection the tiles are drawn in.

Specified by:

getProjectedTileCrs in class TileService

getTileFactory

public TileFactory getTileFactory()

Description copied from class: TileService

Returns the TileFactory which is used to call the method getTileFromCoordinate().

Specified by:

getTileFactory in class TileService

getTileMatrixSetName

public String getTileMatrixSetName()

Returns:

the tileMatrixSetName

setTileMatrixSetName

public void setTileMatrixSetName(String tileMatrixSetName)

Parameters:

tileMatrixSetName - the tileMatrixSetName to set

getMatrixSetLink

public TileMatrixSetLink getMatrixSetLink()

getTemplateURL

public String getTemplateURL()

Returns:

the templateURL

setTemplateURL

public void setTemplateURL(String templateURL)

Parameters:

templateURL - the templateURL to set

getTileMatrix

public TileMatrix getTileMatrix(int zoomLevel)

getMatrixSet

public TileMatrixSet getMatrixSet()

Returns:

the matrixSet

setMatrixSet

public void setMatrixSet(TileMatrixSet matrixSet)

Parameters:

matrixSet - the matrixSet to set

getFormat

public String getFormat()

Returns:

setFormat

public void setFormat(String format)

Parameters:

format - the format to set

getZoomLevel

public WMTSZoomLevel getZoomLevel(int zoom)

getDimensions

public Map<String,String> getDimensions()

getExtrainfo

public Map<String,Object> getExtrainfo()