ol/source/WMTS~WMTS
import WMTS from 'ol/source/WMTS.js';
Источник слоя для тайловых данных с серверов WMTS.
-
new WMTS(options)
-
Имя Тип Описание attributionsAttributionLike | undefined Атрибуция.
attributionsCollapsibleboolean (defaults to true) Атрибуция может быть свёрнута.
cacheSizenumber | undefined Устарело. Вместо этого используйте параметр cacheSize слоя.
crossOriginnull | string | undefined Атрибут
crossOriginдля загруженных изображений. Обратите внимание: чтобы получить доступ к данным пикселей с помощью средства визуализации Canvas, необходимо указать значениеcrossOrigin. Подробнее см. https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_enabled_image.referrerPolicyReferrerPolicy | undefined Свойство
referrerPolicyдля загруженных изображений.interpolateboolean (defaults to true) Использовать интерполированные значения при передискретизации. По умолчанию при передискретизации используется линейная интерполяция. Установите значение false, чтобы использовать интерполяцию методом ближайшего соседа.
tileGridWMTSTileGrid Сетка тайлов.
projectionProjectionLike | undefined Проекция. По умолчанию используется проекция представления.
reprojectionErrorThresholdnumber (defaults to 0.5) Максимально допустимая ошибка перепроецирования (в пикселях). Более высокие значения могут повысить производительность перепроецирования, но снизить точность.
requestEncodingRequestEncoding (defaults to 'KVP') Кодирование запроса.
layerstring Имя слоя, указанное в описании возможностей WMTS.
stylestring Имя стиля, указанное в описании возможностей WMTS.
tileClassClass<ImageTile> | undefined Класс для создания тайлов изображений. По умолчанию используется
ImageTile.tilePixelRationumber (defaults to 1) Коэффициент пикселей, используемый тайловым сервисом. Например, если тайловый сервис заявляет о тайлах размером 256 × 256 пикселей, но фактически передаёт изображения размером 512 × 512 пикселей (для устройств Retina/HiDPI), то для
tilePixelRatioследует задать значение2.formatstring (defaults to 'image/jpeg') Формат изображения. Используется только если
requestEncodingимеет значение'KVP'.versionstring (defaults to '1.0.0') Версия WMTS.
matrixSetstring Набор матриц.
dimensionsObject | undefined Дополнительные «измерения» для запросов тайлов. Это объект со свойствами, имена которых совпадают с именами измерений, указанными в описании возможностей WMTS.
urlstring | undefined URL сервиса. При кодировании RESTful-запросов это шаблон URL. При кодировании KVP — обычный URL. Вместо определения каждого URL отдельно в параметре
urlsможно использовать шаблон{?-?}, напримерsubdomain{a-f}.domain.com.tileLoadFunctionLoadFunction | undefined Необязательная функция загрузки тайла по URL. По умолчанию используется
function(imageTile, src) { imageTile.getImage().src = src; };urlsArray.<string> | undefined Массив URL. Запросы будут распределяться между URL из этого массива.
wrapXboolean (defaults to false) Следует ли оборачивать мир по горизонтали.
transitionnumber | undefined Длительность перехода прозрачности при отрисовке. Чтобы отключить переход прозрачности, передайте
transition: 0.zDirectionnumber | NearestDirectionFunction (defaults to 0) Выберите, использовать ли тайлы с более высоким или низким уровнем масштаба, если масштаб находится между целыми значениями. Подробнее см.
getZForResolution.События:
-
change(BaseEvent) — Общее событие изменения. Вызывается при увеличении счётчика ревизий. -
error(BaseEvent) — Общее событие ошибки. Вызывается при возникновении ошибки. -
propertychange(ObjectEvent) — Вызывается при изменении свойства. -
tileloadend(TileSourceEvent) — Вызывается после завершения загрузки тайла: когда его данные загружены или когда загрузка прервана, поскольку тайл больше не нужен. -
tileloaderror(TileSourceEvent) — Вызывается, если при загрузке тайла произошла ошибка. Обратите внимание: это событие не следует использовать для повторной загрузки тайлов. Подробнее см.load. -
tileloadstart(TileSourceEvent) — Вызывается при начале загрузки тайла.
-
Наследует
Методы
-
changed() унаследовано
-
Увеличивает счётчик ревизий и генерирует событие «change».
-
clear() унаследовано
-
Удаляет все кэшированные перепроецированные тайлы из источника. В следующем цикле отрисовки будут созданы новые тайлы.
-
dispatchEvent(event){boolean | undefined} унаследовано
-
Отправляет событие и вызывает все обработчики, ожидающие события этого типа. Параметр события может быть строкой или объектом со свойством
type.Имя Тип Описание eventBaseEvent | string Объект события.
Возвращает:
false, если кто-либо вызвал preventDefault для объекта события или если любой из обработчиков вернул false.
-
get(key){*} унаследовано
-
Получает значение.
Имя Тип Описание keystring Имя ключа.
Возвращает:
Значение.
-
getAttributions(){Attribution} унаследовано
-
Получает функцию атрибуции источника.
Возвращает:
Функция атрибуции.
-
getAttributionsCollapsible(){boolean} унаследовано
-
Возвращает:
Атрибуции можно сворачивать.
-
getDimensions(){Object}
-
Получает измерения, то есть значения, переданные конструктору через параметр "dimensions" и, возможно, обновлённые с помощью метода updateDimensions.
Возвращает:
Измерения.
-
getFormat(){string}
-
Возвращает формат изображения источника WMTS.
Возвращает:
Формат.
-
getKeys(){Array.<string>} унаследовано
-
Получает список имён свойств объекта.
Возвращает:
Список имён свойств.
-
getLayer(){string}
-
Возвращает слой источника WMTS.
Возвращает:
Слой.
-
getMatrixSet(){string}
-
Возвращает набор матриц источника WMTS.
Возвращает:
Набор матриц.
-
getProjection(){Projection | null} унаследовано
-
Получает проекцию источника.
Возвращает:
Проекция.
-
getProperties(){NoInfer.<Properties>} унаследовано
-
Получает объект со всеми именами свойств и их значениями.
Возвращает:
Объект.
-
getRequestEncoding(){RequestEncoding}
-
Возвращает способ кодирования запроса: "KVP" или "REST".
Возвращает:
Способ кодирования запроса.
-
getRevision(){number} унаследовано
-
Получает номер версии этого объекта. При каждом изменении объекта номер его версии увеличивается.
Возвращает:
Номер ревизии.
-
getState(){State} унаследовано
-
Получает состояние источника. Возможные состояния см. в
State.Возвращает:
Состояние.
-
getStyle(){string}
-
Возвращает стиль источника WMTS.
Возвращает:
Стиль.
-
getTileGrid(){TileGrid | null} унаследовано
-
Возвращает сетку тайлов источника.
Возвращает:
Сетка тайлов.
-
getTileLoadFunction(){LoadFunction} унаследовано
-
Устарело. Вместо этого используйте источник ImageTile. Возвращает функцию загрузки тайлов источника.
Возвращает:
TileLoadFunction
-
getTileUrlFunction(){UrlFunction} унаследовано
-
Устарело. Вместо этого используйте источник ImageTile. Возвращает функцию URL тайла источника.
Возвращает:
TileUrlFunction
-
getUrls(){!Array.<string> | null} унаследовано
-
Устарело. Вместо этого используйте источник ImageTile. Возвращает URL-адреса, используемые для этого источника. Если вместо url или urls используется tileUrlFunction, будет возвращено null.
Возвращает:
URL-адреса.
-
getVersion(){string}
-
Возвращает версию источника WMTS.
Возвращает:
Версия.
-
on(type, listener){EventsKey | Array<EventsKey>} унаследовано
-
Ожидает событие указанного типа.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-обработчик.
Возвращает:
Уникальный ключ обработчика. Если первым аргументом передан массив типов событий, будет возвращён массив ключей.
-
once(type, listener){EventsKey | Array<EventsKey>} унаследовано
-
Ожидает однократное возникновение события указанного типа.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-обработчик.
Возвращает:
Уникальный ключ обработчика. Если первым аргументом передан массив типов событий, будет возвращён массив ключей.
-
refresh() унаследовано
-
Обновляет источник. Данные источника будут очищены, а данные с сервера загружены заново.
-
set(key, value, silent) унаследовано
-
Задаёт значение.
Имя Тип Описание keystring Имя ключа.
value* Значение.
silentboolean | undefined Обновить без генерации события.
-
setAttributions(attributions) унаследовано
-
Задаёт атрибуции источника.
Имя Тип Описание attributionsAttributionLike | undefined Атрибуции. Можно передать как
string,Array<string>,Attributionилиundefined. -
setProperties(values, silent) унаследовано
-
Задаёт набор пар «ключ — значение». Обратите внимание: существующие свойства будут изменены, а новые — добавлены (имеющиеся свойства не удаляются).
Имя Тип Описание valuesPartial.<NoInfer.<Properties>> Значения.
silentboolean | undefined Обновить без генерации события.
-
setRenderReprojectionEdges(render) унаследовано
-
Задаёт, нужно ли отображать границы перепроецирования (обычно для отладки).
Имя Тип Описание renderboolean Отображать границы.
-
setTileGridForProjection(projection, tilegrid) унаследовано
-
Задаёт сетку тайлов, которая будет использоваться при перепроецировании тайлов в указанную проекцию вместо сетки тайлов по умолчанию для этой проекции.
Это может быть полезно, если сетку тайлов по умолчанию невозможно создать (например, для проекции не задана область охвата) или по соображениям оптимизации (пользовательский размер тайла, разрешения и т. д.).
Имя Тип Описание projectionProjectionLike Проекция.
tilegridTileGrid Сетка тайлов для этой проекции.
-
setTileLoadFunction(tileLoadFunction) унаследовано
-
Устарело. Вместо этого используйте источник ImageTile. Задаёт функцию загрузки тайлов источника.
Имя Тип Описание tileLoadFunctionLoadFunction Функция загрузки тайлов.
-
setTileUrlFunction(tileUrlFunction, key) унаследовано
-
Устарело. Вместо этого используйте источник ImageTile. Задаёт функцию URL тайла источника.
Имя Тип Описание tileUrlFunctionUrlFunction Функция URL тайла.
keystring | undefined Необязательный новый ключ тайла для источника.
-
setUrl(url) унаследовано
-
Задаёт URL для запросов.
Имя Тип Описание urlstring URL.
-
un(type, listener) унаследовано
-
Прекращает ожидание события указанного типа.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-обработчик.
-
unset(key, silent) унаследовано
-
Удаляет свойство.
Имя Тип Описание keystring Имя ключа.
silentboolean | undefined Удалить без генерации события.
-
updateDimensions(dimensions)
-
Обновить измерения.
Имя Тип Описание dimensionsObject Измерения.
© 2005-present, OpenLayers Contributors All rights reserved.Licensed under the BSD 2-Clause License.
https://openlayers.org/en/latest/apidoc/module-ol_source_WMTS-WMTS.html