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在圖像提供者準備就緒之前不得調用。