提供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);
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
在圖像提供者準備就緒之前不得調用。
此圖像提供程序當前不支持選取功能,因此此函數只返回未定義的。
Parameters:
x
(Number)
瓦片X坐標。
y
(Number)
瓦片Y坐標。
level
(Number)
瓦片級別。
longitude
(Number)
選擇特征的經度。
latitude
(Number)
選擇特征的緯度。
請求給定瓦片的圖像。在
WebMapTileServiceImageryProvider#ready
返回true之前,不應調用此函數。
Parameters:
Throws
-
DeveloperError :
requestImage
在圖像提供者準備就緒之前不得調用。