VectorImage~VectorImageLayer

import VectorImageLayer from 'ol/layer/VectorImage.js';

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

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

new VectorImageLayer(options) layer/VectorImage.js, line 70

Имя	Тип	Описание
`className`	string (по умолчанию 'ol-layer')	Имя CSS-класса, которое будет присвоено элементу слоя.
`opacity`	number (по умолчанию 1)	Непрозрачность (0, 1).
`visible`	boolean (по умолчанию true)	Видимость.
`extent`	Extent \| undefined	Границы области отображения слоя. Слой не отображается за пределами этой области.
`zIndex`	number \| undefined	Индекс Z для отображения слоя. При отображении слои упорядочиваются сначала по индексу Z, а затем по позиции. Если `undefined`, для слоёв, добавленных в коллекцию `layers` карты, предполагается значение `zIndex` 0, а для слоёв, добавленных с помощью метода `setMap()`, — `Infinity`.
`minResolution`	number \| undefined	Минимальное разрешение (включительно), при котором слой будет виден.
`maxResolution`	number \| undefined	Максимальное разрешение (не включительно), ниже которого слой будет виден.
`minZoom`	number \| undefined	Минимальный уровень масштабирования карты (не включительно), выше которого слой будет виден.
`maxZoom`	number \| undefined	Максимальный уровень масштабирования карты (включительно), при котором слой будет виден.
`renderOrder`	OrderFunction \| undefined	Порядок отображения. Функция, используемая для сортировки объектов перед отображением. По умолчанию объекты рисуются в порядке их создания. Используйте `null`, чтобы пропустить сортировку, но получить неопределённый порядок отрисовки.
`renderBuffer`	number (по умолчанию 100)	Буфер в пикселях вокруг области просмотра, используемый рендерером при получении объектов из векторного источника для отображения или обнаружения попаданий. Рекомендуемое значение: размер самого крупного символа, толщина линии или размер подписи.
`source`	VectorSourceType \| undefined	Источник.
`map`	Map \| undefined	Добавляет слой на карту в качестве наложения. Карта не будет управлять этим слоем в своей коллекции слоёв, и слой будет отображаться поверх остальных. Это полезно для временных слоёв. Стандартный способ добавить слой на карту и передать его под управление карты — использовать `map.addLayer()`.
`declutter`	boolean \| string \| number (по умолчанию false)	Предотвращает наложение изображений и текста на этом слое. Любое истинное значение включает предотвращение наложений. Приоритет определяется значением `zIndex` стиля и порядком отображения объектов. Чем выше индекс z, тем выше приоритет. При одинаковом индексе z объект, отрисованный раньше, имеет более высокий приоритет. Элементы не будут проверяться на наложение с элементами других слоёв с таким же значением `declutter` и не будут объединяться с ними. Если это необходимо, используйте вместо этого `VectorLayer`.
`style`	StyleLike \| FlatStyleLike \| null \| undefined	Стиль слоя. Если задано значение `null`, будут отображаться только объекты, у которых есть собственный стиль. Стиль по умолчанию, используемый, если это значение не задано, см. в разделе `Style`.
`background`	BackgroundColor \| undefined	Цвет фона слоя. Если не задан, фон отображаться не будет.
`imageRatio`	number (по умолчанию 1)	Коэффициент, на который отображаемая область должна превышать область просмотра. Больший коэффициент позволяет избежать обрезания изображений при перемещении карты, но снижает производительность.
`properties`	Object.<string, *> \| undefined	Произвольные наблюдаемые свойства. Доступ к ним можно получить с помощью `#get()` и `#set()`.

События:

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

Наследует

BaseVectorLayer

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

Имя	Тип	Можно задать	Тип 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`	Непрозрачность слоя.
`source`	SourceType \| null	да	`change:source`	Источник слоя (или `null`, если ещё не задан).
`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	Представление или `FrameState`. Требуется только в том случае, если слой не добавлен на карту.

Возвращает:

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

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

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

Возвращает:

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

getFeatures(pixel){Promise<Array<FeatureLike>>} унаследовано layer/BaseVector.js, строка 175

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

Алгоритм обнаружения попаданий, используемый этим методом, оптимизирован для производительности, но менее точен, чем алгоритм метода map.getFeaturesAtPixel(). Текст не учитывается, а значки представлены ограничивающей рамкой, а не точным изображением.

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

Возвращает:

Промис, разрешающийся массивом объектов.

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).

Возвращает:

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

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

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

Возвращает:

Объект.

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

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

Возвращает:

Ревизия.

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

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

Возвращает:

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

getStyle(){StyleLike | FlatStyleLike | null | undefined} унаследовано layer/BaseVector.js, строка 201

Получает стиль объектов. Возвращает значение, переданное параметру style при создании или методу setStyle.

Возвращает:

Стиль слоя.

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

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

Возвращает:

Функция стиля слоя.

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	Представление или `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	Обновить без отправки события.

setDeclutter(declutter) унаследовано layer/BaseVector.js, строка 285

Имя	Тип	Описание
`declutter`	boolean \| string \| number	Предотвращать наложение изображений и текста.

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	Непрозрачность слоя.

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

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

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

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

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

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

setStyle(style) унаследовано layer/BaseVector.js, строка 273

Задаёт стиль объектов. Это может быть один объект стиля, массив стилей или функция, которая принимает объект и разрешение и возвращает массив стилей. Если задано значение null, у слоя нет стиля (стиль null), поэтому в слое будут отображаться только объекты с собственными стилями. Вызовите setStyle() без аргументов, чтобы восстановить стиль по умолчанию. Информацию о стиле по умолчанию см. в разделе the ol/style/Style module.

Если у слоя статический стиль, вместо использования конструкторов Style и символизаторов (Fill, Stroke и т. д.) можно использовать литералы объектов flat style:

vectorLayer.setStyle({
  "fill-color": "yellow",
  "stroke-color": "black",
  "stroke-width": 4
})

Имя	Тип	Описание
`style`	StyleLike \| FlatStyleLike \| null \| undefined	Стиль слоя.

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	Удалить без вызова события.