WMTSTileSource (JOSM)

java.lang.Object
- org.openstreetmap.gui.jmapviewer.tilesources.AbstractTileSource
- - org.openstreetmap.gui.jmapviewer.tilesources.AbstractTMSTileSource
  - - org.openstreetmap.josm.data.imagery.WMTSTileSource

All Implemented Interfaces:

Attributed, TemplatedTileSource, TileSource
```
public class WMTSTileSource
extends AbstractTMSTileSource
implements TemplatedTileSource
```
Tile Source handling WMTS providers

Since:

8526

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`private static class`	`WMTSTileSource.Dimension`
`static class`	`WMTSTileSource.Layer` Class representing WMTS Layer information
`private static class`	`WMTSTileSource.SelectLayerDialog`
`private static class`	`WMTSTileSource.TileMatrix`
`static class`	`WMTSTileSource.TileMatrixSet` class representing WMTS TileMatrixSet This connects projection and TileMatrix (how the map is divided in tiles)
`private static class`	`WMTSTileSource.TileMatrixSetBuilder`
`static class`	`WMTSTileSource.WMTSGetCapabilitiesException` Exception thrown when parser doesn't find expected information in GetCapabilities document

Field Summary

Fields
Modifier and Type	Field and Description
`private static java.lang.String[]`	`ALL_PATTERNS`
`private int`	`cachedTileSize`
`private double`	`crsScale`
`private WMTSTileSource.Layer`	`currentLayer`
`private WMTSTileSource.TileMatrixSet`	`currentTileMatrixSet`
`private DefaultLayer`	`defaultLayer`
`private java.util.Map<java.lang.String,java.lang.String>`	`headers`
`private java.util.Collection<WMTSTileSource.Layer>`	`layers`
`private NativeScaleLayer.ScaleList`	`nativeScaleList`
`private static java.lang.String`	`PATTERN_HEADER`
`private static javax.xml.namespace.QName`	`QN_CONTENTS`
`private static javax.xml.namespace.QName`	`QN_DEFAULT`
`private static javax.xml.namespace.QName`	`QN_DIMENSION`
`private static javax.xml.namespace.QName`	`QN_FORMAT`
`private static javax.xml.namespace.QName`	`QN_LAYER`
`private static javax.xml.namespace.QName`	`QN_MATRIX_HEIGHT`
`private static javax.xml.namespace.QName`	`QN_MATRIX_WIDTH`
`private static javax.xml.namespace.QName`	`QN_RESOURCE_URL`
`private static javax.xml.namespace.QName`	`QN_SCALE_DENOMINATOR`
`private static javax.xml.namespace.QName`	`QN_STYLE`
`private static javax.xml.namespace.QName`	`QN_TILE_HEIGHT`
`private static javax.xml.namespace.QName`	`QN_TILE_WIDTH`
`private static javax.xml.namespace.QName`	`QN_TILEMATRIX`
`private static javax.xml.namespace.QName`	`QN_TILEMATRIX_SET_LINK`
`private static javax.xml.namespace.QName`	`QN_TILEMATRIXSET`
`private static javax.xml.namespace.QName`	`QN_TOPLEFT_CORNER`
`private static javax.xml.namespace.QName`	`QN_VALUE`
`private Projection`	`tileProjection`
`private GetCapabilitiesParseHelper.TransferMode`	`transferMode`
`private static java.lang.String`	`URL_GET_ENCODING_PARAMS`
`static java.lang.String`	`WMTS_NS_URL` WMTS namespace address

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
`WMTSTileSource(ImageryInfo info)` Creates a tile source based on imagery info
`WMTSTileSource(ImageryInfo info, Projection projection)` Creates a tile source based on imagery info and initializes it with given projection.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`checkUrl(java.lang.String url)` Checks if url is acceptable by this Tile Source
`static WMTSCapabilities`	`getCapabilities(java.lang.String url, java.util.Map<java.lang.String,java.lang.String> headers)` Call remote server and parse response to WMTSCapabilities object
`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.
`java.util.Map<java.lang.String,java.lang.String>`	`getHeaders()`
`java.util.Collection<WMTSTileSource.Layer>`	`getLayers()` Layers that can be used with this tile source
`int`	`getMaxZoom()` Specifies the maximum zoom value.
`NativeScaleLayer.ScaleList`	`getNativeScales()` Get native scales of tile source.
`java.lang.String`	`getServerCRS()` Get coordinate reference system for this tile source.
`java.util.Collection<java.lang.String>`	`getSupportedProjections()`
`java.lang.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)`
`Projection`	`getTileProjection()` Returns the tile projection.
`private ProjectionBounds`	`getTileProjectionBounds(Tile tile)`
`int`	`getTileSize()` Specifies how large each tile is.
`java.lang.String`	`getTileUrl(int zoom, int tilex, int tiley)` Constructs the tile url.
`int`	`getTileXMax(int zoom)` Get maximum x index of tile for specified zoom level.
`private int`	`getTileXMax(int zoom, Projection proj)`
`int`	`getTileYMax(int zoom)` Get maximum y index of tile for specified zoom level.
`private int`	`getTileYMax(int zoom, Projection proj)`
`static java.util.List<java.util.Map.Entry<java.lang.String,java.util.List<WMTSTileSource.Layer>>>`	`groupLayersByNameAndTileMatrixSet(java.util.Collection<WMTSTileSource.Layer> layers)`
`private java.lang.String`	`handleTemplate(java.lang.String url)`
`void`	`initProjection(Projection proj)` Initializes projection for this TileSource with projection
`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.
`TileXY`	`latLonToTileXY(ICoordinate point, 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).
`java.awt.Point`	`latLonToXY(ICoordinate point, int zoom)` Transforms longitude and latitude to pixel space (as if all tiles at specified zoom level where joined).
`private static BBox`	`parseBoundingBox(javax.xml.stream.XMLStreamReader reader)` Parses WGS84BoundingBox section.
`private static java.util.Collection<WMTSTileSource.Layer>`	`parseContents(javax.xml.stream.XMLStreamReader reader)` Parse Contents tag.
`private static <T> T`	`parseCoor(java.lang.String coor, boolean switchXY, java.util.function.BiFunction<java.lang.String,java.lang.String,T> function)`
`private static WMTSTileSource.Dimension`	`parseDimension(javax.xml.stream.XMLStreamReader reader)` Gets Dimension value.
`private static EastNorth`	`parseEastNorth(java.lang.String coor, boolean switchXY)`
`private static LatLon`	`parseLatLon(java.lang.String coor, boolean switchXY)`
`private static WMTSTileSource.Layer`	`parseLayer(javax.xml.stream.XMLStreamReader reader)` Parse Layer tag.
`private static WMTSCapabilities`	`parseOperationMetadata(javax.xml.stream.XMLStreamReader reader)` Parses OperationMetadata section.
`private static WMTSTileSource.TileMatrix`	`parseTileMatrix(javax.xml.stream.XMLStreamReader reader, java.lang.String matrixCrs)` Parses TileMatrix section.
`private static WMTSTileSource.TileMatrixSet`	`parseTileMatrixSet(javax.xml.stream.XMLStreamReader reader)` Parses TileMatrixSet section.
`private static java.lang.String`	`parseTileMatrixSetLink(javax.xml.stream.XMLStreamReader reader)` Gets TileMatrixSetLink value.
`TileXY`	`projectedToTileXY(IProjected projected, int zoom)` Convert projected coordinates to tile indices.
`private EastNorth`	`tileToEastNorth(int x, int y, int z)`
`ICoordinate`	`tileXYToLatLon(int x, int y, int zoom)` Transforms tile indices to longitude and latitude.
`ICoordinate`	`tileXYToLatLon(Tile tile)` Determines to longitude and latitude of a tile.
`ICoordinate`	`tileXYToLatLon(TileXY xy, 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.
`DefaultLayer`	`userSelectLayer()` Creates a dialog based on this tile source with all available layers and returns the name of selected layer
`Coordinate`	`xyToLatLon(int x, int y, int zoom)` Transforms a point in pixel space to longitude/latitude (WGS84).
`Coordinate`	`xyToLatLon(java.awt.Point point, 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, getMinZoom, getName, getTilePath, getTileXMin, getTileYMin, isModTileFeatures, 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
getDefaultTileSize, getId, getMetadata, getMinZoom, getName, getTileXMin, getTileYMin, isModTileFeatures, isNoTileAtZoom

Methods inherited from interface org.openstreetmap.gui.jmapviewer.interfaces.Attributed
getAttributionImage, getAttributionImageURL, getAttributionLinkURL, getAttributionText, getTermsOfUseText, getTermsOfUseURL, requiresAttribution

- Field Detail
  - WMTS_NS_URL
```
public static final java.lang.String WMTS_NS_URL
```
    WMTS namespace address
    
    See Also:
    
    Constant Field Values
  - QN_CONTENTS
```
private static final javax.xml.namespace.QName QN_CONTENTS
```
  - QN_DEFAULT
```
private static final javax.xml.namespace.QName QN_DEFAULT
```
  - QN_DIMENSION
```
private static final javax.xml.namespace.QName QN_DIMENSION
```
  - QN_FORMAT
```
private static final javax.xml.namespace.QName QN_FORMAT
```
  - QN_LAYER
```
private static final javax.xml.namespace.QName QN_LAYER
```
  - QN_MATRIX_WIDTH
```
private static final javax.xml.namespace.QName QN_MATRIX_WIDTH
```
  - QN_MATRIX_HEIGHT
```
private static final javax.xml.namespace.QName QN_MATRIX_HEIGHT
```
  - QN_RESOURCE_URL
```
private static final javax.xml.namespace.QName QN_RESOURCE_URL
```
  - QN_SCALE_DENOMINATOR
```
private static final javax.xml.namespace.QName QN_SCALE_DENOMINATOR
```
  - QN_STYLE
```
private static final javax.xml.namespace.QName QN_STYLE
```
  - QN_TILEMATRIX
```
private static final javax.xml.namespace.QName QN_TILEMATRIX
```
  - QN_TILEMATRIXSET
```
private static final javax.xml.namespace.QName QN_TILEMATRIXSET
```
  - QN_TILEMATRIX_SET_LINK
```
private static final javax.xml.namespace.QName QN_TILEMATRIX_SET_LINK
```
  - QN_TILE_WIDTH
```
private static final javax.xml.namespace.QName QN_TILE_WIDTH
```
  - QN_TILE_HEIGHT
```
private static final javax.xml.namespace.QName QN_TILE_HEIGHT
```
  - QN_TOPLEFT_CORNER
```
private static final javax.xml.namespace.QName QN_TOPLEFT_CORNER
```
  - QN_VALUE
```
private static final javax.xml.namespace.QName QN_VALUE
```
  - PATTERN_HEADER
```
private static final java.lang.String PATTERN_HEADER
```
    See Also:
    
    Constant Field Values
  - URL_GET_ENCODING_PARAMS
```
private static final java.lang.String URL_GET_ENCODING_PARAMS
```
    See Also:
    
    Constant Field Values
  - ALL_PATTERNS
```
private static final java.lang.String[] ALL_PATTERNS
```
  - cachedTileSize
```
private int cachedTileSize
```
  - headers
```
private final java.util.Map<java.lang.String,java.lang.String> headers
```
  - layers
```
private final java.util.Collection<WMTSTileSource.Layer> layers
```
  - currentLayer
```
private WMTSTileSource.Layer currentLayer
```
  - currentTileMatrixSet
```
private WMTSTileSource.TileMatrixSet currentTileMatrixSet
```
  - crsScale
```
private double crsScale
```
  - transferMode
```
private final GetCapabilitiesParseHelper.TransferMode transferMode
```
  - nativeScaleList
```
private NativeScaleLayer.ScaleList nativeScaleList
```
  - defaultLayer
```
private final DefaultLayer defaultLayer
```
  - tileProjection
```
private Projection tileProjection
```
- Constructor Detail
  - WMTSTileSource
```
public WMTSTileSource(ImageryInfo info)
               throws java.io.IOException,
                      WMTSTileSource.WMTSGetCapabilitiesException
```
    Creates a tile source based on imagery info
    
    Parameters:
    
    info - imagery info
    
    Throws:
    
    java.io.IOException - if any I/O error occurs
    
    WMTSTileSource.WMTSGetCapabilitiesException - when document didn't contain any layers
    
    java.lang.IllegalArgumentException - if any other error happens for the given imagery info
  - WMTSTileSource
```
public WMTSTileSource(ImageryInfo info,
                      Projection projection)
               throws java.io.IOException,
                      WMTSTileSource.WMTSGetCapabilitiesException
```
    Creates a tile source based on imagery info and initializes it with given projection.
    
    Parameters:
    
    info - imagery info
    
    projection - projection to be used by this TileSource
    
    Throws:
    
    java.io.IOException - if any I/O error occurs
    
    WMTSTileSource.WMTSGetCapabilitiesException - when document didn't contain any layers
    
    java.lang.IllegalArgumentException - if any other error happens for the given imagery info
    
    Since:
    
    14507
- Method Detail
  - userSelectLayer
```
public DefaultLayer userSelectLayer()
```
    Creates a dialog based on this tile source with all available layers and returns the name of selected layer
    
    Returns:
    
    Name of selected layer
  - handleTemplate
```
private java.lang.String handleTemplate(java.lang.String url)
```
  - getCapabilities
```
public static WMTSCapabilities getCapabilities(java.lang.String url,
                                               java.util.Map<java.lang.String,java.lang.String> headers)
                                        throws java.io.IOException,
                                               WMTSTileSource.WMTSGetCapabilitiesException
```
    Call remote server and parse response to WMTSCapabilities object
    
    Parameters:
    
    url - of the getCapabilities document
    
    headers - HTTP headers to set when calling getCapabilities url
    
    Returns:
    
    capabilities
    
    Throws:
    
    java.io.IOException - in case of any I/O error
    
    WMTSTileSource.WMTSGetCapabilitiesException - when document didn't contain any layers
    
    java.lang.IllegalArgumentException - in case of any other error
  - parseContents
```
private static java.util.Collection<WMTSTileSource.Layer> parseContents(javax.xml.stream.XMLStreamReader reader)
                                                                 throws javax.xml.stream.XMLStreamException
```
    Parse Contents tag. Returns when reader reaches Contents closing tag
    
    Parameters:
    
    reader - StAX reader instance
    
    Returns:
    
    collection of layers within contents with properly linked TileMatrixSets
    
    Throws:
    
    javax.xml.stream.XMLStreamException - See XMLStreamReader
  - parseLayer
```
private static WMTSTileSource.Layer parseLayer(javax.xml.stream.XMLStreamReader reader)
                                        throws javax.xml.stream.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:
    
    javax.xml.stream.XMLStreamException - See XMLStreamReader
  - parseDimension
```
private static WMTSTileSource.Dimension parseDimension(javax.xml.stream.XMLStreamReader reader)
                                                throws javax.xml.stream.XMLStreamException
```
    Gets Dimension value. Returns when reader is on Dimension closing tag
    
    Parameters:
    
    reader - StAX reader instance
    
    Returns:
    
    dimension
    
    Throws:
    
    javax.xml.stream.XMLStreamException - See XMLStreamReader
  - parseTileMatrixSetLink
```
private static java.lang.String parseTileMatrixSetLink(javax.xml.stream.XMLStreamReader reader)
                                                throws javax.xml.stream.XMLStreamException
```
    Gets TileMatrixSetLink value. Returns when reader is on TileMatrixSetLink closing tag
    
    Parameters:
    
    reader - StAX reader instance
    
    Returns:
    
    TileMatrixSetLink identifier
    
    Throws:
    
    javax.xml.stream.XMLStreamException - See XMLStreamReader
  - parseTileMatrixSet
```
private static WMTSTileSource.TileMatrixSet parseTileMatrixSet(javax.xml.stream.XMLStreamReader reader)
                                                        throws javax.xml.stream.XMLStreamException
```
    Parses TileMatrixSet section. Returns when reader is on TileMatrixSet closing tag
    
    Parameters:
    
    reader - StAX reader instance
    
    Returns:
    
    TileMatrixSet object
    
    Throws:
    
    javax.xml.stream.XMLStreamException - See XMLStreamReader
  - parseTileMatrix
```
private static WMTSTileSource.TileMatrix parseTileMatrix(javax.xml.stream.XMLStreamReader reader,
                                                         java.lang.String matrixCrs)
                                                  throws javax.xml.stream.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:
    
    javax.xml.stream.XMLStreamException - See XMLStreamReader
  - parseCoor
```
private static <T> T parseCoor(java.lang.String coor,
                               boolean switchXY,
                               java.util.function.BiFunction<java.lang.String,java.lang.String,T> function)
```
  - parseEastNorth
```
private static EastNorth parseEastNorth(java.lang.String coor,
                                        boolean switchXY)
```
  - parseLatLon
```
private static LatLon parseLatLon(java.lang.String coor,
                                  boolean switchXY)
```
  - parseBoundingBox
```
private static BBox parseBoundingBox(javax.xml.stream.XMLStreamReader reader)
                              throws javax.xml.stream.XMLStreamException
```
    Parses WGS84BoundingBox section. Returns when reader is on WGS84BoundingBox closing tag.
    
    Parameters:
    
    reader - StAX reader instance
    
    Returns:
    
    WGS84 bounding box
    
    Throws:
    
    javax.xml.stream.XMLStreamException - See XMLStreamReader
  - parseOperationMetadata
```
private static WMTSCapabilities parseOperationMetadata(javax.xml.stream.XMLStreamReader reader)
                                                throws javax.xml.stream.XMLStreamException
```
    Parses OperationMetadata section. Returns when reader is on OperationsMetadata closing tag. return WMTSCapabilities with baseUrl and transferMode
    
    Parameters:
    
    reader - StAX reader instance
    
    Returns:
    
    WMTSCapabilities with baseUrl and transferMode set
    
    Throws:
    
    javax.xml.stream.XMLStreamException - See XMLStreamReader
  - initProjection
```
public void initProjection(Projection proj)
```
    Initializes projection for this TileSource with projection
    
    Parameters:
    
    proj - projection to be used by this TileSource
  - 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 java.lang.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
    
    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.
  - tileXYToLatLon
```
public ICoordinate tileXYToLatLon(Tile tile)
```
    Description copied from interface: TileSource
    
    Determines to longitude and latitude of a tile. (Refers to the tile origin - upper left tile corner)
    
    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)
```
    Description copied from interface: TileSource
    
    Transforms tile indices to longitude and latitude.
    
    Specified by:
    
    tileXYToLatLon in interface TileSource
    
    Overrides:
    
    tileXYToLatLon in class AbstractTMSTileSource
    
    Parameters:
    
    xy - X/Y tile indices
    
    zoom - zoom level
    
    Returns:
    
    WGS84 coordinates of given tile
  - tileXYToLatLon
```
public ICoordinate tileXYToLatLon(int x,
                                  int y,
                                  int zoom)
```
    Description copied from interface: TileSource
    
    Transforms tile indices to longitude and latitude.
    
    Specified by:
    
    tileXYToLatLon in interface TileSource
    
    Parameters:
    
    x - x tile index
    
    y - y tile index
    
    zoom - zoom level
    
    Returns:
    
    WGS84 coordinates of given tile
  - latLonToTileXY
```
public TileXY latLonToTileXY(double lat,
                             double lon,
                             int zoom)
```
    Description copied from interface: TileSource
    
    Transforms longitude and latitude to tile indices.
    
    Specified by:
    
    latLonToTileXY in interface TileSource
    
    Parameters:
    
    lat - latitude
    
    lon - longitude
    
    zoom - zoom level
    
    Returns:
    
    x and y tile indices
  - latLonToTileXY
```
public TileXY latLonToTileXY(ICoordinate point,
                             int zoom)
```
    Description copied from interface: TileSource
    
    Transforms longitude and latitude to tile indices.
    
    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)
```
    Description copied from interface: TileSource
    
    Get maximum x index of tile for specified zoom level.
    
    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
  - getTileYMax
```
public int getTileYMax(int zoom)
```
    Description copied from interface: TileSource
    
    Get maximum y index of tile for specified zoom level.
    
    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
  - 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).
    
    Specified by:
    
    latLonToXY in interface TileSource
    
    Parameters:
    
    lat - latitude
    
    lon - longitude
    
    zoom - zoom level
    
    Returns:
    
    the pixel coordinates
  - latLonToXY
```
public java.awt.Point latLonToXY(ICoordinate point,
                                 int zoom)
```
    Description copied from interface: TileSource
    
    Transforms longitude and latitude to pixel space (as if all tiles at specified zoom level where joined).
    
    Specified by:
    
    latLonToXY in interface TileSource
    
    Overrides:
    
    latLonToXY in class AbstractTMSTileSource
    
    Parameters:
    
    point - point
    
    zoom - zoom level
    
    Returns:
    
    the pixel coordinates
  - xyToLatLon
```
public Coordinate xyToLatLon(java.awt.Point point,
                             int zoom)
```
    Description copied from interface: TileSource
    
    Transforms a point in pixel space to longitude/latitude (WGS84).
    
    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)
```
    Description copied from interface: TileSource
    
    Transforms a point in pixel space to longitude/latitude (WGS84).
    
    Specified by:
    
    xyToLatLon in interface TileSource
    
    Parameters:
    
    x - X coordinate
    
    y - Y coordinate
    
    zoom - zoom level
    
    Returns:
    
    WGS84 Coordinates of given point
  - getHeaders
```
public java.util.Map<java.lang.String,java.lang.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 AbstractTMSTileSource
    
    Returns:
    
    maximum zoom value that has to be smaller or equal to JMapViewer.MAX_ZOOM
  - getTileId
```
public java.lang.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(java.lang.String url)
```
    Checks if url is acceptable by this Tile Source
    
    Parameters:
    
    url - URL to check
  - groupLayersByNameAndTileMatrixSet
```
public static java.util.List<java.util.Map.Entry<java.lang.String,java.util.List<WMTSTileSource.Layer>>> groupLayersByNameAndTileMatrixSet(java.util.Collection<WMTSTileSource.Layer> layers)
```
    Parameters:
    
    layers - to be grouped
    
    Returns:
    
    list with entries - grouping identifier + list of layers
  - getSupportedProjections
```
public java.util.Collection<java.lang.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)
```
  - getNativeScales
```
public NativeScaleLayer.ScaleList getNativeScales()
```
    Get native scales of tile source.
    
    Returns:
    
    NativeScaleLayer.ScaleList of native scales
  - getTileProjection
```
public Projection getTileProjection()
```
    Returns the tile projection.
    
    Returns:
    
    the tile projection
  - 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.
    
    Specified by:
    
    tileXYtoProjected in interface TileSource
    
    Parameters:
    
    x - x tile index
    
    y - z tile index
    
    zoom - zoom level
    
    Returns:
    
    projected coordinates of the tile origin
  - projectedToTileXY
```
public TileXY projectedToTileXY(IProjected projected,
                                int zoom)
```
    Description copied from interface: TileSource
    
    Convert projected coordinates to tile indices.
    
    Specified by:
    
    projectedToTileXY in interface TileSource
    
    Parameters:
    
    projected - projected coordinates
    
    zoom - zoom level
    
    Returns:
    
    corresponding tile index x/y (floating point, truncate to integer for tile index)
  - tileToEastNorth
```
private EastNorth tileToEastNorth(int x,
                                  int y,
                                  int z)
```
  - getTileProjectionBounds
```
private ProjectionBounds getTileProjectionBounds(Tile tile)
```
  - isInside
```
public boolean isInside(Tile inner,
                        Tile outer)
```
    Description copied from interface: TileSource
    
    Check if one tile is inside another tile.
    
    Specified by:
    
    isInside in interface TileSource
    
    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.
    
    Specified by:
    
    getCoveringTileRange in interface TileSource
    
    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.
    
    Specified by:
    
    getServerCRS in interface TileSource
    
    Returns:
    
    code for the coordinate reference system in use
  - getLayers
```
public java.util.Collection<WMTSTileSource.Layer> getLayers()
```
    Layers that can be used with this tile source
    
    Returns:
    
    unmodifiable collection of layers available in this tile source
    
    Since:
    
    13879

Class WMTSTileSource

Nested Class Summary

Field Summary

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

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

Constructor Summary

Method Summary

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

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

Methods inherited from class java.lang.Object

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

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

Field Detail

WMTS_NS_URL

QN_CONTENTS

QN_DEFAULT

QN_DIMENSION

QN_FORMAT

QN_LAYER

QN_MATRIX_WIDTH

QN_MATRIX_HEIGHT

QN_RESOURCE_URL

QN_SCALE_DENOMINATOR

QN_STYLE

QN_TILEMATRIX

QN_TILEMATRIXSET

QN_TILEMATRIX_SET_LINK

QN_TILE_WIDTH

QN_TILE_HEIGHT

QN_TOPLEFT_CORNER

QN_VALUE

PATTERN_HEADER

URL_GET_ENCODING_PARAMS

ALL_PATTERNS

cachedTileSize

headers

layers

currentLayer

currentTileMatrixSet

crsScale

transferMode

nativeScaleList

defaultLayer

tileProjection

Constructor Detail

WMTSTileSource

WMTSTileSource

Method Detail

userSelectLayer

handleTemplate

getCapabilities

parseContents

parseLayer

parseDimension

parseTileMatrixSetLink

parseTileMatrixSet

parseTileMatrix

parseCoor

parseEastNorth

parseLatLon

parseBoundingBox

parseOperationMetadata

initProjection

getTileSize

getTileUrl

getTileMatrix

getDistance

tileXYToLatLon

tileXYToLatLon

tileXYToLatLon

latLonToTileXY

latLonToTileXY

getTileXMax

getTileYMax

latLonToXY

latLonToXY

xyToLatLon

xyToLatLon

getHeaders

getMaxZoom