WMTS~WMTSTileGrid

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

Задать шаблон сетки для источников, обращающихся к серверам WMTS с тайловыми изображениями.

new WMTSTileGrid(options) tilegrid/WMTS.js, строка 49

Имя	Тип	Описание
`extent`	Extent \| undefined	Область охвата тайловой сетки. Источники `TileSource` не будут запрашивать тайлы за пределами этой области. Если не заданы `origin` или `origins`, `origin` будет установлена в верхний левый угол области охвата.
`minZoom`	number (по умолчанию 0)	Минимальный уровень масштабирования.
`origin`	Coordinate \| undefined	Начало координат тайловой сетки, то есть точка пересечения осей `x` и `y` (`[z, 0, 0]`). Координаты тайлов увеличиваются слева направо и сверху вниз. Если не задано, необходимо указать `extent` или `origins`.
`origins`	Array<Coordinate> \| undefined	Начала координат тайловой сетки — точки пересечения осей `x` и `y` (`[z, 0, 0]`) — для каждого уровня масштабирования. Если задано, длина массива должна совпадать с длиной массива `resolutions`, то есть для каждого разрешения может быть задано своё начало координат. Координаты тайлов увеличиваются слева направо и сверху вниз. Если не задано, необходимо указать `extent` или `origin`.
`resolutions`	Array.<number>	Разрешения. Индекс каждого разрешения в массиве должен соответствовать уровню масштабирования. Это означает, что даже если задан `minZoom`, длина массива разрешений будет равна `maxZoom + 1`
`matrixIds`	Array.<string>	Идентификаторы матриц. Длина этого массива должна совпадать с длиной массива `resolutions`.
`sizes`	Array<Size> \| undefined	Количество строк и столбцов тайлов сетки для каждого уровня масштабирования. Эти значения соответствуют `TileMatrixWidth` и `TileMatrixHeight`, указанным в ответе GetCapabilities службы WMTS, и вместе с `origin` или `origins` определяют область охвата каждого уровня масштабирования. Дополнительно можно задать `extent` сетки, которая ещё сильнее ограничит область, для которой источники запрашивают тайлы. Если нижний левый угол области охвата используется как `origin` или `origins`, значение `y` должно быть отрицательным, поскольку в OpenLayers в качестве начала координат тайлов используется верхний левый угол.
`tileRanges`	Array<TileRange> \| undefined	Предварительно созданные диапазоны тайлов для каждого уровня масштабирования. Если задано, используется вместо `sizes` для задания границ индексов тайлов для каждого уровня.
`tileSize`	number \| Size \| undefined	Размер тайла.
`tileSizes`	Array.<(number\|module:ol/size~Size)> \| undefined	Размеры тайлов. Длина этого массива должна совпадать с длиной массива `resolutions`.

Наследует

TileGrid

Методы

forEachTileCoord(extent, zoom, callback) унаследовано tilegrid/TileGrid.js, строка 245

Вызывает функцию для каждой координаты тайла в заданной области охвата и на заданном уровне масштабирования.

Имя	Тип	Описание
`extent`	Extent	Область охвата.
`zoom`	number	Целочисленный уровень масштабирования.
`callback`	function	Функция, вызываемая для каждой координаты тайла.

getExtent(){Extent} унаследовано tilegrid/TileGrid.js, строка 301

Получить область охвата этой тайловой сетки, если она была задана.

Возвращает:

Область охвата.

getMatrixIds(){Array.<string>} tilegrid/WMTS.js, строка 86

Получить список идентификаторов матриц.

Возвращает:

MatrixIds.

getMaxZoom(){number} унаследовано tilegrid/TileGrid.js, строка 310

Получить максимальный уровень масштабирования сетки.

Возвращает:

Максимальный уровень масштабирования.

getMinZoom(){number} унаследовано tilegrid/TileGrid.js, строка 319

Получить минимальный уровень масштабирования сетки.

Возвращает:

Минимальный уровень масштабирования.

getOrigin(z){Coordinate} унаследовано tilegrid/TileGrid.js, строка 329

Получить начало координат сетки для заданного уровня масштабирования.

Имя	Тип	Описание
`z`	number	Целочисленный уровень масштабирования.

Возвращает:

Начало координат.

getResolution(z){number} унаследовано tilegrid/TileGrid.js, строка 350

Получить разрешение для заданного уровня масштабирования.

Имя	Тип	Описание
`z`	number	Целочисленный уровень масштабирования.

Возвращает:

Разрешение.

getResolutions(){Array.<number>} унаследовано tilegrid/TileGrid.js, строка 359

Получить список разрешений тайловой сетки.

Возвращает:

Разрешения.

getTileCoordExtent(tileCoord, tempExtent){Extent} унаследовано tilegrid/TileGrid.js, строка 476

Получить область охвата координаты тайла.

Имя	Тип	Описание
`tileCoord`	TileCoord	Координата тайла.
`tempExtent`	Extent \| undefined	Временный объект области охвата.

Возвращает:

Область охвата.

getTileCoordForCoordAndResolution(coordinate, resolution, opt_tileCoord){TileCoord} унаследовано tilegrid/TileGrid.js, строка 498

Получить координату тайла для заданных координат карты и разрешения. Этот метод учитывает, что координаты, пересекающие границы тайлов, должны относиться к тайлу с большей координатой.

Имя	Тип	Описание
`coordinate`	Coordinate	Координата.
`resolution`	number	Разрешение.
`opt_tileCoord`	TileCoord \| undefined	Объект module:ol/tilecoord~TileCoord, в который помещается результат.

Возвращает:

Координата тайла.

getTileCoordForCoordAndZ(coordinate, z, opt_tileCoord){TileCoord} унаследовано tilegrid/TileGrid.js, строка 589

Получить координату тайла по координатам карты и уровню масштабирования.

Имя	Тип	Описание
`coordinate`	Coordinate	Координата.
`z`	number	Целочисленный уровень масштабирования, например результат вызова метода `getZForResolution()`
`opt_tileCoord`	TileCoord \| undefined	Объект module:ol/tilecoord~TileCoord, в который помещается результат.

Возвращает:

Координата тайла.

getTileSize(z){number | Size} унаследовано tilegrid/TileGrid.js, строка 615

Получить размер тайла для уровня масштабирования. Тип возвращаемого значения соответствует типу tileSize или tileSizes, с которым была настроена тайловая сетка. Чтобы всегда получать Size, передайте результат в toSize.

Имя	Тип	Описание
`z`	number	Z.

Возвращает:

Размер тайла.

getZForResolution(resolution, opt_direction){number} унаследовано tilegrid/TileGrid.js, строка 652

Имя Тип Описание

Имя	Тип	Описание
`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); }

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);
}