ol/layer/BaseTile~СлойОсноваПлитка
import BaseTileLayer from 'ol/layer/BaseTile.js';
Для источников слоёв, которые предоставляют предварительно рендереные, плиточные изображения в сетках, организованных по уровням масштабирования для определённых разрешений. Обратите внимание, что любой свойство, установленное в параметрах, устанавливается как свойство BaseObject объекта слоя; например, установка title: 'My Title' в параметрах означает, что title наблюдаемый, и имеет аксессоры get/set.
-
новый BaseTileLayer(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 Максимальный уровень масштабирования (включительно) при котором данный слой будет виден.
preloadчисло (по умолчанию 0) Предварительная загрузка. Загрузить плитки с низким разрешением до уровней
preload.0означает отсутствие предварительной загрузки.sourceTileSource | undefined Источник для данного слоя.
mapMap | undefined Устанавливает слой в качестве наложения на карту. Карта не будет управлять этим слоем в своей коллекции слоев, и слой будет отображаться поверх. Это полезно для временных слоев. Стандартный способ добавления слоя на карту и управления им картой - использование
map.addLayer().backgroundBackgroundColor | undefined Цвет фона слоя. Если не указан, фон не будет отображаться.
useInterimTilesOnErrorлогическое значение (по умолчанию true) Устаревшее. Использовать промежуточные плитки при ошибках.
propertiesОбъект.<строка, *> | undefined Произвольные наблюдаемые свойства. Доступны с помощью
#get()и#set().cacheSizeчисло (по умолчанию 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)
-
Подклассы
Расширяет
Наблюдаемые свойства
| Имя | Тип | Устанавливаемое | 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. Требуется только в том случае, если слой не добавлен в карту.Возвращаемое значение:
Атрибуты этого слоя в заданном представлении.
-
getData(pixel){Uint8ClampedArray | Uint8Array | Float32Array | DataView | null}
-
Получение данных для пиксельного расположения. Тип возвращаемых данных зависит от исходных данных. Для изображений, возвращается массив RGBA из четырех элементов. Для данных, длина массива соответствует количеству полос в наборе данных. Для запросов за пределами области слоя, возвращается
null. Данные для изображений могут быть получены только в том случае, если свойствоcrossOriginисточника установлено.// display layer data on every pointer move map.on('pointermove', (event) => { console.log(layer.getData(event.pixel)); });Имя Тип Описание pixelPixel Пиксель.
Возвращаемое значение:
Данные пикселя.
-
Возвращает
extentслоя илиundefined, если он будет отображаться независимо от области.Возвращаемое значение:
Область слоя.
-
Получить список имён свойств объекта.
Возвращаемое значение:
Список имён свойств.
-
getMaxResolution(){number} inherited
-
Возвращает максимальное разрешение слоя. Возвращает Infinity, если для слоя не задано максимальное разрешение.
Возвращаемое значение:
Максимальное разрешение слоя.
-
getMaxZoom(){number} inherited
-
Возвращает максимальный уровень масштабирования слоя. Возвращает Infinity, если для слоя не задан максимальный уровень масштабирования.
Возвращаемое значение:
Максимальный уровень масштабирования слоя.
-
getMinResolution(){number} inherited
-
Возвращает минимальное разрешение слоя. Возвращает 0, если для слоя не задано минимальное разрешение.
Возвращаемое значение:
Минимальное разрешение слоя.
-
getMinZoom(){number} inherited
-
Возвращает минимальный уровень масштабирования слоя. Возвращает -Infinity, если для слоя не задан минимальный уровень масштабирования.
Возвращаемое значение:
Минимальный уровень масштабирования слоя.
-
getOpacity(){number} inherited
-
Возвращает непрозрачность слоя (между 0 и 1).
Возвращаемое значение:
Непрозрачность слоя.
-
getPreload(){number}
-
Возвращает уровень, до которого будут загружены предварительные плитки.
Возвращаемое значение:
Уровень предварительной загрузки плиток.
-
Получить объект со всеми именами и значениями свойств.
Возвращает:
Объект.
-
getRevision(){number} inherited
-
Получить номер версии этого объекта. Каждый раз, когда объект изменяется, его номер версии увеличивается.
Возвращает:
Номер версии.
-
getSource(){SourceType | null} inherited
-
Получить источник слоя.
Возвращает:
Источник слоя (илиnull, если он ещё не задан).
-
getUseInterimTilesOnError(){boolean}
-
Устарело. Используются ли временные тайлы при ошибке.
Возвращает:
Используются ли временные тайлы при ошибке.
-
getVisible(){boolean} inherited
-
Возвращает значение свойства
visibleэтого слоя. Чтобы определить, виден ли слой на карте, используйтеisVisible()вместо этого.Возвращает:
Значение свойстваvisibleслоя.
-
getZIndex(){number | undefined} inherited
-
Возвращает Z-индекс слоя, используемый для упорядочения слоев перед отрисовкой. Возвращает undefined, если слой не управляется.
Возвращает:
Z-индекс слоя.
-
isVisible(view){boolean} inherited
-
Слой виден на представлении карты, т.е. внутри минимального/максимального разрешения или масштаба и области, не установлен в
visible: falseи не находится внутри группы слоев, установленной вvisible: false.Имя Тип Описание view View | ViewStateLayerStateExtent | undefined Представление или
FrameState. Требуется только тогда, когда слой не добавлен на карту.Возвращает:
Слой виден на представлении карты.
-
Прослушивать определённый тип события.
Имя Тип Описание type string | Array.<string> Тип события или массив типов событий.
listener function Функция-обработчик.
Возвращает:
Уникальный ключ для обработчика. Если вызов выполняется с массивом типов событий в качестве первого аргумента, возвращаемое значение будет массивом ключей.
-
Прослушивать один раз определённый тип события.
Имя Тип Описание type string | Array.<string> Тип события или массив типов событий.
listener function Функция-обработчик.
Возвращает:
Уникальный ключ для обработчика. Если вызов выполняется с массивом типов событий в качестве первого аргумента, возвращаемое значение будет массивом ключей.
-
Устанавливает значение.
Имя Тип Описание key string Имя ключа.
value * Значение.
silent boolean | undefined Обновить без срабатывания события.
-
setExtent(extent) inherited
-
Установить область, в которой слой виден. Если
undefined, слой будет виден во всех областях.Имя Тип Описание extent Extent | undefined Область слоя.
-
setMap(map) inherited
-
Устанавливает слой, который должен отображаться поверх других слоёв на карте. Карта не будет управлять этим слоем в своём списке слоёв. Это полезно для временных слоёв. Чтобы удалить неуправляемый слой с карты, используйте
#setMap(null).Чтобы добавить слой на карту и управлять им с помощью карты, используйте
addLayerвместо этого.Имя Тип Описание mapКарта | null Карта.
-
setMaxResolution(maxResolution) унаследованно
-
Установить максимальное разрешение, при котором слой отображается.
Имя Тип Описание maxResolutionчисло Максимальное разрешение слоя.
-
setMaxZoom(maxZoom) унаследованно
-
Установить максимальный масштаб (исключительно), при котором слой отображается. Обратите внимание, что уровни масштабирования для видимости слоя основаны на уровне масштабирования представления, который может отличаться от уровня масштабирования источника плиток.
Имя Тип Описание maxZoomчисло Максимальный масштаб слоя.
-
setMinResolution(minResolution) унаследованно
-
Установить минимальное разрешение, при котором слой отображается.
Имя Тип Описание minResolutionчисло Минимальное разрешение слоя.
-
setMinZoom(minZoom) унаследованно
-
Установить минимальный масштаб (включительно), при котором слой отображается. Обратите внимание, что уровни масштабирования для видимости слоя основаны на уровне масштабирования представления, который может отличаться от уровня масштабирования источника плиток.
Имя Тип Описание minZoomчисло Минимальный масштаб слоя.
-
setOpacity(opacity) унаследованно
-
Установить непрозрачность слоя, допустимые значения находятся в диапазоне от 0 до 1.
Имя Тип Описание opacityчисло Непрозрачность слоя.
-
setPreload(preload)
-
Установить уровень, до которого будут предварительно загружаться плитки.
Имя Тип Описание preloadчисло Уровень, до которого будут предварительно загружаться плитки.
-
setProperties(values, silent) унаследованно
-
Устанавливает набор пар «ключ-значение». Обратите внимание, что это изменяет любые существующие свойства и добавляет новые (не удаляет существующие свойства).
Имя Тип Описание valuesОбъект.<строка, *> Значения.
silentлогическое | undefined Обновить без срабатывания события.
-
setSource(source) унаследованно
-
Установить источник слоя.
Имя Тип Описание sourceSourceType | null Источник слоя.
-
setUseInterimTilesOnError(useInterimTilesOnError)
-
Устарело. Установить, использовать ли временные плитки при ошибке.
Имя Тип Описание useInterimTilesOnErrorлогическое Использовать временные плитки при ошибке.
-
setVisible(visible) унаследованно
-
Установить видимость слоя (
trueилиfalse).Имя Тип Описание visibleлогическое Видимость слоя.
-
setZIndex(zindex) унаследованно
-
Установить индекс Z слоя, который используется для упорядочивания слоёв перед рендерингом. Значение по умолчанию 0.
Имя Тип Описание zindexчисло Индекс Z слоя.
-
un(type, listener) унаследованный
-
Отписаться от определенного типа события.
Имя Тип Описание typeстрока | Массив.<строка> Тип события или массив типов событий.
listenerфункция Функция-обработчик.
-
unset(key, silent) унаследованный
-
Сброс свойства.
Имя Тип Описание keyстрока Имя ключа.
silentлогическое | undefined Сбросить без срабатывания события.
© 2005-present, OpenLayers Contributors All rights reserved.Licensed under the BSD 2-Clause License.
https://openlayers.org/en/latest/apidoc/module-ol_layer_BaseTile-BaseTileLayer.html