ol/layer/VectorTile~Слой векторной плитки
import VectorTileLayer from 'ol/layer/VectorTile.js';
Слой для данных векторных плиток, которые отрисовываются на стороне клиента. Обратите внимание, что любое свойство, установленное в параметрах, устанавливается в качестве свойства BaseObject объекта слоя; например, установка title: 'My Title' в параметрах означает, что title является наблюдаемым и имеет геттеры/сеттеры.
-
новый VectorTileLayer(options)
-
Имя Тип Описание classNameстрока (по умолчанию 'ol-layer') Имя класса CSS для элемента слоя.
opacityчисло (по умолчанию 1) Непрозрачность (0, 1).
visibleлогическое (по умолчанию true) Видимость.
extentExtent | undefined Пределы отображения слоя. Слой не будет отображаться за пределами этих пределов.
zIndexчисло | undefined Индекс z для отображения слоя. При отрисовке слои упорядочиваются сначала по индексу z, а затем по положению. Если
undefined, предполагается индекс z равный 0 для слоёв, добавленных в коллекциюlayersкарты, илиInfinity, когда использовался методsetMap()слоя.minResolutionчисло | undefined Минимальное разрешение (включительно), при котором этот слой будет виден.
maxResolutionчисло | undefined Максимальное разрешение (исключительно), ниже которого этот слой будет виден.
minZoomчисло | undefined Минимальный уровень масштабирования (исключительно) выше которого этот слой будет виден.
maxZoomчисло | undefined Максимальный уровень масштабирования (включительно), при котором этот слой будет виден.
renderOrderOrderFunction | undefined Порядок отрисовки. Функция, используемая для сортировки объектов перед отрисовкой. По умолчанию объекты рисуются в порядке их создания. Используйте
null, чтобы избежать сортировки, но получить неопределённый порядок отрисовки.renderBufferчисло (по умолчанию 100) Буфер в пикселях вокруг области тайла, используемый рендерером при получении объектов из векторного тайла для отрисовки или обнаружения нажатия. Рекомендованное значение: векторные тайлы обычно генерируются с буфером, поэтому это значение должно соответствовать максимальному возможному буферу используемых тайлов. Оно должно быть не меньше размера самого большого символа точки или толщины линии.
renderModeVectorTileRenderType (по умолчанию 'hybrid') Режим отрисовки векторных тайлов:
'hybrid': Полигоны и линейные элементы отображаются как изображения, поэтому пиксели масштабируются во время анимаций масштабирования. Символы точек и тексты точно отображаются как векторы и могут оставаться вертикальными при поворотах вида, но поднимаются над всеми полигонами и линейными элементами.'vector': Всё отображается как векторы, и сохраняется исходный порядок отрисовки. Используйте этот режим для повышения производительности и визуального опыта на слоях векторных тайлов с небольшим количеством отрисовываемых объектов (например, для выделения подмножества объектов другого слоя с тем же источником).sourceVectorTileSourceType | undefined Источник.
mapКарта | undefined Устанавливает слой в качестве наложения на карту. Карта не будет управлять этим слоем в своей коллекции слоёв, и слой будет отображаться поверх. Это полезно для временных слоёв. Стандартный способ добавления слоя на карту и управления им картой - использовать
map.addLayer().declutterлогическое | строка | число (по умолчанию false) Сглаживание изображений и текста. Любое истинное значение включит сглаживание. В рамках слоя объект, отрисованный раньше другого, имеет больший приоритет. Все слои с одинаковым значением
declutterбудут сглажены вместе. Приоритет определяется порядком отрисовки слоёв с одинаковым значениемdeclutter. Более высокий уровень в стеке слоёв означает более высокий приоритет. Чтобы сгладить отдельные слои или группы слоёв отдельно, используйте разные значения true дляdeclutter.styleStyleLike | null | undefined Стиль слоя. Если установлено значение
null, будут отображаться только объекты, имеющие собственный стиль. См.Styleдля получения стандартного стиля, который будет использован, если этот параметр не задан.backgroundBackgroundColor | undefined Цвет фона для слоя. Если не указано, фон не будет отрисован.
updateWhileAnimatingлогическое (по умолчанию false) Если установлено значение
true, пакеты объектов будут пересоздаваться во время анимации. Это означает, что никакие векторы не будут показаны обрезанными, но настройка повлияет на производительность при большом количестве векторных данных. Если установлено значениеfalse, пакеты будут пересозданы, когда анимация не активна.updateWhileInteractingлогическое (по умолчанию false) Если установлено значение
true, пакеты объектов будут пересозданы во время взаимодействий. Смотрите такжеupdateWhileAnimating.preloadчисло (по умолчанию 0) Предварительная загрузка. Загрузить тайлы низкого разрешения до уровня
preload.0означает отсутствие предварительной загрузки.useInterimTilesOnErrorлогическое (по умолчанию true) Устаревшее. Использовать временные тайлы при ошибках.
propertiesОбъект.<строка, *> | undefined Произвольные наблюдаемые свойства. К ним можно получить доступ с помощью
#get()и#set().cacheSizeчисло (по умолчанию 0) Размер внутреннего кэша тайлов. Если он слишком мал, он автоматически увеличится, чтобы вместить два уровня масштабирования тайлов.
События:
-
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)
-
Расширяет
Наблюдаемые свойства
| Имя | Тип | Устанавливаемое | Тип ObjectEvent | Описание |
|---|---|---|---|---|
extent | Extent | undefined | да | change:extent | Область слоя. |
maxResolution | число | да | change:maxresolution | Максимальное разрешение слоя. |
maxZoom | число | да | change:maxzoom | Максимальный уровень масштабирования слоя. |
minResolution | число | да | change:minresolution | Минимальное разрешение слоя. |
minZoom | число | да | change:minzoom | Минимальный уровень масштабирования слоя. |
opacity | число | да | change:opacity | Непрозрачность слоя. |
preload | число | да | change:preload | Уровень для предварительной загрузки тайлов. |
source | SourceType | null | да | change:source | Источник слоя (или |
useInterimTilesOnError | логическое значение | да | change:useinterimtilesonerror | Использовать временные тайлы при ошибке. |
visible | логическое значение | да | change:visible | Значение свойства |
zIndex | число | undefined | да | change:zindex | Индекс Z слоя. |
Методы
-
changed() inherited
-
Увеличивает счётчик ревизий и отправляет событие «change».
-
dispatchEvent(event){boolean | undefined} inherited
-
Отправляет событие и вызывает всех слушателей, ожидающих события этого типа. Параметр события может быть строкой или объектом со свойством
type.Имя Тип Описание eventBaseEvent | string Объект события.
Возвращает:
false, если кто-то вызвал preventDefault в объекте события или если какой-либо из слушателей вернул false.
-
Получает значение.
Имя Тип Описание keystring Имя ключа.
Возвращает:
Значение.
-
getAttributions(view){Array.<string>} inherited
-
Получить атрибуты источника этого слоя для заданного представления.
Имя Тип Описание viewView | ViewStateLayerStateExtent | undefined Представление или
FrameState. Требуется только в том случае, если слой не добавлен в карту.Возвращает:
Атрибуты этого слоя в заданном представлении.
-
getBackground(){BackgroundColor}
-
Возвращает:
Цвет фона.
-
Возвращает
extentслоя илиundefined, если он будет виден независимо от области.Возвращает:
Область слоя.
-
getFeatures(pixel){Promise<Array<FeatureLike>>}
-
Получить самый верхний объект, который пересекает заданный пиксель на представлении. Возвращает промис, который разрешается массивом объектов. Массив либо содержит самый верхний объект при обнаружении попадания, либо будет пустым.
Алгоритм обнаружения попадания, используемый для этого метода, оптимизирован для производительности, но менее точен, чем алгоритм в
map.getFeaturesAtPixel(). Текст не учитывается, а значки представляются только своей ограничивающей прямоугольной областью, а не точным изображением.Имя Тип Описание pixelPixel Пиксель.
Возвращает:
Промис, который разрешается массивом объектов.
-
getFeaturesInExtent(extent){Array.<FeatureType>}
-
Получить объекты, ограничивающая прямоугольная область которых пересекает указанную область. Только объекты из кэшированных тайлов для последнего отрисованного уровня масштабирования доступны в источнике. Поэтому этот метод подходит только для запроса тайлов для областей, которые в данный момент отрисовываются.
Объекты возвращаются в случайном порядке тайлов и как они включены в тайлы. Это означает, что они могут быть обрезаны, дублированы в тайлах и упрощены до разрешения рендеринга.
Имя Тип Описание extentExtent Область.
Возвращает:
Объекты.
-
Получить список имён свойств объекта.
Возвращает:
Список имён свойств.
-
getMaxResolution(){number} inherited
-
Возвращает максимальное разрешение слоя. Возвращает Infinity, если для слоя не задано максимальное разрешение.
Возвращает:
Максимальное разрешение слоя.
-
getMaxZoom(){number} inherited
-
Возвращает максимальный уровень масштабирования слоя. Возвращает Infinity, если для слоя не задан максимальный уровень масштабирования.
Возвращает:
Максимальный уровень масштабирования слоя.
-
getMinResolution(){number} inherited
-
Возвращает минимальное разрешение слоя. Возвращает 0, если для слоя не задано минимальное разрешение.
Возвращает:
Минимальное разрешение слоя.
-
getMinZoom(){number} унаследованное
-
Возвращает минимальный уровень масштабирования слоя. Возвращает -Infinity, если для слоя не задан минимальный уровень масштабирования.
Возвращает:
Минимальный уровень масштабирования слоя.
-
getOpacity(){number} унаследованное
-
Возвращает непрозрачность слоя (значение от 0 до 1).
Возвращает:
Непрозрачность слоя.
-
getPreload(){number}
-
Возвращает уровень, до которого будут предварительно загружены плитки.
Возвращает:
Уровень предварительной загрузки плиток.
-
getProperties(){Object.<string, *>} унаследованное
-
Возвращает объект со всеми именами и значениями свойств.
Возвращает:
Объект.
-
getRevision(){number} унаследованное
-
Возвращает номер версии объекта. Каждый раз при изменении объекта его номер версии увеличивается.
Возвращает:
Номер версии.
-
getSource(){SourceType | null} унаследованное
-
Получить источник слоя.
Возвращает:
Источник слоя (илиnull, если он ещё не задан).
-
getStyle(){StyleLike | FlatStyleLike | null | undefined} унаследованное
-
Получить стиль для объектов. Возвращает то, что было передано в опцию
styleпри создании или в методsetStyle.Возвращает:
Стиль слоя.
-
getStyleFunction(){StyleFunction | undefined} унаследованное
-
Получить функцию стиля.
Возвращает:
Функция стиля слоя.
-
getUseInterimTilesOnError(){boolean}
-
Устарело. Использовать ли промежуточные плитки при ошибке.
Возвращает:
Использовать ли промежуточные плитки при ошибке.
-
getVisible(){boolean} унаследованное
-
Возвращает значение свойства
visibleэтого слоя. Чтобы определить, виден ли слой на карте, используйтеisVisible().Возвращает:
Значение свойстваvisibleслоя.
-
getZIndex(){number | undefined} унаследованное
-
Возвращает индекс Z слоя, используемый для упорядочивания слоев перед отрисовкой. Возвращает undefined, если слой не управляется.
Возвращает:
Индекс Z слоя.
-
isVisible(view){boolean} унаследованное
-
Слой виден на представлении карты, т.е. находится в пределах своего минимального/максимального разрешения или масштабирования и области, не установлен в состояние
visible: falseи не находится внутри группы слоев, которая установлена в состояниеvisible: false.Имя Тип Описание viewПредставление | ViewStateLayerStateExtent | undefined Представление или
FrameState. Требуется только тогда, когда слой не добавлен на карту.Возвращает:
Слой виден на представлении карты.
-
on(type, listener){EventsKey | Array<EventsKey>} унаследованное
-
Прослушивать определенный тип события.
Имя Тип Описание typeстрока | Array.<строка> Тип события или массив типов событий.
listenerфункция Функция-обработчик.
Возвращает:
Уникальный ключ для обработчика. Если в качестве первого аргумента используется массив типов событий, возвращается массив ключей.
-
once(type, listener){EventsKey | Array<EventsKey>} унаследованное
-
Прослушивает однократно событие определенного типа.
Name Type Description typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция прослушивателя.
Returns:
Уникальный ключ для прослушивателя. Если вызывается с массивом типов событий в качестве первого аргумента, возвращаемое значение будет массивом ключей.
-
Устанавливает значение.
Name Type Description keystring Имя ключа.
value* Значение.
silentboolean | undefined Обновление без вызова события.
-
setBackground(background)
-
Name Type Description backgroundBackgroundColor Цвет фона.
-
setDeclutter(declutter) inherited
-
Name Type Description declutterboolean | string | number Убрать нагромождение изображений и текста.
-
setExtent(extent) inherited
-
Устанавливает область видимости слоя. Если
undefined, слой будет виден при всех масштабах.Name Type Description extentExtent | undefined Область видимости слоя.
-
setMap(map) inherited
-
Устанавливает слой для отображения поверх других слоев на карте. Карта не будет управлять этим слоем в своей коллекции слоев. Это полезно для временных слоев. Чтобы удалить неуправляемый слой с карты, используйте
#setMap(null).Чтобы добавить слой на карту и управлять им с помощью карты, используйте
addLayer.Name Type Description mapMap | null Карта.
-
setMaxResolution(maxResolution) inherited
-
Устанавливает максимальное разрешение, при котором слой виден.
Name Type Description maxResolutionnumber Максимальное разрешение слоя.
-
setMaxZoom(maxZoom) inherited
-
Устанавливает максимальный уровень масштабирования (исключительно), при котором слой виден. Обратите внимание, что уровни масштабирования для видимости слоя основаны на уровне масштабирования представления, который может отличаться от уровня масштабирования источника тайлов.
Name Type Description maxZoomnumber Максимальный масштаб слоя.
-
setMinResolution(minResolution) inherited
-
Устанавливает минимальное разрешение, при котором слой виден.
Name Type Description minResolutionnumber Минимальное разрешение слоя.
-
setMinZoom(minZoom) inherited
-
Устанавливает минимальный уровень масштабирования (включительно), при котором слой виден. Обратите внимание, что уровни масштабирования для видимости слоя основаны на уровне масштабирования представления, который может отличаться от уровня масштабирования источника тайлов.
Name Type Description minZoomnumber Минимальный масштаб слоя.
-
setOpacity(opacity) inherited
-
Устанавливает непрозрачность слоя, допустимые значения находятся в диапазоне от 0 до 1.
Name Type Description opacitynumber Непрозрачность слоя.
-
setPreload(preload)
-
Установите уровень в виде числа, до которого будут предварительно загружаться тайлы.
Имя Тип Описание preloadчисло Уровень, до которого предварительно загружать тайлы.
-
setProperties(values, silent) унаследованный
-
Устанавливает коллекцию пар «ключ-значение». Обратите внимание, что это изменяет все существующие свойства и добавляет новые (никаких существующих свойств не удаляется).
Имя Тип Описание valuesObject.<string, *> Значения.
silentboolean | undefined Обновить без срабатывания события.
-
setSource(source) унаследованный
-
Установить источник слоя.
Имя Тип Описание sourceSourceType | null Источник слоя.
-
setStyle(style) унаследованный
-
Установить стиль для объектов. Это может быть один объект стиля, массив стилей или функция, которая принимает объект и разрешение и возвращает массив стилей. Если установлено значение
null, у слоя нет стиля (стильnull), поэтому в слое будут отображаться только объекты, у которых есть собственные стили. ВызовsetStyle()без аргументов сбросит стиль на значение по умолчанию. См.the ol/style/Style moduleдля получения информации о стиле по умолчанию.Если у вашего слоя есть статический стиль, вы можете использовать литералы объектов
flat styleвместо использования конструкторовStyleи символизатора (Fill,Strokeи т.д.):vectorLayer.setStyle({ "fill-color": "yellow", "stroke-color": "black", "stroke-width": 4 })Имя Тип Описание styleStyleLike | FlatStyleLike | null | undefined Стиль слоя.
-
setUseInterimTilesOnError(useInterimTilesOnError)
-
Устарело. Установить, использовать ли промежуточные тайлы при ошибке.
Имя Тип Описание useInterimTilesOnErrorboolean Использовать временные тайлы при ошибке.
-
setVisible(visible) унаследованный
-
Установить видимость слоя (
trueилиfalse).Имя Тип Описание visibleboolean Видимость слоя.
-
setZIndex(zindex) унаследованный
-
Установить индекс Z слоя, который используется для упорядочения слоев перед отрисовкой. Значение индекса Z по умолчанию равно 0.
Имя Тип Описание zindexчисло Индекс Z слоя.
-
un(type, listener) унаследованный
-
Отписаться от определённого типа события.
Имя Тип Описание typeстрока | Array.<string> Тип события или массив типов событий.
listenerфункция Функция обработчика.
-
unset(key, silent) унаследованный
-
Удалить свойство.
Имя Тип Описание keyстрока Имя ключа.
silentboolean | undefined Удалить без срабатывания события.
© 2005-present, OpenLayers Contributors All rights reserved.Licensed under the BSD 2-Clause License.
https://openlayers.org/en/latest/apidoc/module-ol_layer_VectorTile-VectorTileLayer.html