WebMapTileServiceImageryProvider

new SuperMap3D.WebMapTileServiceImageryProvider(options)

提供由 WMTS 1.0.0 兼容服务器提供的切图影像。 该提供程序支持 HTTP KVP 编码和 RESTful GetTile 请求，但还不支持 SOAP 编码。
Name Type Description
options Object 具有以下属性的对象:
Name Type Default Description
url String WMTS GetTile 操作的基本URL（用于 KVP 编码请求）或 瓦片-URL 模板（用于 RESTful 请求）。 瓦片URL模板应包含以下变量：{style}、{TileMatrixSet}、{TileMatrix}、{TileRow}、{TileCol}。如果实际值是硬编码或服务器不需要，前两个值是可选的。 {s}关键字可用于指定子域。
format String 'image/jpeg' optional 从服务器获取影像的 MIME 类型。
layer String WMTS请求的层名称。
style String WMTS 请求的样式名称。
tileMatrixSetID String 用于 WMTS 请求的 TileMatrixSet 的标识符。
tileMatrixLabels Array optional 瓦片矩阵中用于 WMTS 请求的标识符列表，每个瓦片矩阵级别一个。
clock Clock optional 时钟实例，用于确定时间维度的值。指定 options.times 时必须使用。
times TimeIntervalCollection optional TimeIntervalCollection 的数据属性是一个包含时间动态维度及其值的对象。
dimensions Object optional 包含静态尺寸及其值的对象。
tileWidth Number 256 optional 瓦片宽度，单位为像素。
tileHeight Number 256 optional 瓦片高度，单位为像素。
tilingScheme TilingScheme optional 与 TileMatrixSet 中的瓦片组织相对应的切图方案。
proxy Object optional 用于请求的代理。该对象应具有一个 getURL 函数，用于返回代理 URL。
rectangle Rectangle Rectangle.MAX_VALUE optional 图层覆盖的矩形区域。
minimumLevel Number 0 optional 影像提供者支持的最小细节级别。
maximumLevel Number optional 影像提供者支持的最大细节级别，如果没有限制则为undefined。
ellipsoid Ellipsoid optional 椭球。如果未指定，则使用WGS84椭球。
credit Credit | String optional 数据源的凭证，显示在画布上。
subdomains String | Array.<String> 'abc' optional URL模板中{s}占位符要使用的子域。如果是单个字符串，则字符串中的每个字符表示一个子域。如果是数组，则数组中的每个元素都是一个子域。
Examples:
// Example 1. USGS shaded relief tiles (KVP)
var shadedRelief1 = new SuperMap3D.WebMapTileServiceImageryProvider({
    url : 'http://basemap.nationalmap.gov/arcgis/rest/services/USGSShadedReliefOnly/MapServer/WMTS',
    layer : 'USGSShadedReliefOnly',
    style : 'default',
    format : 'image/jpeg',
    tileMatrixSetID : 'default028mm',
    // tileMatrixLabels : ['default028mm:0', 'default028mm:1', 'default028mm:2' ...],
    maximumLevel: 19,
    credit : new SuperMap3D.Credit('U. S. Geological Survey')
});
viewer.imageryLayers.addImageryProvider(shadedRelief1);
// Example 2. USGS shaded relief tiles (RESTful)
var shadedRelief2 = new SuperMap3D.WebMapTileServiceImageryProvider({
    url : 'http://basemap.nationalmap.gov/arcgis/rest/services/USGSShadedReliefOnly/MapServer/WMTS/tile/1.0.0/USGSShadedReliefOnly/{Style}/{TileMatrixSet}/{TileMatrix}/{TileRow}/{TileCol}.jpg',
    layer : 'USGSShadedReliefOnly',
    style : 'default',
    format : 'image/jpeg',
    tileMatrixSetID : 'default028mm',
    maximumLevel: 19,
    credit : new SuperMap3D.Credit('U. S. Geological Survey')
});
viewer.imageryLayers.addImageryProvider(shadedRelief2);
// Example 3. NASA time dynamic weather data (RESTful)
var times = SuperMap3D.TimeIntervalCollection.fromIso8601({
    iso8601: '2015-07-30/2017-06-16/P1D',
    dataCallback: function dataCallback(interval, index) {
        return {
            Time: SuperMap3D.JulianDate.toIso8601(interval.start)
        };
    }
});
var weather = new SuperMap3D.WebMapTileServiceImageryProvider({
    url : 'https://gibs.earthdata.nasa.gov/wmts/epsg4326/best/AMSR2_Snow_Water_Equivalent/default/{Time}/{TileMatrixSet}/{TileMatrix}/{TileRow}/{TileCol}.png',
    layer : 'AMSR2_Snow_Water_Equivalent',
    style : 'default',
    tileMatrixSetID : '2km',
    maximumLevel : 5,
    format : 'image/png',
    clock: clock,
    times: times,
    credit : new SuperMap3D.Credit('NASA Global Imagery Browse Services for EOSDIS')
});
viewer.imageryLayers.addImageryProvider(weather);
See:

Members

clock : Clock

获取或设置用于保持时间动态参数所用时间的时钟。

readonlycredit : Credit

获取该影像提供者激活时要显示的凭证。通常情况下，这将用于标明影像来源。此函数不应在 WebMapTileServiceImageryProvider#ready 返回 true 之前调用。

dimensions : Object

获取或设置包含静态尺寸及其值的对象。

readonlyerrorEvent : Event

获取当影像提供程序遇到异步错误时引发的事件。通过订阅事件，您将收到错误通知，并有可能从中恢复。事件监听器被传递一个TileProviderError的实例。

readonlyformat : String

获取该影像提供程序返回的影像的 mime 类型。

readonlyhasAlphaChannel : Boolean

获取指示该影像提供程序提供的影像是否包含 alpha 通道的值。 如果该属性为 false，则会忽略存在的 alpha 通道。 如果该属性为 true，任何不包含 alpha 通道的影像都将被视为其 alpha 值为 1.0 的影像。此属性为false时，内存使用量和纹理上传时间都会减少。

readonlymaximumLevel : Number

获取可请求的最大精细级别。这个函数不应该在WebMapTileServiceImageryProvider#ready返回true之前被调用。

readonlyminimumLevel : Number

获取可请求的最小精细级别。这个函数不应该在WebMapTileServiceImageryProvider#ready返回true之前被调用。

readonlyproxy : Proxy

获取此提供程序使用的代理。

readonlyready : Boolean

获取表示提供程序是否可以使用的值。

readonlyreadyPromise : Promise.<Boolean>

获取当提供程序准备就绪时解析为 true 的Promise。

readonlyrectangle : Rectangle

获取此实例提供的影像的矩形范围，以弧度为单位。在WebMapTileServiceImageryProvider#ready返回真之前，不应调用此函数。

readonlytileDiscardPolicy : TileDiscardPolicy

获取瓦片丢弃策略。如果未定义，丢弃策略负责通过其shouldDiscardImage函数过滤掉“缺失”的瓦片。如果这个函数返回undefined，则没有瓦片被过滤。在WebMapTileServiceImageryProvider#ready返回true之前，不应调用此函数。

readonlytileHeight : Number

获取每个瓦片的高度(以像素为单位)。这个函数不应该在WebMapTileServiceImageryProvider#ready返回true之前被调用。

readonlytileWidth : Number

获取每个瓦片的宽度(以像素为单位)。这个函数不应该在WebMapTileServiceImageryProvider#ready返回true之前被调用。

readonlytilingScheme : TilingScheme

获取此提供程序使用的切图模式。这个函数不应该在WebMapTileServiceImageryProvider#ready返回true之前被调用。

times : TimeIntervalCollection

获取或设置用于获取时间动态参数的时间间隔集合。每个 TimeInterval 的数据都是一个对象，其中包含在以下情况下使用的属性的key和值。 tile requests.

readonlyurl : String

获取承载影像的服务的URL。

Methods

getTileCredits(x, y, level) → Array.<Credit>

获取显示给定瓦片时要显示的凭证。
Name Type Description
x Number 瓦片的X坐标。
y Number 瓦片的Y坐标。
level Number 瓦片的级别。
Returns:
显示瓦片时要显示的凭证。
Throws:
  • DeveloperError : getTileCredits 不得在影像提供程序准备就绪前调用。

pickFeatures(x, y, level, longitude, latitude) → Promise.<Array.<ImageryLayerFeatureInfo>>|undefined

该影像提供程序目前不支持选择特征，因此该函数返回未定义。
Name Type Description
x Number 瓦片的X坐标。
y Number 瓦片的Y坐标。
level Number 瓦片的级别。
longitude Number 选取特征的经度。
latitude Number 选取特征的纬度。
Returns:
当异步采集完成时，将解析所采集特征的Promise。解析值是一个由 ImageryLayerFeatureInfo 实例组成的数组。如果在给定位置未找到任何特征，数组可能为空。如果不支持提取，该数组也可能是未定义的。

requestImage(x, y, level, request) → Promise.<(Image|Canvas)>|undefined

请求指定瓦片的影像。此函数不应在 WebMapTileServiceImageryProvider#ready 返回 true 之前调用。
Name Type Description
x Number 瓦片的X坐标。
y Number 瓦片的Y坐标。
level Number 瓦片的级别。
request Request optional 请求对象。仅供内部使用。
Returns:
影像的Promise，该Promise将在影像可用时解析该影像；如果服务器上有太多活动请求，则未定义该Promise，请求应稍后重试。解析的影像可以是影像或 Canvas DOM 对象。
Throws:
  • DeveloperError : requestImage 不得在影像提供程序准备就绪前调用。