ol/tilegrid/TileGrid~TileGrid
import TileGrid from 'ol/tilegrid/TileGrid.js';
Базовый класс для настройки сетки для источников, обращающихся к серверам с плиточными изображениями.
-
new TileGrid(options)
-
Имя Тип Описание extentExtent | undefined Область для плиточной сетки. Плитки за пределами этой области не будут запрашиваться источниками
TileSource. Если не указаныoriginилиorigins,originбудет установлено в верхний левый угол области.minZoomnumber (по умолчанию 0) Минимальный масштаб.
originCoordinate | undefined Начальная точка плиточной сетки, т.е. точка пересечения осей
xиy([z, 0, 0]). Координаты плиток увеличиваются слева направо и вниз. Если не указано, необходимо указатьextentилиorigins.originsArray<Coordinate> | undefined Начальные точки плиточной сетки, т.е. точки пересечения осей
xиy([z, 0, 0]) для каждого уровня масштабирования. Если указано, длина массива должна совпадать с длиной массиваresolutions, то есть каждая разрешение может иметь свою начальную точку. Координаты плиток увеличиваются слева направо и вниз. Если не указано, необходимо указатьextentилиorigin.resolutionsArray.<number> Разрешения. Индекс элемента в массиве для каждого разрешения должен соответствовать уровню масштабирования. Это означает, что даже если указано
minZoom, длина массива разрешений будет равнаmaxZoom + 1.sizesArray<Size> | undefined Количество строк и столбцов плиток в сетке для каждого уровня масштабирования. Если указано, значения определяют область каждого уровня масштабирования вместе с
originилиorigins. Дополнительно можно настроить сеткуextent, которая будет дополнительно ограничивать область, для которой источники запрашивают плитки. Если в качествеoriginилиoriginsиспользуется нижний левый угол области, то значениеyдолжно быть отрицательным, поскольку координаты плиток OpenLayers используют верхний левый угол в качестве начала координат.tileSizenumber | Size | undefined Размер плитки. По умолчанию
[256, 256].tileSizesArray.<(number|module:ol/size~Size)> | undefined Размеры плиток. Если указано, длина массива должна соответствовать длине массива
resolutions, т.е. каждый уровень масштабирования может иметь свой размер плитки.
Подклассы
Методы
-
forEachTileCoord(extent, zoom, callback)
-
Вызов функции с каждой координатой тайла для заданного экстента и уровня масштабирования.
Name Type Description extentExtent Экстент.
zoomnumber Целочисленный уровень масштабирования.
callbackfunction Функция, вызываемая для каждой координаты тайла.
-
getExtent(){Extent}
-
Получение экстента для этой сетки тайлов, если он был настроен.
Returns:
Extent.
-
getMaxZoom(){number}
-
Получение максимального уровня масштабирования для сетки.
Returns:
Max zoom.
-
getMinZoom(){number}
-
Получение минимального уровня масштабирования для сетки.
Returns:
Min zoom.
-
getOrigin(z){Coordinate}
-
Получение начала координат для сетки на заданном уровне масштабирования.
Name Type Description znumber Целочисленный уровень масштабирования.
Returns:
Origin.
-
getResolution(z){number}
-
Получение разрешения для заданного уровня масштабирования.
Name Type Description znumber Целочисленный уровень масштабирования.
Returns:
Resolution.
-
getResolutions(){Array.<number>}
-
Получение списка разрешений для сетки тайлов.
Returns:
Resolutions.
-
getTileCoordExtent(tileCoord, tempExtent){Extent}
-
Получение экстента координаты тайла.
Name Type Description tileCoordTileCoord Координата тайла.
tempExtentExtent | undefined Временный объект экстента.
Returns:
Extent.
-
getTileCoordForCoordAndResolution(coordinate, resolution, opt_tileCoord){TileCoord}
-
Получение координаты тайла для заданной координаты карты и разрешения. Этот метод учитывает, что координаты, пересекающие границы тайлов, должны быть назначены более высокой координате тайла.
Name Type Description coordinateCoordinate Координата.
resolutionnumber Разрешение.
opt_tileCoordTileCoord | undefined Объект destination module:ol/tilecoord~TileCoord.
Returns:
Tile coordinate.
-
getTileCoordForCoordAndZ(coordinate, z, opt_tileCoord){TileCoord}
-
Получение координаты тайла, заданной координаты карты и уровня масштабирования.
Name Type Description coordinateCoordinate Координата.
znumber Целочисленный уровень масштабирования, например, результат вызова метода
getZForResolution()opt_tileCoordTileCoord | undefined Объект destination module:ol/tilecoord~TileCoord.
Returns:
Tile coordinate.
-
getTileSize(z){number | Size}
-
Получение размера тайла для уровня масштабирования. Тип возвращаемого значения соответствует
tileSizeилиtileSizes, с которым была настроена сетка тайлов. Чтобы всегда получитьSize, запустите результат черезtoSize.Name Type Description znumber Z.
Returns:
Tile size.
-
getZForResolution(resolution, opt_direction){number}
-
Имя Тип Описание resolutionnumber Разрешение.
opt_directionnumber | NearestDirectionFunction | undefined Если 0, будет использовано ближайшее разрешение. Если 1, будет использовано ближайшее большее разрешение (меньшее Z). Если -1, будет использовано ближайшее меньшее разрешение (большее Z). По умолчанию 0. Используйте
NearestDirectionFunctionдля более точного управления.Например, для изменения значения Z тайла в середине уровней масштабирования
function(value, high, low) { return value - low * Math.sqrt(high / low); }Возвращает:
Z.
© 2005-present, OpenLayers Contributors All rights reserved.Licensed under the BSD 2-Clause License.
https://openlayers.org/en/latest/apidoc/module-ol_tilegrid_TileGrid-TileGrid.html