new Cesium.WebMapTileServiceImageryProvider(options)
提供由WMTS 1.0.0兼容服务器提供的瓦片图像。
该提供程序支持HTTP KVP编码和RESTful GetTile请求,但尚不支持SOAP编码。
Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
Object |
此对象拥有以下属性:
|
示例:
// 例1:USGS shaded relief tiles (KVP)
var shadedRelief1 = new Cesium.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 Cesium.Credit('U. S. Geological Survey')
});
viewer.imageryLayers.addImageryProvider(shadedRelief1);
// 例2: USGS shaded relief tiles (RESTful)
var shadedRelief2 = new Cesium.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 Cesium.Credit('U. S. Geological Survey')
});
viewer.imageryLayers.addImageryProvider(shadedRelief2);
// 例3:NASA时间动态天气数据 (RESTful)
var times = Cesium.TimeIntervalCollection.fromIso8601({
iso8601: '2015-07-30/2017-06-16/P1D',
dataCallback: function dataCallback(interval, index) {
return {
Time: Cesium.JulianDate.toIso8601(interval.start)
};
}
});
var weather = new Cesium.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 Cesium.Credit('NASA Global Imagery Browse Services for EOSDIS')
});
viewer.imageryLayers.addImageryProvider(weather);
演示Demo:
参考:
成员变量
获取或设置一个时钟,该时钟用于获取保留用于时间动态参数的时间。
获取版权信息。
WebMapTileServiceImageryProvider#ready
返回true之前,不应调用此函数。
dimensions : Object
获取或设置一个包含静态尺寸及其值的对象。
获取异步错误时引发的事件。
获取此图像提供程序返回的图像的MIME类型。
获取影像是否有Alpha通道。
获取最大级别。
WebMapTileServiceImageryProvider#ready
返回true之前,不应调用此函数。
获取最小级别。
WebMapTileServiceImageryProvider#ready
返回true之前,不应调用此函数。
获取此提供器使用的代理。
获取否准备就绪。
获取一个在提供器准备好使用时解析为true的Promise。
地图矩形范围。
WebMapTileServiceImageryProvider#ready
返回true之前,不应调用此函数。
获取瓦片忽略策略。如果未定义,则忽略策略负责通过其shouldDiscardImage函数过滤掉“丢失”的瓦片。
如果此函数返回未定义,则不过滤任何切片。
WebMapTileServiceImageryProvider#ready
返回true之前,不应调用此函数。
获取瓦片高,以像素为单位。
WebMapTileServiceImageryProvider#ready
返回true之前,不应调用此函数。
获取瓦片宽,以像素为单位。
WebMapTileServiceImageryProvider#ready
返回true之前,不应调用此函数。
获取切片方案。
WebMapTileServiceImageryProvider#ready
返回true之前,不应调用此函数。
获取或设置一个时间间隔集合,该集合用于获取时间动态参数。每个的数据
TimeInterval是一个对象,其中包含切片请求期间使用的属性的键和值。
获取WMTS服务器的URL。
内置方法
获取当请求的瓦片被显示出来时,要显示的版权信息。
Name | Type | Description |
---|---|---|
x |
Number | 瓦片的X坐标。 |
y |
Number | 瓦片的Y坐标。 |
level |
Number | 瓦片的层级。 |
返回值:
返回的版权。
异常情况:
-
DeveloperError : 在图像提供器准备就绪之前,不得调用
getTileCredits
。
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 | 拾取要素的纬度。 |
返回值:
对所选要素的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 | optional Request对象(仅供内部使用)。 |
返回值:
返回值有以下3种情况:
1.当图像可用时,返回对图像的Promise。
2.如果有太多对服务器的活动请求,则返回未定义图像,并且应该稍后重新请求。
3.解析后的图像可以是图像,也可以是画布DOM对象。
异常情况:
-
DeveloperError : 准备好图像提供器之前,不得调用
requestImage
。