org.openstreetmap.josm.data.imagery

Class WMTSTileSource

java.lang.Object

org.openstreetmap.gui.jmapviewer.tilesources.AbstractTileSource

org.openstreetmap.gui.jmapviewer.tilesources.AbstractTMSTileSource

org.openstreetmap.gui.jmapviewer.tilesources.TMSTileSource

org.openstreetmap.josm.data.imagery.WMTSTileSource

All Implemented Interfaces:

Attributed, TemplatedTileSource, TileSource

public class WMTSTileSource
extends TMSTileSource
implements TemplatedTileSource

Tile Source handling WMS providers

Since:

8526

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	WMTSTileSource.Layer
private static class	WMTSTileSource.SelectLayerDialog
private static class	WMTSTileSource.TileMatrix
private static class	WMTSTileSource.TileMatrixSet
private static class	WMTSTileSource.TransferMode

Field Summary

Fields

Modifier and Type	Field and Description
private static String[]	ALL_PATTERNS
private double	crsScale
private WMTSTileSource.Layer	currentLayer
private WMTSTileSource.TileMatrixSet	currentTileMatrixSet
private Map<String,String>	headers
private Collection<WMTSTileSource.Layer>	layers
private static String	OWS_NS_URL
private static String	PATTERN_HEADER
private WMTSTileSource.TransferMode	transferMode
private static String	URL_GET_ENCODING_PARAMS
private static String	WMTS_NS_URL
private static String	XLINK_NS_URL

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

maxZoom, minZoom

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

baseUrl, id, name, osmMercator, tileSize

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

attributionImage, attributionImageURL, attributionLinkURL, attributionText, termsOfUseText, termsOfUseURL

Constructor Summary

Constructors

Constructor and Description
WMTSTileSource(ImageryInfo info) Creates a tile source based on imagery info

Method Summary

Modifier and Type	Method and Description
static void	checkUrl(String url) Checks if url is acceptable by this Tile Source
private static String	crsToCode(String crsIdentifier)
private Collection<WMTSTileSource.Layer>	getCapabilities()
int	getDefaultTileSize()
double	getDistance(double lat1, double lon1, double lat2, double lon2) Gets the distance using Spherical law of cosines.
Map<String,String>	getHeaders()
private Collection<WMTSTileSource.Layer>	getLayers(String name, String projectionCode)
int	getMaxZoom() Specifies the maximum zoom value.
Set<String>	getSupportedProjections()
String	getTileId(int zoom, int tilex, int tiley) Creates tile identifier that is unique among all tile sources, but the same tile will always get the same identifier.
private WMTSTileSource.TileMatrix	getTileMatrix(int zoom)
int	getTileSize() Specifies how large each tile is.
String	getTileUrl(int zoom, int tilex, int tiley) Constructs the tile url.
int	getTileXMax(int zoom)
private int	getTileXMax(int zoom, Projection proj)
int	getTileXMin(int zoom)
int	getTileYMax(int zoom)
private int	getTileYMax(int zoom, Projection proj)
int	getTileYMin(int zoom)
private static WMTSTileSource.TransferMode	getTransferMode(XMLStreamReader reader) Parses Operation[@name='GetTile']/DCP/HTTP/Get section.
private String	handleTemplate(String url)
void	initProjection(Projection proj) Initializes projection for this TileSource with projection
TileXY	latLonToTileXY(double lat, double lon, int zoom)
TileXY	latLonToTileXY(ICoordinate point, int zoom)
Point	latLonToXY(double lat, double lon, int zoom)
Point	latLonToXY(ICoordinate point, int zoom)
private static boolean	moveReaderToTag(XMLStreamReader reader, QName[] tags) Moves reader to first occurrence of the structure equivalent of Xpath tags[0]/tags[1]../tags[n].
private static String	normalizeCapabilitiesUrl(String url)
private static Collection<WMTSTileSource.Layer>	parseContents(XMLStreamReader reader) Parse Contents tag.
private static WMTSTileSource.Layer	parseLayer(XMLStreamReader reader) Parse Layer tag.
private void	parseOperationMetadata(XMLStreamReader reader) Parses OperationMetadata section.
private static WMTSTileSource.TileMatrix	parseTileMatrix(XMLStreamReader reader, String matrixCrs) Parses TileMatrix section.
private static WMTSTileSource.TileMatrixSet	parseTileMatrixSet(XMLStreamReader reader) Parses TileMatrixSet section.
private static String	praseTileMatrixSetLink(XMLStreamReader reader) Gets TileMatrixSetLink value.
ICoordinate	tileXYToLatLon(int x, int y, int zoom)
ICoordinate	tileXYToLatLon(Tile tile)
ICoordinate	tileXYToLatLon(TileXY xy, int zoom)
private WMTSTileSource.Layer	userSelectLayer(Collection<WMTSTileSource.Layer> layers)
Coordinate	xyToLatLon(int x, int y, int zoom)
Coordinate	xyToLatLon(Point point, int zoom)

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

getMinZoom

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

getBaseUrl, getExtension, getId, getMetadata, getName, getTilePath, isNoTileAtZoom, toString

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

Methods inherited from interface org.openstreetmap.gui.jmapviewer.interfaces.TileSource

getId, getMetadata, getMinZoom, getName, isNoTileAtZoom

Methods inherited from interface org.openstreetmap.gui.jmapviewer.interfaces.Attributed

getAttributionImage, getAttributionImageURL, getAttributionLinkURL, getAttributionText, getTermsOfUseText, getTermsOfUseURL, requiresAttribution

Field Detail

PATTERN_HEADER

private static final String PATTERN_HEADER

See Also:

Constant Field Values

URL_GET_ENCODING_PARAMS

private static final String URL_GET_ENCODING_PARAMS

See Also:

Constant Field Values

ALL_PATTERNS

private static final String[] ALL_PATTERNS

OWS_NS_URL

private static final String OWS_NS_URL

See Also:

Constant Field Values

WMTS_NS_URL

private static final String WMTS_NS_URL

See Also:

Constant Field Values

XLINK_NS_URL

private static final String XLINK_NS_URL

See Also:

Constant Field Values

headers

private final Map<String,String> headers

layers

private Collection<WMTSTileSource.Layer> layers

currentLayer

private WMTSTileSource.Layer currentLayer

currentTileMatrixSet

private WMTSTileSource.TileMatrixSet currentTileMatrixSet

crsScale

private double crsScale

transferMode

private WMTSTileSource.TransferMode transferMode

Constructor Detail

WMTSTileSource

public WMTSTileSource(ImageryInfo info)
               throws IOException

Creates a tile source based on imagery info

Parameters:

info - imagery info

Throws:

IOException - if any I/O error occurs

Method Detail

userSelectLayer

private WMTSTileSource.Layer userSelectLayer(Collection<WMTSTileSource.Layer> layers)

handleTemplate

private String handleTemplate(String url)

getCapabilities

private Collection<WMTSTileSource.Layer> getCapabilities()
                                                  throws IOException

Throws:

IOException

parseContents

private static Collection<WMTSTileSource.Layer> parseContents(XMLStreamReader reader)
                                                       throws XMLStreamException

Parse Contents tag. Renturns when reader reaches Contents closing tag

Parameters:

reader - StAX reader instance

Returns:

collection of layers within contents with properly linked TileMatrixSets

Throws:

XMLStreamException - See XMLStreamReader

parseLayer

private static WMTSTileSource.Layer parseLayer(XMLStreamReader reader)
                                        throws XMLStreamException

Parse Layer tag. Returns when reader will reach Layer closing tag

Parameters:

reader - StAX reader instance

Returns:

Layer object, with tileMatrixSetLinks and no tileMatrixSet attribute set.

Throws:

XMLStreamException - See XMLStreamReader

praseTileMatrixSetLink

private static String praseTileMatrixSetLink(XMLStreamReader reader)
                                      throws XMLStreamException

Gets TileMatrixSetLink value. Returns when reader is on TileMatrixSetLink closing tag

Parameters:

reader - StAX reader instance

Returns:

TileMatrixSetLink identifier

Throws:

XMLStreamException - See XMLStreamReader

parseTileMatrixSet

private static WMTSTileSource.TileMatrixSet parseTileMatrixSet(XMLStreamReader reader)
                                                        throws XMLStreamException

Parses TileMatrixSet section. Returns when reader is on TileMatrixSet closing tag

Parameters:

reader - StAX reader instance

Returns:

TileMatrixSet object

Throws:

XMLStreamException - See XMLStreamReader

parseTileMatrix

private static WMTSTileSource.TileMatrix parseTileMatrix(XMLStreamReader reader,
                                                         String matrixCrs)
                                                  throws XMLStreamException

Parses TileMatrix section. Returns when reader is on TileMatrix closing tag.

Parameters:

reader - StAX reader instance

matrixCrs - projection used by this matrix

Returns:

TileMatrix object

Throws:

XMLStreamException - See XMLStreamReader

parseOperationMetadata

private void parseOperationMetadata(XMLStreamReader reader)
                             throws XMLStreamException

Parses OperationMetadata section. Returns when reader is on OperationsMetadata closing tag. Sets this.baseUrl and this.transferMode

Parameters:

reader - StAX reader instance

Throws:

XMLStreamException - See XMLStreamReader

getTransferMode

private static WMTSTileSource.TransferMode getTransferMode(XMLStreamReader reader)
                                                    throws XMLStreamException

Parses Operation[@name='GetTile']/DCP/HTTP/Get section. Returns when reader is on Get closing tag.

Parameters:

reader - StAX reader instance

Returns:

TransferMode coded in this section

Throws:

XMLStreamException - See XMLStreamReader

moveReaderToTag

private static boolean moveReaderToTag(XMLStreamReader reader,
                                       QName[] tags)
                                throws XMLStreamException

Moves reader to first occurrence of the structure equivalent of Xpath tags[0]/tags[1]../tags[n]. If fails to find moves the reader to the closing tag of current tag

Parameters:

reader - StAX reader instance

tags - array of tags

Returns:

true if tag was found, false otherwise

Throws:

XMLStreamException - See XMLStreamReader

normalizeCapabilitiesUrl

private static String normalizeCapabilitiesUrl(String url)
                                        throws MalformedURLException

Throws:

MalformedURLException

crsToCode

private static String crsToCode(String crsIdentifier)

initProjection

public void initProjection(Projection proj)

Initializes projection for this TileSource with projection

Parameters:

proj - projection to be used by this TileSource

getLayers

private Collection<WMTSTileSource.Layer> getLayers(String name,
                                                   String projectionCode)

getDefaultTileSize

public int getDefaultTileSize()

Specified by:

getDefaultTileSize in interface TileSource

Overrides:

getDefaultTileSize in class AbstractTMSTileSource

Returns:

default tile size to use, when not set in Imagery Preferences

getTileSize

public int getTileSize()

Description copied from interface: TileSource

Specifies how large each tile is.

Specified by:

getTileSize in interface TileSource

Overrides:

getTileSize in class AbstractTMSTileSource

Returns:

The size of a single tile in pixels. -1 if default size should be used

getTileUrl

public String getTileUrl(int zoom,
                         int tilex,
                         int tiley)

Description copied from interface: TileSource

Constructs the tile url.

Specified by:

getTileUrl in interface TileSource

Overrides:

getTileUrl in class AbstractTMSTileSource

Parameters:

zoom - zoom level

tilex - X coordinate

tiley - Y coordinate

Returns:

fully qualified url for downloading the specified tile image

getTileMatrix

private WMTSTileSource.TileMatrix getTileMatrix(int zoom)

Parameters:

zoom - zoom level

Returns:

TileMatrix that's working on this zoom level

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.

Specified by:

getDistance in interface TileSource

Overrides:

getDistance in class AbstractTMSTileSource

Parameters:

lat1 - latitude of first point

lon1 - longitude of first point

lat2 - latitude of second point

lon2 - longitude of second point

Returns:

the distance betwen first and second point, in m.

tileXYToLatLon

public ICoordinate tileXYToLatLon(Tile tile)

Specified by:

tileXYToLatLon in interface TileSource

Overrides:

tileXYToLatLon in class AbstractTMSTileSource

Parameters:

tile - Tile

Returns:

WGS84 coordinates of given tile

tileXYToLatLon

public ICoordinate tileXYToLatLon(TileXY xy,
                                  int zoom)

Specified by:

tileXYToLatLon in interface TileSource

Overrides:

tileXYToLatLon in class AbstractTMSTileSource

Parameters:

xy - X/Y coordinates

zoom - zoom level

Returns:

WGS84 coordinates of given tile

tileXYToLatLon

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

Specified by:

tileXYToLatLon in interface TileSource

Overrides:

tileXYToLatLon in class AbstractTMSTileSource

Parameters:

x - X coordinate

y - Y coordinate

zoom - zoom level

Returns:

WGS84 coordinates of given tile

latLonToTileXY

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

Specified by:

latLonToTileXY in interface TileSource

Overrides:

latLonToTileXY in class AbstractTMSTileSource

Parameters:

lat - latitude

lon - longitude

zoom - zoom level

Returns:

x and y tile indices

latLonToTileXY

public TileXY latLonToTileXY(ICoordinate point,
                             int zoom)

Specified by:

latLonToTileXY in interface TileSource

Overrides:

latLonToTileXY in class AbstractTMSTileSource

Parameters:

point - point

zoom - zoom level

Returns:

x and y tile indices

getTileXMax

public int getTileXMax(int zoom)

Specified by:

getTileXMax in interface TileSource

Overrides:

getTileXMax in class AbstractTMSTileSource

Parameters:

zoom - zoom level

Returns:

maximum X index of tile for specified zoom level

getTileXMin

public int getTileXMin(int zoom)

Specified by:

getTileXMin in interface TileSource

Overrides:

getTileXMin in class AbstractTMSTileSource

Parameters:

zoom - zoom level

Returns:

minimum X index of tile for specified zoom level

getTileYMax

public int getTileYMax(int zoom)

Specified by:

getTileYMax in interface TileSource

Overrides:

getTileYMax in class AbstractTMSTileSource

Parameters:

zoom - zoom level

Returns:

maximum Y index of tile for specified zoom level

getTileYMin

public int getTileYMin(int zoom)

Specified by:

getTileYMin in interface TileSource

Overrides:

getTileYMin in class AbstractTMSTileSource

Parameters:

zoom - zoom level

Returns:

minimum Y index of tile for specified zoom level

latLonToXY

public Point latLonToXY(double lat,
                        double lon,
                        int zoom)

Specified by:

latLonToXY in interface TileSource

Overrides:

latLonToXY in class AbstractTMSTileSource

Parameters:

lat - latitude

lon - longitude

zoom - zoom level

Returns:

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

latLonToXY

public Point latLonToXY(ICoordinate point,
                        int zoom)

Specified by:

latLonToXY in interface TileSource

Overrides:

latLonToXY in class AbstractTMSTileSource

Parameters:

point - point

zoom - zoom level

Returns:

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

xyToLatLon

public Coordinate xyToLatLon(Point point,
                             int zoom)

Specified by:

xyToLatLon in interface TileSource

Overrides:

xyToLatLon in class AbstractTMSTileSource

Parameters:

point - point

zoom - zoom level

Returns:

WGS84 Coordinates of given point

xyToLatLon

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

Specified by:

xyToLatLon in interface TileSource

Overrides:

xyToLatLon in class AbstractTMSTileSource

Parameters:

x - X coordinate

y - Y coordinate

zoom - zoom level

Returns:

WGS84 Coordinates of given point

getHeaders

public Map<String,String> getHeaders()

Specified by:

getHeaders in interface TemplatedTileSource

Returns:

headers to be sent with http requests

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 TMSTileSource

Returns:

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

getTileId

public String getTileId(int zoom,
                        int tilex,
                        int tiley)

Description copied from interface: TileSource

Creates tile identifier that is unique among all tile sources, but the same tile will always get the same identifier. Used for creation of cache key.

Specified by:

getTileId in interface TileSource

Overrides:

getTileId in class AbstractTMSTileSource

Parameters:

zoom - zoom level

tilex - X coordinate

tiley - Y coordinate

Returns:

tile identifier

checkUrl

public static void checkUrl(String url)

Checks if url is acceptable by this Tile Source

Parameters:

url - URL to check

getSupportedProjections

public Set<String> getSupportedProjections()

Returns:

set of projection codes that this TileSource supports

getTileYMax

private int getTileYMax(int zoom,
                        Projection proj)

getTileXMax

private int getTileXMax(int zoom,
                        Projection proj)