ol/source/OGCMapTile~OGCMapTile
import OGCMapTile from 'ol/source/OGCMapTile.js';
Источник слоя для картографических тайлов из сервиса OGC API - Tiles, предоставляющего тайлы типа «карта». Сервис должен соответствовать как минимум классам соответствия core (http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/core) и tileset (http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/tileset). Для поддержки параметра collections сервис должен соответствовать классу соответствия collections selection (http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/collections-selection).
-
new OGCMapTile(options)
-
Имя Тип Описание urlstring URL конечной точки набора тайлов OGC Map.
contextObject | undefined Сопоставление значений для использования в шаблоне URL тайла. Переменные
{tileMatrix}(уровень масштабирования),{tileRow}и{tileCol}в URL всегда будут предоставляться источником.mediaTypestring | undefined Тип содержимого тайлов (например, "image/png"). Если он не указан, источник попытается найти ссылку с rel="item", в которой используется поддерживаемый тип изображения.
projectionProjectionLike | undefined Проекция. По умолчанию проекция определяется по
crsобъектаtileMatrixSet. Это значение можно переопределить, указав проекцию в конструкторе.attributionsAttributionLike | undefined Атрибуция.
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 (по умолчанию true) Использовать интерполированные значения при передискретизации. По умолчанию при передискретизации используется линейная интерполяция. Установите значение false, чтобы использовать интерполяцию методом ближайшего соседа.
reprojectionErrorThresholdnumber (по умолчанию 0.5) Максимально допустимая погрешность перепроецирования (в пикселях). Более высокие значения могут повысить производительность перепроецирования, но снизить точность.
tileLoadFunctionLoadFunction | undefined Необязательная функция для загрузки тайла по URL. По умолчанию используется
function(tile, src) { tile.getImage().src = src; };wrapXboolean (по умолчанию true) Определяет, следует ли зацикливать мир по горизонтали.
transitionnumber | undefined Длительность перехода прозрачности при отрисовке. Чтобы отключить переход прозрачности, передайте
transition: 0.collectionsArray.<string> | undefined Список подресурсов пространственных данных, которые нужно включить. Если список не указан, включается весь набор данных. Этот параметр не применяется при запросе набора тайлов для отдельной коллекции.
События:
-
change(BaseEvent) — Общее событие изменения. Вызывается при увеличении счётчика ревизий. -
error(BaseEvent) — Общее событие ошибки. Вызывается при возникновении ошибки. -
propertychange(ObjectEvent) — Вызывается при изменении свойства. -
tileloadend(TileSourceEvent) — Вызывается по завершении загрузки тайла: после загрузки его данных или после отмены загрузки, если тайл больше не нужен. -
tileloaderror(TileSourceEvent) — Вызывается, если при загрузке тайла произошла ошибка. Обратите внимание, что это событие не предназначено для повторной загрузки тайлов. Подробнее см.load. -
tileloadstart(TileSourceEvent) — Вызывается при начале загрузки тайла.
-
Расширяет
Методы
-
changed() унаследовано
-
Увеличивает счётчик ревизий и отправляет событие «change».
-
clear() унаследовано
-
Удаляет все кэшированные перепроецированные тайлы из источника. В следующем цикле отрисовки будут созданы новые тайлы.
-
dispatchEvent(event){boolean | undefined} унаследовано
-
Отправляет событие и вызывает все обработчики, ожидающие события этого типа. Параметр event может быть строкой или объектом со свойством
type.Имя Тип Описание eventBaseEvent | string Объект события.
Возвращает:
false, если кто-либо вызвал preventDefault для объекта события или если какой-либо обработчик вернул false.
-
get(key){*} унаследовано
-
Получает значение.
Имя Тип Описание keystring Имя ключа.
Возвращает:
Значение.
-
getAttributions(){Attribution} унаследовано
-
Получает функцию атрибуции источника.
Возвращает:
Функция атрибуции.
-
getAttributionsCollapsible(){boolean} унаследовано
-
Возвращает:
Атрибуции можно сворачивать.
-
getKeys(){Array.<string>} унаследовано
-
Получает список имён свойств объекта.
Возвращает:
Список имён свойств.
-
getProjection(){Projection | null} унаследовано
-
Получает проекцию источника.
Возвращает:
Проекция.
-
getProperties(){NoInfer.<Properties>} унаследовано
-
Получает объект со всеми именами свойств и их значениями.
Возвращает:
Объект.
-
getRevision(){number} унаследовано
-
Получает номер версии этого объекта. При каждом изменении объекта номер его версии увеличивается.
Возвращает:
Ревизия.
-
getState(){State} унаследовано
-
Получает состояние источника. Возможные состояния см. в разделе
State.Возвращает:
Состояние.
-
getTileGrid(){TileGrid | null} унаследовано
-
Возвращает сетку тайлов источника.
Возвращает:
Сетка тайлов.
-
getTileLoadFunction(){LoadFunction} унаследовано
-
Устарело. Вместо этого используйте источник ImageTile. Возвращает функцию загрузки тайлов источника.
Возвращает:
TileLoadFunction
-
getTileUrlFunction(){UrlFunction} унаследовано
-
Устарело. Вместо этого используйте источник ImageTile. Возвращает функцию URL тайла источника.
Возвращает:
TileUrlFunction
-
getUrls(){!Array.<string> | null} унаследовано
-
Устарело. Вместо этого используйте источник ImageTile. Возвращает URL-адреса, используемые для этого источника. Если вместо url или urls используется tileUrlFunction, будет возвращено значение null.
Возвращает:
URL-адреса.
-
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.
-
setUrls(urls) унаследовано
-
Устарело. Вместо этого используйте источник ImageTile. Задаёт URL-адреса для запросов.
Имя Тип Описание urlsArray.<string> URL-адреса.
-
un(type, listener) унаследовано
-
Прекращает прослушивание событий указанного типа.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-обработчик.
-
unset(key, silent) унаследовано
-
Удаляет свойство.
Имя Тип Описание keystring Имя ключа.
silentboolean | undefined Удалить без отправки события.
© 2005-present, OpenLayers Contributors All rights reserved.Licensed under the BSD 2-Clause License.
https://openlayers.org/en/latest/apidoc/module-ol_source_OGCMapTile-OGCMapTile.html