类:瓦片网格

ol/tilegrid/TileGrid~瓦片网格


import TileGrid from 'ol/tilegrid/TileGrid.js';

用于为访问瓦片图像服务器的数据源设置网格模式的基类。

new TileGrid(options)

Name Type 描述
extent Extent | undefined

瓦片网格的范围。超出此范围的瓦片将不会被请求。TileSource源。当没有originorigins配置完成后,origin将被设置为范围的左上角。

minZoom number (defaults to 0)

最小缩放。

origin Coordinate | undefined

瓦片网格的原点,即xy坐标轴相交([z, 0, 0])。瓦片坐标从左到右、向下递增。若未指定,extentorigins必须提供。

origins Array<Coordinate> | undefined

瓦片网格原点,即xy坐标轴相交([z, 0, 0]),对于每个缩放级别。如果给定,数组长度应与缩放级别的数量相匹配。resolutions数组,即每个分辨率可具有不同的原点。瓦片坐标从左向右、向下递增。若未指定,extentorigin必须提供。

resolutions Array.<number>

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

sizes Array<Size> | undefined

每个缩放级别的瓦片网格行数和列数。如果指定,这些值将定义每个缩放级别的范围以及origin或者origins. A 网格extent此外,该参数可进行配置,并将进一步限制数据源发出瓦片请求的范围。若范围的左下角被用作origin或者origins,则y值必须为负数,因为 OpenLayers 瓦片坐标以左上角为原点。

tileSize number | Size | undefined

瓦片尺寸。默认为[256, 256].

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

瓦片尺寸。如果给定,数组长度应与...的长度匹配。resolutions数组,即每个分辨率可具有不同的图块大小。

子类

方法

forEachTileCoord(extent, zoom, callback)

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

Name Type 描述
extent Extent

范围.

zoom number

整数缩放级别。

callback function

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

获取该图块网格的范围(如果已配置)。

返回:
范围.

getMaxZoom(){number}

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

返回:
最大缩放级别。

getMinZoom(){number}

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

返回:
最小缩放。

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

Name Type 描述
z number

整数缩放级别。

返回:
原点。

getResolution(z){number}

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

Name Type 描述
z number

整数缩放级别。

返回:
分辨率.

getResolutions(){Array.<number>}

获取瓦片网格的分辨率列表。

返回:
分辨率。

getTileCoordExtent(tileCoord, tempExtent){Extent}

获取瓦片坐标的范围。

Name Type 描述
tileCoord TileCoord

瓦片坐标。

tempExtent Extent | undefined

临时范围对象

返回:
范围.

getTileCoordForCoordAndResolution(coordinate, resolution, opt_tileCoord){TileCoord}

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

Name Type 描述
coordinate Coordinate

坐标。

resolution number

分辨率.

opt_tileCoord TileCoord | undefined

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

返回:
瓦片坐标。

getTileCoordForCoordAndZ(coordinate, z, opt_tileCoord){TileCoord}

根据地图坐标和缩放级别获取图块坐标。

Name Type 描述
coordinate Coordinate

坐标。

z number

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

opt_tileCoord TileCoord | undefined

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

返回:
瓦片坐标。

getTileSize(z){number | Size}

获取指定缩放级别的图块大小。返回值的类型与配置图块网格时所用的 tileSizetileSizes 一致。若需始终获取 Size,请将结果传入 toSize 进行处理。

Name Type 描述
z number

Z.

返回:
瓦片尺寸。

getZForResolution(resolution, opt_direction){number}

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.