/** * @module ol/tilegrid/WMTS */ import {inherits} from '../index.js'; import {find} from '../array.js'; import {get as getProjection} from '../proj.js'; import TileGrid from '../tilegrid/TileGrid.js'; /** * @typedef {Object} Options * @property {module:ol/extent~Extent} [extent] Extent for the tile grid. No tiles * outside this extent will be requested by {@link module:ol/source/Tile} sources. * When no `origin` or `origins` are configured, the `origin` will be set to the * top-left corner of the extent. * @property {module:ol/coordinate~Coordinate} [origin] The tile grid origin, i.e. * where the `x` and `y` axes meet (`[z, 0, 0]`). Tile coordinates increase left * to right and upwards. If not specified, `extent` or `origins` must be provided. * @property {Array.} [origins] Tile grid origins, * i.e. where the `x` and `y` axes meet (`[z, 0, 0]`), for each zoom level. If * given, the array length should match the length of the `resolutions` array, i.e. * each resolution can have a different origin. Tile coordinates increase left to * right and upwards. If not specified, `extent` or `origin` must be provided. * @property {!Array.} resolutions Resolutions. The array index of each * resolution needs to match the zoom level. This means that even if a `minZoom` * is configured, the resolutions array will have a length of `maxZoom + 1` * @property {!Array.} matrixIds matrix IDs. The length of this array needs * to match the length of the `resolutions` array. * @property {Array.} [sizes] Number of tile rows and columns * of the grid for each zoom level. The values here are the `TileMatrixWidth` and * `TileMatrixHeight` advertised in the GetCapabilities response of the WMTS, and * define the grid's extent together with the `origin`. * An `extent` can be configured in addition, and will further limit the extent for * which tile requests are made by sources. Note that when the top-left corner of * the `extent` is used as `origin` or `origins`, then the `y` value must be * negative because OpenLayers tile coordinates increase upwards. * @property {number|module:ol/size~Size} [tileSize] Tile size. * @property {Array.} [tileSizes] Tile sizes. The length of * this array needs to match the length of the `resolutions` array. * @property {Array.} [widths] Number of tile columns that cover the grid's * extent for each zoom level. Only required when used with a source that has `wrapX` * set to `true`, and only when the grid's origin differs from the one of the * projection's extent. The array length has to match the length of the `resolutions` * array, i.e. each resolution will have a matching entry here. */ /** * @classdesc * Set the grid pattern for sources accessing WMTS tiled-image servers. * * @constructor * @extends {module:ol/tilegrid/TileGrid} * @param {module:ol/tilegrid/WMTS~Options} options WMTS options. * @struct * @api */ const WMTSTileGrid = function(options) { /** * @private * @type {!Array.} */ this.matrixIds_ = options.matrixIds; // FIXME: should the matrixIds become optional? TileGrid.call(this, { extent: options.extent, origin: options.origin, origins: options.origins, resolutions: options.resolutions, tileSize: options.tileSize, tileSizes: options.tileSizes, sizes: options.sizes }); }; inherits(WMTSTileGrid, TileGrid); /** * @param {number} z Z. * @return {string} MatrixId.. */ WMTSTileGrid.prototype.getMatrixId = function(z) { return this.matrixIds_[z]; }; /** * Get the list of matrix identifiers. * @return {Array.} MatrixIds. * @api */ WMTSTileGrid.prototype.getMatrixIds = function() { return this.matrixIds_; }; export default WMTSTileGrid; /** * Create a tile grid from a WMTS capabilities matrix set and an * optional TileMatrixSetLimits. * @param {Object} matrixSet An object representing a matrixSet in the * capabilities document. * @param {module:ol/extent~Extent=} opt_extent An optional extent to restrict the tile * ranges the server provides. * @param {Array.=} opt_matrixLimits An optional object representing * the available matrices for tileGrid. * @return {module:ol/tilegrid/WMTS} WMTS tileGrid instance. * @api */ export function createFromCapabilitiesMatrixSet(matrixSet, opt_extent, opt_matrixLimits) { /** @type {!Array.} */ const resolutions = []; /** @type {!Array.} */ const matrixIds = []; /** @type {!Array.} */ const origins = []; /** @type {!Array.} */ const tileSizes = []; /** @type {!Array.} */ const sizes = []; const matrixLimits = opt_matrixLimits !== undefined ? opt_matrixLimits : []; const supportedCRSPropName = 'SupportedCRS'; const matrixIdsPropName = 'TileMatrix'; const identifierPropName = 'Identifier'; const scaleDenominatorPropName = 'ScaleDenominator'; const topLeftCornerPropName = 'TopLeftCorner'; const tileWidthPropName = 'TileWidth'; const tileHeightPropName = 'TileHeight'; const code = matrixSet[supportedCRSPropName]; const projection = getProjection(code.replace(/urn:ogc:def:crs:(\w+):(.*:)?(\w+)$/, '$1:$3')) || getProjection(code); const metersPerUnit = projection.getMetersPerUnit(); // swap origin x and y coordinates if axis orientation is lat/long const switchOriginXY = projection.getAxisOrientation().substr(0, 2) == 'ne'; matrixSet[matrixIdsPropName].sort(function(a, b) { return b[scaleDenominatorPropName] - a[scaleDenominatorPropName]; }); matrixSet[matrixIdsPropName].forEach(function(elt) { let matrixAvailable; // use of matrixLimits to filter TileMatrices from GetCapabilities // TileMatrixSet from unavailable matrix levels. if (matrixLimits.length > 0) { matrixAvailable = find(matrixLimits, function(elt_ml) { if (elt[identifierPropName] == elt_ml[matrixIdsPropName]) { return true; } // Fallback for tileMatrix identifiers that don't get prefixed // by their tileMatrixSet identifiers. if (elt[identifierPropName].indexOf(':') === -1) { return matrixSet[identifierPropName] + ':' + elt[identifierPropName] === elt_ml[matrixIdsPropName]; } return false; }); } else { matrixAvailable = true; } if (matrixAvailable) { matrixIds.push(elt[identifierPropName]); const resolution = elt[scaleDenominatorPropName] * 0.28E-3 / metersPerUnit; const tileWidth = elt[tileWidthPropName]; const tileHeight = elt[tileHeightPropName]; if (switchOriginXY) { origins.push([elt[topLeftCornerPropName][1], elt[topLeftCornerPropName][0]]); } else { origins.push(elt[topLeftCornerPropName]); } resolutions.push(resolution); tileSizes.push(tileWidth == tileHeight ? tileWidth : [tileWidth, tileHeight]); // top-left origin, so height is negative sizes.push([elt['MatrixWidth'], -elt['MatrixHeight']]); } }); return new WMTSTileGrid({ extent: opt_extent, origins: origins, resolutions: resolutions, matrixIds: matrixIds, tileSizes: tileSizes, sizes: sizes }); }