Package org.apache.sis.storage.tiling
Interface TileMatrixSet
- All Known Subinterfaces:
WritableTileMatrixSet
public interface TileMatrixSet
A collection of
TileMatrix in the same CRS but at different scale levels.
Each TileMatrix is optimized for a particular scale and is identified by a tile matrix identifier.
Tile matrices usually have 2 dimensions (width and height), but this API allows any number of dimensions.
However, the number of dimensions must be the same for all tile matrices.
The TileMatrixSet concept is derived from OGC standards. The same concept is called
image pyramid or resolution levels in some other standards.
Some standards require that all scales must be related by a power of 2,
but TileMatrixSet does not have this restriction.
Tile matrix identification
EachTileMatrix in a TileMatrixSet is identified by a GenericName.
Identifiers can be any character strings.
A common practice is to use zoom levels as identifiers, but this is not mandatory.
However, tile matrices must be sorted from coarser resolution (highest scale denominator)
to most detailed resolution (lowest scale denominator).
All methods in this interface return non-null values.
- Since:
- 1.2
Defined in the sis-storage module
-
Method Summary
Modifier and TypeMethodDescriptionReturns the coordinate reference system of allTileMatrixinstances in this set.Returns an envelope that encompasses allTileMatrixinstances in this set.Returns an alphanumeric identifier which is unique in theTiledResourcethat contains thisTileMatrixSet.SortedMap<GenericName,? extends TileMatrix> Returns allTileMatrixinstances in this set, together with their identifiers.
-
Method Details
-
getIdentifier
GenericName getIdentifier()Returns an alphanumeric identifier which is unique in theTiledResourcethat contains thisTileMatrixSet. A tiled resource may contains more than one tile matrix set if the resource prepared different set of tiles for different CRS.- Returns:
- a unique (within
TiledResource) identifier.
-
getCoordinateReferenceSystem
CoordinateReferenceSystem getCoordinateReferenceSystem()Returns the coordinate reference system of allTileMatrixinstances in this set. This is the value returned byTileMatrix.getTilingScheme().getCoordinateReferenceSystem().- Returns:
- the CRS used by all
TileMatrixinstances in this set. - See Also:
-
getEnvelope
Returns an envelope that encompasses allTileMatrixinstances in this set. This is the union of all values returned byTileMatrix.getTilingScheme().getEnvelope(). May be empty if too costly to compute.- Returns:
- the bounding box for all tile matrices in CRS coordinates, if available.
-
getTileMatrices
SortedMap<GenericName,? extends TileMatrix> getTileMatrices()Returns allTileMatrixinstances in this set, together with their identifiers. For each value in the map, the associated key isTileMatrix.getIdentifier(). Entries are sorted from coarser resolution (highest scale denominator) to most detailed resolution (lowest scale denominator).- Returns:
- unmodifiable collection of all
TileMatrixinstances with their identifiers.
-