提供WMTS 1.0.0兼容服務(wù)器提供的平鋪圖像。此提供程序支持HTTP KVP編碼和RESTful gettile請(qǐng)求,但尚不支持SOAP編碼。
new WebMapTileServiceImageryProvider(options)
Parameters:
options
(Object)
Name | Description |
---|---|
options.url
(Resource | String)
|
wmts gettile操作(用于kvp編碼的請(qǐng)求)的基URL或tile url模板(用于restful請(qǐng)求)。tile url模板應(yīng)包含以下變量:{;style};、{;tilematrixset};、{;tilematrix};、{;tilerow};、{;tilecol};。如果實(shí)際值是硬編碼的或服務(wù)器不需要,則前兩個(gè)值是可選的。關(guān)鍵字{;s};可用于指定子域。 |
options.format
String
default 'image/jpeg'
|
要從服務(wù)器檢索的圖像的mime類型。 |
options.layer
String
|
WMTS請(qǐng)求的層名稱。 |
options.style
String
|
WMTS請(qǐng)求的樣式名。 |
options.tileMatrixSetID
String
|
用于WMTS請(qǐng)求的tilematrixset的標(biāo)識(shí)符。 |
options.tileMatrixLabels
Array
|
tilematrix中用于WMTS請(qǐng)求的標(biāo)識(shí)符列表,每個(gè)tilematrix級(jí)別一個(gè)。 |
options.clock
Clock
|
確定時(shí)間維度值時(shí)使用的時(shí)鐘實(shí)例。指定options.times時(shí)必需。 |
options.times
TimeIntervalCollection
|
TimeIntervalCollection的data 屬性是一個(gè)包含時(shí)間動(dòng)態(tài)維度及其值的對(duì)象。
|
options.dimensions
Object
|
包含靜態(tài)維度及其值的對(duì)象。 |
options.tileWidth
Number
default 256
|
以像素為單位的瓦片寬度。 |
options.tileHeight
Number
default 256
|
以像素為單位的瓦片高度。 |
options.tilingScheme
TilingScheme
|
與tilematrixset中的瓦片組織相對(duì)應(yīng)的瓦片切片方案。 |
options.rectangle
Rectangle
default Rectangle.MAX_VALUE
|
被層覆蓋的矩形。 |
options.minimumLevel
Number
default 0
|
圖像提供商支持的最低詳細(xì)程度。 |
options.maximumLevel
Number
|
圖像提供者支持的最大細(xì)節(jié)級(jí)別,如果沒(méi)有限制,則未定義。 |
options.ellipsoid
Ellipsoid
|
橢球體。如果未指定,則使用wgs84橢球體。 |
options.credit
(Credit | String)
|
數(shù)據(jù)源的信用,顯示在畫(huà)布上。 |
options.subdomains
(String | Array.<String>)
default 'abc'
|
用于URL模板中{s} 占位符的子域。如果此參數(shù)是單個(gè)字符串,則字符串中的每個(gè)字符都是子域。如果是數(shù)組,則數(shù)組中的每個(gè)元素都是子域。
|
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
獲取或設(shè)置用于獲取保持時(shí)間動(dòng)態(tài)參數(shù)所用時(shí)間的時(shí)鐘。
(readonly) credit : Credit
獲取此圖像提供程序處于活動(dòng)狀態(tài)時(shí)要顯示的信用。通常情況下,這是用來(lái)贊揚(yáng)圖像的來(lái)源。在
WebMapTileServiceImageryProvider#ready
返回true之前,不應(yīng)調(diào)用此函數(shù)。
dimensions : Object
獲取或設(shè)置包含靜態(tài)維度及其值的對(duì)象。
(readonly) errorEvent : Event
獲取圖像提供程序遇到異步錯(cuò)誤時(shí)引發(fā)的事件。通過(guò)訂閱事件,您將收到錯(cuò)誤通知,并可能從中恢復(fù)。向事件偵聽(tīng)器傳遞
TileProviderError
的實(shí)例。
(readonly) format : String
獲取此圖像提供程序返回的圖像的mime類型。
(readonly) hasAlphaChannel : Boolean
獲取一個(gè)值,該值指示此圖像提供程序提供的圖像是否包含alpha通道。如果此屬性為假,則忽略alpha通道(如果存在)。如果此屬性為真,則任何沒(méi)有alpha通道的圖像都將被視為其alpha在任何地方都是1.0。如果該屬性為假,則會(huì)減少內(nèi)存使用和紋理上載時(shí)間。
(readonly) maximumLevel : Number
獲取可以請(qǐng)求的最大詳細(xì)級(jí)別。在
WebMapTileServiceImageryProvider#ready
返回true之前,不應(yīng)調(diào)用此函數(shù)。
(readonly) minimumLevel : Number
獲取可以請(qǐng)求的最低詳細(xì)級(jí)別。在
WebMapTileServiceImageryProvider#ready
返回true之前,不應(yīng)調(diào)用此函數(shù)。
(readonly) proxy : Proxy
獲取此提供程序使用的代理。
(readonly) ready : Boolean
獲取一個(gè)值,該值指示提供程序是否準(zhǔn)備好使用。
(readonly) readyPromise : Promise.<Boolean>
獲取當(dāng)提供程序準(zhǔn)備好使用時(shí)解析為true的承諾。
(readonly) rectangle : Rectangle
獲取此實(shí)例提供的圖像的矩形(以弧度表示)。在
WebMapTileServiceImageryProvider#ready
返回true之前,不應(yīng)調(diào)用此函數(shù)。
(readonly) tileDiscardPolicy : TileDiscardPolicy
獲取瓦片丟棄策略。如果未定義,則丟棄策略負(fù)責(zé)通過(guò)其shouldDiscardimage函數(shù)過(guò)濾掉“丟失”的瓦片。如果此函數(shù)返回UNdefined,則不會(huì)篩選任何瓦片。在
WebMapTileServiceImageryProvider#ready
返回true之前,不應(yīng)調(diào)用此函數(shù)。
(readonly) tileHeight : Number
獲取每個(gè)瓦片的高度(像素)。在
WebMapTileServiceImageryProvider#ready
返回true之前,不應(yīng)調(diào)用此函數(shù)。
(readonly) tileWidth : Number
獲取每個(gè)瓦片的寬度(像素)。在
WebMapTileServiceImageryProvider#ready
返回true之前,不應(yīng)調(diào)用此函數(shù)。
(readonly) tilingScheme : TilingScheme
獲取此提供程序使用的平鋪方案。切片方案。在
WebMapTileServiceImageryProvider#ready
返回true之前,不應(yīng)調(diào)用此函數(shù)。
times : TimeIntervalCollection
獲取或設(shè)置用于獲取時(shí)間動(dòng)態(tài)參數(shù)的時(shí)間間隔集合。每個(gè)時(shí)間間隔的數(shù)據(jù)是一個(gè)對(duì)象,其中包含瓦片請(qǐng)求期間使用的屬性的鍵和值。
(readonly) url : String
獲取承載圖像的服務(wù)的URL。
Methods
getTileCredits(x, y, level) → {Array.<Credit>}
獲取顯示給定瓦片時(shí)要顯示的片尾。
Parameters:
x
(Number)
瓦片X坐標(biāo)。
y
(Number)
瓦片Y坐標(biāo)。
level
(Number)
瓦片級(jí)別;
Throws
-
DeveloperError :
getTileCredits
在圖像提供者準(zhǔn)備就緒之前不得調(diào)用。
此圖像提供程序當(dāng)前不支持選取功能,因此此函數(shù)只返回未定義的。
Parameters:
x
(Number)
瓦片X坐標(biāo)。
y
(Number)
瓦片Y坐標(biāo)。
level
(Number)
瓦片級(jí)別。
longitude
(Number)
選擇特征的經(jīng)度。
latitude
(Number)
選擇特征的緯度。
請(qǐng)求給定瓦片的圖像。在
WebMapTileServiceImageryProvider#ready
返回true之前,不應(yīng)調(diào)用此函數(shù)。
Parameters:
x
(Number)
瓦片X坐標(biāo)。
y
(Number)
瓦片Y坐標(biāo)。
level
(Number)
瓦片級(jí)別。
Throws
-
DeveloperError :
requestImage
在圖像提供者準(zhǔn)備就緒之前不得調(diào)用。