ol/source/OSM~OSM
import OSM from 'ol/source/OSM.js';
Источник слоя для тайлового сервера OpenStreetMap.
-
new OSM(options)
-
Имя Тип Описание attributionsAttributionLike | undefined Атрибуция.
cacheSizenumber | undefined Устарело. Используйте параметр cacheSize слоя.
crossOriginnull | string (defaults to 'anonymous') Атрибут
crossOriginдля загруженных изображений. Обратите внимание, что для доступа к данным пикселей с помощью средства визуализации Canvas необходимо указать значениеcrossOrigin. Подробнее см. https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_enabled_image.referrerPolicyReferrerPolicy (defaults to 'origin-when-cross-origin') Свойство
referrerPolicyдля загруженных изображений.interpolateboolean (defaults to true) Использовать интерполированные значения при передискретизации. По умолчанию при передискретизации используется линейная интерполяция. Установите значение false, чтобы вместо неё использовать интерполяцию ближайшего соседа.
maxZoomnumber (defaults to 19) Максимальный масштаб.
reprojectionErrorThresholdnumber (defaults to 0.5) Максимально допустимая ошибка перепроецирования (в пикселях). Более высокие значения могут повысить производительность перепроецирования, но снизить точность.
tileLoadFunctionLoadFunction | undefined Необязательная функция для загрузки тайла по URL. По умолчанию используется
function(imageTile, src) { imageTile.getImage().src = src; };transitionnumber (defaults to 250) Длительность перехода прозрачности при визуализации. Чтобы отключить переход прозрачности, передайте
transition: 0.urlstring (defaults to 'https://tile.openstreetmap.org/{z}/{x}/{y}.png') Шаблон URL. Должен содержать заполнители
{x},{y}или{-y}, а также{z}.wrapXboolean (defaults to true) Определяет, следует ли циклически повторять мир по горизонтали.
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} унаследовано
-
Отправляет событие и вызывает все обработчики, подписанные на события этого типа. Параметр 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_OSM-OSM.html