BaseVector~BaseVectorLayer

import BaseVectorLayer from 'ol/layer/BaseVector.js';

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

new BaseVectorLayer(options) layer/BaseVector.js, строка 89

Имя	Тип	Описание
`className`	string (по умолчанию 'ol-layer')	Имя CSS-класса, назначаемое элементу слоя.
`opacity`	number (по умолчанию 1)	Непрозрачность (0, 1).
`visible`	boolean (по умолчанию true)	Видимость.
`extent`	Extent \| undefined	Ограничивающая область для отображения слоя. За пределами этой области слой отображаться не будет.
`zIndex`	number \| undefined	Z-индекс для отображения слоя. При отображении слои упорядочиваются сначала по Z-индексу, а затем по позиции. Если задано `undefined`, для слоёв, добавленных в коллекцию `layers` карты, предполагается значение `zIndex`, а для слоёв, добавленных с помощью метода `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)	Предотвращает перекрытие изображений и текста. Любое истинное значение включает предотвращение перекрытия. В пределах слоя объект, отрисованный раньше другого, имеет более высокий приоритет. Для всех слоёв с одинаковым значением `declutter` предотвращение перекрытия выполняется совместно. Приоритет определяется порядком отрисовки слоёв с одинаковым значением `declutter`. Чем выше слой в стеке, тем выше его приоритет. Чтобы выполнять предотвращение перекрытия отдельно для разных слоёв или групп слоёв, задайте разные истинные значения для `declutter`.
`style`	StyleLike \| FlatStyleLike \| null \| undefined	Стиль слоя. Если задано значение `null`, будут отображаться только объекты с собственным стилем. Стиль по умолчанию, используемый, если это значение не задано, см. в разделе `Style`.
`background`	BackgroundColor \| undefined	Цвет фона слоя. Если он не задан, фон отображаться не будет.
`updateWhileAnimating`	boolean (по умолчанию false)	Если задано значение `true`, наборы объектов будут пересоздаваться во время анимации. Это предотвращает обрезку векторных объектов, но может снизить производительность при большом объёме векторных данных. Если задано значение `false`, наборы будут пересоздаваться, когда анимация не выполняется.
`updateWhileInteracting`	boolean (по умолчанию false)	Если задано значение `true`, наборы объектов будут пересоздаваться во время взаимодействия. См. также `updateWhileAnimating`.
`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)

Подклассы

Наследует

Layer

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

Имя	Тип	Можно задать	Тип события 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

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

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

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

Возвращает:

Promise, который разрешается массивом объектов.

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