Class: WebMapTileServiceImageryProvider

// 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);

Members

clockClock

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

readonly creditCredit

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

dimensionsObject

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

readonly errorEventEvent

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

readonly formatString

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

readonly hasAlphaChannelBoolean

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

readonly maximumLevelNumber

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

readonly minimumLevelTilingScheme

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

readonly proxyNumber

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

readonly readyBoolean

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

readonly readyPromisePromise.<Boolean>

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

readonly rectangleRectangle

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

readonly tileDiscardPolicyTileDiscardPolicy

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

readonly tileHeightNumber

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

readonly tileWidthNumber

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

readonly tilingSchemeTilingScheme

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

timesTimeIntervalCollection

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

readonly urlString

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

Methods

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

获取显示给定瓦片时要显示的版权声明。

Name	Type	Description
x	Number	瓦片的X坐标。
y	Number	瓦片的Y坐标。
level	Number	瓦片的级别。

Throws:

getTileCredits 不得在影像提供程序准备就绪前调用。

Type

DeveloperError

Returns:

Type	Description
Array.<Credit>	显示瓦片时要显示的版权声明。

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:

Type	Description
Promise.<Array.<ImageryLayerFeatureInfo>> | undefined	当异步采集完成时，将解析所采集特征的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	可选 请求对象。仅供内部使用。

Throws:

requestImage 不得在影像提供程序准备就绪前调用。

Type

DeveloperError

Returns:

Type	Description
Promise.<(Image|Canvas)> | undefined	影像的Promise，该Promise将在影像可用时解析该影像；如果服务器上有太多活动请求，则未定义该Promise，请求应稍后重试。解析的影像可以是影像或 Canvas DOM 对象。