类 WMTSTileGrid

ol/tilegrid/WMTS~WMS瓦片网格


import WMTSTileGrid from 'ol/tilegrid/WMTS.js';

为访问WMTS瓦片图像服务器的源设置网格配置。

new WMTSTileGrid(options)

Name Type 描述
extent Extent | undefined

瓦片网格的范围。超出此范围的瓦片将不会被请求。TileSource数据源。当不存在时originorigins配置后,origin将被设置为范围的左上角。

origin Coordinate | undefined

瓦片网格原点,即其位置xy坐标轴相交([z, 0, 0])。瓦片坐标从左至右、自上而下递增。如未指定,extentorigins必须提供。

origins Array<Coordinate> | undefined

瓦片网格原点,即其起始位置。xy坐标轴相交([z, 0, 0]),针对每个缩放级别。若已指定,则数组长度应与resolutions数组,即每个分辨率可拥有不同的原点。瓦片坐标从左至右、自上而下递增。若未指定,extentorigin必须提供。

resolutions Array.<number>

分辨率。每个分辨率的数组索引必须与缩放级别相对应。这意味着即使minZoom配置后,分辨率数组的长度为maxZoom + 1

matrixIds Array.<string>

矩阵标识符。此数组的长度需与后续数组的长度保持一致。resolutions数组.

sizes Array<Size> | undefined

各缩放层级下网格的瓦片行列数。这些值由TileMatrixWidthTileMatrixHeight在WMTS的GetCapabilities响应中声明,用于定义各层级的矩阵范围,以及originorigins。网格extent还可进一步配置,以限制瓦片请求的范围。若将范围左下角设置为originorigins,则y的值必须为负,因为OpenLayers瓦片坐标以左上角为原点。

tileSize number | Size | undefined

瓦片尺寸。

tileSizes Array.<(number|module:ol/size~Size)> | undefined

瓦片尺寸。此数组的长度需要与另一数组的长度相匹配。resolutions数组.

继承

方法

forEachTileCoord(extent, zoom, callback) inherited

对于给定的范围和缩放级别,对每个瓦片坐标调用函数。

Name Type 描述
extent Extent

范围.

zoom number

整数缩放级别。

callback function

针对每个瓦片坐标调用函数。

获取此瓦片网格的范围(如果已配置)。

返回:
范围.

getMatrixIds(){Array.<string>}

获取矩阵标识符列表。

返回:
矩阵ID。

getMaxZoom(){number} inherited

获取网格的最大缩放级别。

返回:
最大缩放。

getMinZoom(){number} inherited

确定网格的最小缩放级别。

返回:
最小缩放。

获取指定缩放级别的网格原点。

Name Type 描述
z number

整数缩放级别。

返回:
原点。

getResolution(z){number} inherited

获取给定缩放级别的分辨率。

Name Type 描述
z number

整数缩放级别

返回:
分辨率.

getResolutions(){Array.<number>} inherited

获取图块网格的分辨率列表。

返回:
分辨率。

getTileCoordExtent(tileCoord, tempExtent){Extent} inherited

获取图块坐标的范围。

Name Type 描述
tileCoord TileCoord

瓦片坐标。

tempExtent Extent | undefined

临时范围对象。

返回:
范围.

getTileCoordForCoordAndResolution(coordinate, resolution, opt_tileCoord){TileCoord} inherited

根据给定的地图坐标和分辨率,获取对应的瓦片坐标。该方法规定,与瓦片边界相交的坐标应分配更高的瓦片坐标。

Name Type 描述
coordinate Coordinate

坐标。

resolution number

分辨率.

opt_tileCoord TileCoord | undefined

目标模块:ol/tilecoord~瓦片坐标对象。

返回:
瓦片坐标。

getTileCoordForCoordAndZ(coordinate, z, opt_tileCoord){TileCoord} inherited

根据地图坐标和缩放级别计算瓦片坐标。

Name Type 描述
coordinate Coordinate

坐标。

z number

整数缩放级别,例如某个结果getZForResolution()方法调用

opt_tileCoord TileCoord | undefined

目标模块:ol/tilecoord~瓦片坐标对象。

返回:
瓦片坐标。

getTileSize(z){number | Size} inherited

获取指定缩放级别的瓦片大小。返回值的类型与配置瓦片网格时所用的 tileSizetileSizes 相匹配。为确保始终获得 Size,请将结果经过 toSize 处理。

Name Type 描述
z number

Z.

返回:
瓦片尺寸。

getZForResolution(resolution, opt_direction){number} inherited

Name Type 描述
resolution number

分辨率.

opt_direction number | NearestDirectionFunction | undefined

若为0,则使用最近分辨率;若为1,则使用最近的较高分辨率(较低Z值);若为-1,则使用最近的较低分辨率(较高Z值)。默认值为0。使用NearestDirectionFunction以实现更精确的控制。

例如,在缩放级别的中点处更改瓦片Z。

function(value, high, low) {
  return value - low * Math.sqrt(high / low);
}
返回:
Z.