Class: TileGrid

ol/tilegrid/TileGrid~TileGrid


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

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

new TileGrid(options)

Name Type Description
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

每个缩放级别的网格瓦片行数和列数。如果指定,这些值与 originorigins 一起定义每个缩放级别的范围。还可以配置额外的网格 extent,将进一步限制数据源请求瓦片的范围。如果使用范围的左下角作为 originorigins,则 y 值必须为负,因为 OpenLayers 瓦片坐标使用左上角作为原点。

tileSize number | Size | undefined

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

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

瓦片尺寸。如果提供,数组长度应与 resolutions 数组的长度匹配,即每个分辨率可以有不同的瓦片尺寸。

Subclasses

Methods

forEachTileCoord(extent, zoom, callback)

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

Name Type Description
extent Extent

范围。

zoom number

整数缩放级别。

callback function

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

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

返回值:
范围。

getMaxZoom(){number}

获取maximum zoom level for the grid.

返回值:
最大缩放。

getMinZoom(){number}

获取minimum zoom level for the grid.

返回值:
Min zoom.

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

Name Type Description
z number

整数缩放级别。

返回值:
Origin.

getResolution(z){number}

获取resolution for the given zoom level.

Name Type Description
z number

整数缩放级别。

返回值:
分辨率。

getResolutions(){Array.<number>}

获取list of resolutions for the tile grid.

返回值:
分辨率。

getTileCoordExtent(tileCoord, tempExtent){Extent}

获取extent of a tile coordinate.

Name Type Description
tileCoord TileCoord

瓦片坐标。

tempExtent Extent | undefined

临时范围对象。

返回值:
范围。

getTileCoordForCoordAndResolution(coordinate, resolution, opt_tileCoord){TileCoord}

获取指定地图坐标和分辨率对应的瓦片坐标。此方法认为与瓦片边界相交的坐标应分配更高的瓦片坐标。

Name Type Description
coordinate Coordinate

坐标。

resolution number

分辨率。

opt_tileCoord TileCoord | undefined

目标 module:ol/tilecoord~TileCoord 对象。

返回值:
Tile coordinate.

getTileCoordForCoordAndZ(coordinate, z, opt_tileCoord){TileCoord}

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

Name Type Description
coordinate Coordinate

坐标。

z number

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

opt_tileCoord TileCoord | undefined

目标 module:ol/tilecoord~TileCoord 对象。

返回值:
Tile coordinate.

getTileSize(z){number | Size}

获取指定缩放级别的瓦片大小。返回值的类型与配置瓦片网格时使用的 tileSize 或 tileSizes 匹配。要始终获取 Size,请通过 toSize 处理结果。

Name Type Description
z number

Z.

返回值:
Tile size.

getZForResolution(resolution, opt_direction){number}

Name Type Description
resolution number

分辨率。

opt_direction number | NearestDirection函数 | undefined

如果为 0,将使用最接近的分辨率。如果为 1,将使用最接近的较高分辨率(较低的 Z)。如果为 -1,将使用最接近的较低分辨率(较高的 Z)。默认为 0。使用 NearestDirection函数 进行更精确的控制。

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

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