WebMapTileServiceImageryProvider

提供WMTS 1.0.0兼容服务器提供的平铺图像。此提供程序支持HTTP KVP编码和RESTful gettile请求，但尚不支持SOAP编码。

new WebMapTileServiceImageryProvider(options)

Parameters:

options (Object)

Name	Description
options.url `(Resource \| String)`	wmts gettile操作（用于kvp编码的请求）的基URL或tile url模板（用于restful请求）。tile url模板应包含以下变量：{；style}；、{；tilematrixset}；、{；tilematrix}；、{；tilerow}；、{；tilecol}；。如果实际值是硬编码的或服务器不需要，则前两个值是可选的。关键字{；s}；可用于指定子域。
options.format `String` default `'image/jpeg'`	要从服务器检索的图像的mime类型。
options.layer `String`	WMTS请求的层名称。
options.style `String`	WMTS请求的样式名。
options.tileMatrixSetID `String`	用于WMTS请求的tilematrixset的标识符。
options.tileMatrixLabels `Array`	tilematrix中用于WMTS请求的标识符列表，每个tilematrix级别一个。
options.clock `Clock`	确定时间维度值时使用的时钟实例。指定options.times时必需。
options.times `TimeIntervalCollection`	TimeIntervalCollection的`data`属性是一个包含时间动态维度及其值的对象。
options.dimensions `Object`	包含静态维度及其值的对象。
options.tileWidth `Number` default `256`	以像素为单位的瓦片宽度。
options.tileHeight `Number` default `256`	以像素为单位的瓦片高度。
options.tilingScheme `TilingScheme`	与tilematrixset中的瓦片组织相对应的瓦片切片方案。
options.rectangle `Rectangle` default `Rectangle.MAX_VALUE`	被层覆盖的矩形。
options.minimumLevel `Number` default `0`	图像提供商支持的最低详细程度。
options.maximumLevel `Number`	图像提供者支持的最大细节级别，如果没有限制，则未定义。
options.ellipsoid `Ellipsoid`	椭球体。如果未指定，则使用wgs84椭球体。
options.credit `(Credit \| String)`	数据源的信用，显示在画布上。
options.subdomains `(String \| Array.<String>)` default `'abc'`	用于URL模板中`{s}`占位符的子域。如果此参数是单个字符串，则字符串中的每个字符都是子域。如果是数组，则数组中的每个元素都是子域。

Examples

// Example 1. USGS shaded relief tiles (KVP)
var shadedRelief1 = new bmgl.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 bmgl.Credit('U. S. Geological Survey')
});
viewer.imageryLayers.addImageryProvider(shadedRelief1);

// Example 2. USGS shaded relief tiles (RESTful)
var shadedRelief2 = new bmgl.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 bmgl.Credit('U. S. Geological Survey')
});
viewer.imageryLayers.addImageryProvider(shadedRelief2);

// Example 3. NASA time dynamic weather data (RESTful)
var times = bmgl.TimeIntervalCollection.fromIso8601({
    iso8601: '2015-07-30/2017-06-16/P1D',
    dataCallback: function dataCallback(interval, index) {
        return {
            Time: bmgl.JulianDate.toIso8601(interval.start)
        };
    }
});
var weather = new bmgl.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 bmgl.Credit('NASA Global Imagery Browse Services for EOSDIS')
});
viewer.imageryLayers.addImageryProvider(weather);

See:

Members

clock : Clock

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

(readonly) credit : Credit

获取此图像提供程序处于活动状态时要显示的信用。通常情况下，这是用来赞扬图像的来源。在WebMapTileServiceImageryProvider#ready返回true之前，不应调用此函数。

dimensions : Object

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

(readonly) errorEvent : Event

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

(readonly) format : String

获取此图像提供程序返回的图像的mime类型。

(readonly) hasAlphaChannel : Boolean

获取一个值，该值指示此图像提供程序提供的图像是否包含alpha通道。如果此属性为假，则忽略alpha通道（如果存在）。如果此属性为真，则任何没有alpha通道的图像都将被视为其alpha在任何地方都是1.0。如果该属性为假，则会减少内存使用和纹理上载时间。

(readonly) maximumLevel : Number

获取可以请求的最大详细级别。在WebMapTileServiceImageryProvider#ready返回true之前，不应调用此函数。

(readonly) minimumLevel : Number

获取可以请求的最低详细级别。在WebMapTileServiceImageryProvider#ready返回true之前，不应调用此函数。

(readonly) proxy : Proxy

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

(readonly) ready : Boolean

获取一个值，该值指示提供程序是否准备好使用。

(readonly) readyPromise : Promise.<Boolean>

获取当提供程序准备好使用时解析为true的承诺。

(readonly) rectangle : Rectangle

获取此实例提供的图像的矩形（以弧度表示）。在WebMapTileServiceImageryProvider#ready返回true之前，不应调用此函数。

(readonly) tileDiscardPolicy : TileDiscardPolicy

获取瓦片丢弃策略。如果未定义，则丢弃策略负责通过其shouldDiscardimage函数过滤掉“丢失”的瓦片。如果此函数返回UNdefined，则不会筛选任何瓦片。在WebMapTileServiceImageryProvider#ready返回true之前，不应调用此函数。

(readonly) tileHeight : Number

获取每个瓦片的高度（像素）。在WebMapTileServiceImageryProvider#ready返回true之前，不应调用此函数。

(readonly) tileWidth : Number

获取每个瓦片的宽度（像素）。在WebMapTileServiceImageryProvider#ready返回true之前，不应调用此函数。

(readonly) tilingScheme : TilingScheme

获取此提供程序使用的平铺方案。切片方案。在WebMapTileServiceImageryProvider#ready返回true之前，不应调用此函数。

times : TimeIntervalCollection

获取或设置用于获取时间动态参数的时间间隔集合。每个时间间隔的数据是一个对象，其中包含瓦片请求期间使用的属性的键和值。

(readonly) url : String

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

Methods

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

获取显示给定瓦片时要显示的片尾。

Parameters:

x (Number) 瓦片X坐标。

y (Number) 瓦片Y坐标。

level (Number) 瓦片级别；

Throws

DeveloperError : getTileCredits在图像提供者准备就绪之前不得调用。

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

此图像提供程序当前不支持选取功能，因此此函数只返回未定义的。

Parameters:

x (Number) 瓦片X坐标。

y (Number) 瓦片Y坐标。

level (Number) 瓦片级别。

longitude (Number) 选择特征的经度。

latitude (Number) 选择特征的纬度。

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

请求给定瓦片的图像。在WebMapTileServiceImageryProvider#ready返回true之前，不应调用此函数。

Parameters:

x (Number) 瓦片X坐标。

y (Number) 瓦片Y坐标。

level (Number) 瓦片级别。

request (Request) 请求对象。仅供内部使用。

Throws

DeveloperError : requestImage在图像提供者准备就绪之前不得调用。