Tile~TileLayer

import TileLayer from 'ol/layer/Tile.js';

Для источников слоёв, предоставляющих предварительно отрисованные изображения, разбитые на тайлы в сетках, организованных по уровням масштабирования для определённых разрешений. Обратите внимание: каждому свойству, заданному в параметрах, соответствует свойство объекта слоя типа BaseObject; например, если задать title: 'My Title' в параметрах, это означает, что свойство title доступно для наблюдения и имеет методы доступа get/set.

new TileLayer(options) layer/Tile.js, строка 19

Имя	Тип	Описание
`className`	string (по умолчанию 'ol-layer')	Имя класса CSS, присваиваемое элементу слоя.
`opacity`	number (по умолчанию 1)	Непрозрачность (0, 1).
`visible`	boolean (по умолчанию true)	Видимость.
`extent`	Extent \| undefined	Ограничивающий экстент для отрисовки слоя. За пределами этого экстента слой отрисовываться не будет.
`zIndex`	number \| undefined	Z-индекс для отрисовки слоя. Во время отрисовки слои упорядочиваются сначала по Z-индексу, а затем по позиции. Если `undefined`, для слоёв, добавленных в коллекцию `layers` карты, предполагается значение `zIndex`, а также `Infinity`, если использовался метод `setMap()` слоя.
`minResolution`	number \| undefined	Минимальное разрешение (включительно), при котором этот слой будет виден.
`maxResolution`	number \| undefined	Максимальное разрешение (не включительно), ниже которого этот слой будет виден.
`minZoom`	number \| undefined	Минимальный уровень масштабирования представления (не включительно), выше которого этот слой будет виден.
`maxZoom`	number \| undefined	Максимальный уровень масштабирования представления (включительно), при котором этот слой будет виден.
`preload`	number (по умолчанию 0)	Предварительная загрузка. Загружать тайлы с низким разрешением до `preload` уровней. `0` означает, что предварительная загрузка не выполняется.
`source`	TileSource \| undefined	Источник данных для этого слоя.
`map`	Map \| undefined	Добавляет слой на карту в качестве наложения. Карта не будет управлять этим слоем в своей коллекции слоёв, а слой будет отрисовываться поверх остальных. Это полезно для временных слоёв. Стандартный способ добавить слой на карту и передать управление им карте — использовать `map.addLayer()`.
`background`	BackgroundColor \| undefined	Цвет фона слоя. Если не указан, фон отрисовываться не будет.
`useInterimTilesOnError`	boolean (по умолчанию true)	Устарело. Использовать промежуточные тайлы при ошибке.
`properties`	Object.<string, *> \| undefined	Произвольные наблюдаемые свойства. Доступ к ним можно получить с помощью `#get()` и `#set()`.
`cacheSize`	number (по умолчанию 512)	Размер внутреннего кэша тайлов. Его размер должен быть достаточным для отрисовки тайлов двух уровней масштабирования.

События:

change (BaseEvent) — общее событие изменения. Вызывается при увеличении счётчика версий.
change:extent (ObjectEvent)
change:maxResolution (ObjectEvent)
change:maxZoom (ObjectEvent)
change:minResolution (ObjectEvent)
change:minZoom (ObjectEvent)
change:opacity (ObjectEvent)
change:preload (ObjectEvent)
change:source (ObjectEvent)
change:useInterimTilesOnError (ObjectEvent)
change:visible (ObjectEvent)
change:zIndex (ObjectEvent)
error (BaseEvent) — общее событие ошибки. Вызывается при возникновении ошибки.
postrender (RenderEvent) — вызывается после отрисовки слоя.
prerender (RenderEvent) — вызывается перед отрисовкой слоя.
propertychange (ObjectEvent) — вызывается при изменении свойства.
sourceready (BaseEvent)

Наследует

BaseTileLayer

Наблюдаемые свойства

Имя	Тип	Можно задать	тип ObjectEvent	Описание
`extent`	Extent \| undefined	да	`change:extent`	Экстент слоя.
`maxResolution`	number	да	`change:maxresolution`	Максимальное разрешение слоя.
`maxZoom`	number	да	`change:maxzoom`	Максимальный уровень масштабирования слоя.
`minResolution`	number	да	`change:minresolution`	Минимальное разрешение слоя.
`minZoom`	number	да	`change:minzoom`	Минимальный уровень масштабирования слоя.
`opacity`	number	да	`change:opacity`	Непрозрачность слоя.
`preload`	number	да	`change:preload`	Уровень, до которого предварительно загружаются тайлы.
`source`	SourceType \| null	да	`change:source`	Источник данных слоя (или `null`, если ещё не задан).
`useInterimTilesOnError`	boolean	да	`change:useinterimtilesonerror`	Использовать промежуточные тайлы при ошибке.
`visible`	boolean	да	`change:visible`	Значение свойства `visible` слоя.
`zIndex`	number \| undefined	да	`change:zindex`	Z-индекс слоя.

Методы

changed() унаследовано Observable.js, строка 68

Увеличивает счётчик ревизий и отправляет событие 'change'.

dispatchEvent(event){boolean | undefined} унаследовано events/Target.js, строка 85

Отправляет событие и вызывает все обработчики, ожидающие события этого типа. Параметр event может быть строкой или объектом со свойством type.

Имя	Тип	Описание
`event`	BaseEvent \| string	Объект события.

Возвращает:

false, если кто-либо вызвал preventDefault для объекта события или если какой-либо обработчик вернул false.

get(key){*} унаследовано Object.js, строка 136

Получает значение.

Имя	Тип	Описание
`key`	string	Имя ключа.

Возвращает:

Значение.

getAttributions(view){Array.<string>} унаследовано layer/Layer.js, строка 349

Получает атрибуции источника этого слоя для указанного представления.

Имя	Тип	Описание
`view`	View \| ViewStateLayerStateExtent \| undefined	View или `FrameState`. Требуется только в том случае, если слой не добавлен на карту.

Возвращает:

Атрибуции этого слоя для указанного представления.

getData(pixel){Uint8ClampedArray | Uint8Array | Float32Array | DataView | null} унаследовано layer/BaseTile.js, строка 177

Получает данные для указанного положения пикселя. Тип возвращаемого значения зависит от исходных данных. Для растровых тайлов будет возвращён массив RGBA из четырёх элементов. Для тайлов данных длина массива будет соответствовать количеству каналов в наборе данных. Для запросов за пределами экстента слоя будет возвращено null. Данные растровых тайлов можно получить только в том случае, если задано свойство crossOrigin источника.

// display layer data on every pointer move
map.on('pointermove', (event) => {
  console.log(layer.getData(event.pixel));
});

Имя	Тип	Описание
`pixel`	Pixel	Пиксель.

Возвращает:

Данные пикселя.

getExtent(){Extent | undefined} унаследовано layer/Base.js, строка 210

Возвращает extent слоя или undefined, если слой будет видим независимо от экстента.

Возвращает:

Экстент слоя.

getKeys(){Array.<string>} унаследовано Object.js, строка 149

Получает список имён свойств объекта.

Возвращает:

Список имён свойств.

getMaxResolution(){number} унаследовано layer/Base.js, строка 223

Возвращает максимальное разрешение слоя. Возвращает Infinity, если для слоя не задано максимальное разрешение.

Возвращает:

Максимальное разрешение слоя.

getMaxZoom(){number} унаследовано layer/Base.js, строка 256

Возвращает максимальный уровень масштабирования слоя. Возвращает Infinity, если для слоя не задан максимальный уровень масштабирования.

Возвращает:

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

getMinResolution(){number} унаследовано layer/Base.js, строка 234

Возвращает минимальное разрешение слоя. Возвращает 0, если для слоя не задано минимальное разрешение.

Возвращает:

Минимальное разрешение слоя.

getMinZoom(){number} унаследовано layer/Base.js, строка 245

Возвращает минимальный уровень масштабирования слоя. Возвращает -Infinity, если для слоя не задан минимальный уровень масштабирования.

Возвращает:

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

getOpacity(){number} унаследовано layer/Base.js, строка 266

Возвращает непрозрачность слоя (от 0 до 1).

Возвращает:

Непрозрачность слоя.

getPreload(){number} унаследовано layer/BaseTile.js, строка 124

Возвращает уровень, до которого будут предварительно загружаться тайлы.

Возвращает:

Уровень, до которого будут предварительно загружаться тайлы.

getProperties(){NoInfer.<Properties>} унаследовано Object.js, строка 158

Получает объект со всеми именами свойств и их значениями.

Возвращает:

Объект.

getRevision(){number} унаследовано Observable.js, строка 79

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

Возвращает:

Номер ревизии.

getSource(){SourceType | null} унаследовано layer/Layer.js, строка 214

Получает источник слоя.

Возвращает:

Источник слоя (или null, если ещё не задан).

getUseInterimTilesOnError(){boolean} унаследовано layer/BaseTile.js, строка 144

Устарело. Используются ли промежуточные тайлы при ошибке.

Возвращает:

Использовать ли промежуточные тайлы при ошибке.

getVisible(){boolean} унаследовано layer/Base.js, строка 285

Возвращает значение свойства visible этого слоя. Чтобы узнать, виден ли слой на карте, используйте вместо этого isVisible().

Возвращает:

Значение свойства visible слоя.

getZIndex(){number | undefined} унаследовано layer/Base.js, строка 296

Возвращает z-индекс слоя, используемый для упорядочивания слоёв перед отрисовкой. Возвращает undefined, если слой не управляется.

Возвращает:

Z-индекс слоя.

isVisible(view){boolean} унаследовано layer/Layer.js, строка 305

Слой виден в представлении карты, то есть находится в пределах минимального/максимального разрешения или уровня масштабирования и экстента, не установлен в visible: false и не входит в группу слоёв, для которой задано visible: false.

Имя	Тип	Описание
`view`	View \| ViewStateLayerStateExtent \| undefined	View или `FrameState`. Требуется только в том случае, если слой не добавлен на карту.

Возвращает:

Видим ли слой в представлении карты.

on(type, listener){EventsKey | Array<EventsKey>} унаследовано Observable.js, строка 152

Ожидает событие указанного типа.

Имя	Тип	Описание
`type`	string \| Array.<string>	Тип события или массив типов событий.
`listener`	function	Функция-обработчик.

Возвращает:

Уникальный ключ обработчика. Если первым аргументом передан массив типов событий, возвращается массив ключей.

once(type, listener){EventsKey | Array<EventsKey>} унаследовано Observable.js, строка 164

Однократно ожидает событие указанного типа.

Имя	Тип	Описание
`type`	string \| Array.<string>	Тип события или массив типов событий.
`listener`	function	Функция-обработчик.

Возвращает:

set(key, value, silent) унаследовано Object.js, строка 218

Задаёт значение.

Имя	Тип	Описание
`key`	string	Имя ключа.
`value`	*	Значение.
`silent`	boolean \| undefined	Обновить без отправки события.

setExtent(extent) унаследовано layer/Base.js, строка 316

Задаёт экстент, в пределах которого слой виден. Если undefined, слой будет виден при любом экстенте.

Имя	Тип	Описание
`extent`	Extent \| undefined	Экстент слоя.

setMap(map) унаследовано layer/Layer.js, строка 444

Устанавливает слой для отрисовки поверх других слоёв на карте. Карта не будет управлять этим слоем в своей коллекции слоёв. Это полезно для временных слоёв. Чтобы удалить неуправляемый слой с карты, используйте #setMap(null).

Чтобы добавить слой на карту и передать управление им карте, используйте вместо этого addLayer.

Имя	Тип	Описание
`map`	Map \| null	Карта.

setMaxResolution(maxResolution) унаследовано layer/Base.js, строка 326

Задаёт максимальное разрешение, при котором слой виден.

Имя	Тип	Описание
`maxResolution`	number	Максимальное разрешение слоя.

setMaxZoom(maxZoom) унаследовано layer/Base.js, строка 348

Задаёт максимальный уровень масштабирования (не включая его), при котором слой виден. Обратите внимание, что уровни масштабирования для видимости слоя основаны на уровне масштабирования представления, который может отличаться от уровня масштабирования источника тайлов.

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

setMinResolution(minResolution) унаследовано layer/Base.js, строка 336

Задаёт минимальное разрешение, при котором слой виден.

Имя	Тип	Описание
`minResolution`	number	Минимальное разрешение слоя.

setMinZoom(minZoom) унаследовано layer/Base.js, строка 360

Задаёт минимальный уровень масштабирования (включая его), при котором слой виден. Обратите внимание, что уровни масштабирования для видимости слоя основаны на уровне масштабирования представления, который может отличаться от уровня масштабирования источника тайлов.

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

setOpacity(opacity) унаследовано layer/Base.js, строка 370

Задаёт непрозрачность слоя; допустимые значения находятся в диапазоне от 0 до 1.

Имя	Тип	Описание
`opacity`	number	Непрозрачность слоя.

setPreload(preload) унаследовано layer/BaseTile.js, строка 134

Задаёт уровень, до которого будут предварительно загружаться тайлы.

Имя	Тип	Описание
`preload`	number	Уровень, до которого будут предварительно загружаться тайлы.

setProperties(values, silent) унаследовано Object.js, строка 238

Задаёт коллекцию пар «ключ-значение». Обратите внимание: это изменяет существующие свойства и добавляет новые (но не удаляет существующие свойства).

Имя	Тип	Описание
`values`	Partial.<NoInfer.<Properties>>	Значения.
`silent`	boolean \| undefined	Обновить без вызова события.

setSource(source) унаследованный layer/Layer.js, строка 492

Задаёт источник слоя.

Имя	Тип	Описание
`source`	SourceType \| null	Источник слоя.

setUseInterimTilesOnError(useInterimTilesOnError) унаследованный layer/BaseTile.js, строка 156

Устарело. Задаёт, следует ли использовать промежуточные тайлы при ошибке.

Имя	Тип	Описание
`useInterimTilesOnError`	boolean	Использовать промежуточные тайлы при ошибке.

setVisible(visible) унаследованный layer/Base.js, строка 381

Задаёт видимость слоя (true или false).

Имя	Тип	Описание
`visible`	boolean	Видимость слоя.

setZIndex(zindex) унаследованный layer/Base.js, строка 392

Задаёт Z-индекс слоя, который используется для упорядочивания слоёв перед отрисовкой. По умолчанию Z-индекс равен 0.

Имя	Тип	Описание
`zindex`	number	Z-индекс слоя.

un(type, listener) унаследованный Observable.js, строка 173

Отменяет прослушивание события заданного типа.

Имя	Тип	Описание
`type`	string \| Array.<string>	Тип события или массив типов событий.
`listener`	function	Функция-обработчик.

unset(key, silent) унаследованный Object.js, строка 262

Удаляет свойство.

Имя	Тип	Описание
`key`	string	Имя ключа.
`silent`	boolean \| undefined	Удалить без вызова события.