类:OGCMapTile

ol/source/OGCMapTile~OGC地图瓦片


import OGCMapTile from 'ol/source/OGCMapTile.js';

图层数据源用于从OGC API - Tiles服务获取提供“地图”类型瓦片的服务。该服务必须符合至少核心(http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/core)和瓦片集(http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/tileset)一致性类。为支持collections选项,该服务必须符合集合选择(http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/collections-selection)一致性类。

new OGCMapTile(options)

Name Type 描述
url string

OGC地图图块集端点的URL

context Object | undefined

用于瓦片URL模板的值查找。{tileMatrix}(缩放级别),{tileRow}{tileCol}URL中的变量将始终由数据源提供。

mediaType string | undefined

瓦片的内容类型(例如“image/png”)。若未提供,源将尝试查找使用支持图像类型的 rel="item" 链接。

projection ProjectionLike | undefined

投影。默认情况下,投影将源自crstileMatrixSet您可以通过向构造函数传入投影来覆盖它。

attributions AttributionLike | undefined

版权信息。

cacheSize number | undefined

已弃用。请改用图层上的 cacheSize 选项。

crossOrigin null | string | undefined

crossOrigin 属性指示图像的加载状态。请注意:通过Canvas渲染器访问像素数据时,必须使用 crossOrigin 值。参见文档(https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_enabled_image)了解更多详情。

interpolate boolean (defaults to true)

重采样时,插值方法默认为线性插值;若设置为 false,则使用最近邻插值。

reprojectionErrorThreshold number (defaults to 0.5)

允许的最大重投影误差(像素)。较高的阈值可提升重投影性能,但会牺牲精度。

tileLoadFunction LoadFunction | undefined

用于根据给定URL加载瓦片的可选函数。默认为

function(tile, src) {
  tile.getImage().src = src;
};
wrapX boolean (defaults to true)

是否启用水平世界包裹?

transition number | undefined

渲染时透明度过渡的持续时间。要禁用透明度过渡,请传递transition: 0.

collections Array.<string> | undefined

需包含的地理空间数据子资源列表。若未指定,则默认包含整个数据集。请求单个集合的图块集时,此选项不适用。

触发事件:

继承

方法

增加修订计数器并触发更改事件。

从数据源中清除所有缓存的重新投影瓦片。下一渲染周期将生成新的瓦片。

dispatchEvent(event){boolean | undefined} inherited

分发事件并调用所有监听此类型事件的侦听器。事件参数可以是字符串,也可以是具有 type 属性的对象。

Name Type 描述
event BaseEvent | string

事件对象。

返回:
false 如果事件对象上调用了 preventDefault 或任何侦听器返回 false。

获取一个值。

Name Type 描述
key string

键名

返回:
值。

获取源的归属函数。

返回:
版权控件

getAttributionsCollapsible(){boolean} inherited

返回:
版权信息是可折叠的。

getKeys(){Array.<string>} inherited

获取对象属性名称列表。

返回:
属性名列表。

getProjection(){Projection | null} inherited

获取源的投影。

返回:
投影.

getProperties(){Object.<string, *>} inherited

获取包含所有属性名及其对应值的对象。

返回:
对象。

getRevision(){number} inherited

获取此对象的版本号。每次修改对象时,其版本号将递增。

返回:
修订。

获取源的状态,请参阅 State 了解可能的状态。

返回:
状态。

getTileGrid(){TileGrid | null} inherited

返回图块源的图块网格。

返回:
瓦片 网格.

已弃用。请使用 ImageTile 源代替。返回源的瓦片加载函数。

返回:
瓦片加载函数

已弃用。请改用图像瓦片源。返回源的瓦片URL函数。

返回:
瓦片URL函数

getUrls(){!Array.<string> | null} inherited

已弃用。请改用 ImageTile 源。返回此源所使用的 URL。当使用 tileUrlFunction 而非 url 或 urls 时,将返回 null。

返回:
网址。

on(type, listener){EventsKey | Array<EventsKey>} inherited

监听特定类型的事件。

Name Type 描述
type string | Array.<string>

事件类型或事件类型数组。

listener function

监听器函数。

返回:
监听器的唯一键。若以事件类型数组作为第一个参数调用,则返回键的数组。

once(type, listener){EventsKey | Array<EventsKey>} inherited

一次性监听特定类型的事件。

Name Type 描述
type string | Array.<string>

事件类型或事件类型数组。

listener function

监听器函数。

返回:
监听器的唯一键:当以事件类型数组作为第一个参数调用时,返回键数组。

set(key, value, silent) inherited

设置值。

Name Type 描述
key string

键名。

value *

值。

silent boolean | undefined

更新且不触发事件。

setAttributions(attributions) inherited

设置源的归属信息。

Name Type 描述
attributions AttributionLike | undefined

版权信息。 可作为参数传递string, Array<string>, Attribution,或者undefined.

setProperties(values, silent) inherited

设置键值对集合。注意:此操作将修改现有属性并添加新属性,但不会删除任何现有属性。

Name Type 描述
values Object.<string, *>

值。

silent boolean | undefined

更新不触发事件。

setRenderReprojectionEdges(render) inherited

设置是否渲染重投影边缘(通常用于调试)。

Name Type 描述
render boolean

渲染边界。

setTileGridForProjection(projection, tilegrid) inherited

设置用于将瓦片重投影到指定投影的瓦片网格,而非该投影的默认瓦片网格。

当默认图块网格无法生成(例如投影范围未定义)或为优化目的(如自定义图块大小、分辨率等)时,这可能很有用。

Name Type 描述
projection ProjectionLike

投影.

tilegrid TileGrid

用于投影的瓦片网格。

setTileLoadFunction(tileLoadFunction) inherited

已弃用。请改用 ImageTile 源。 设置源的瓦片加载函数。

Name Type 描述
tileLoadFunction LoadFunction

瓦片加载函数。

setTileUrlFunction(tileUrlFunction, key) inherited

已弃用。请改用 ImageTile 源。设置源的瓦片URL函数。

Name Type 描述
tileUrlFunction UrlFunction

瓦片URL函数

key string | undefined

源的可选新瓦片键。

设置请求的URL。

Name Type 描述
url string

网址。

已弃用。请改用图像瓦片源。设置请求的URL。

Name Type 描述
urls Array.<string>

网址

un(type, listener) inherited

取消对特定类型事件的监听。

Name Type 描述
type string | Array.<string>

事件类型或事件类型数组。

listener function

监听器函数

unset(key, silent) inherited

移除属性。

Name Type 描述
key string

键名

silent boolean | undefined

取消设置且不触发事件。