WebMapTileServiceImageryProvider

new Cesium.WebMapTileServiceImageryProvider(options)

提供由WMTS 1.0.0兼容服务器提供的瓦片图像。 该提供程序支持HTTP KVP编码和RESTful GetTile请求,但尚不支持SOAP编码。
Name Type Description
options Object 此对象拥有以下属性:
Name Type Default Description
url Resource | String WMTS GetTile操作(用于KVP编码的请求)或tile-URL模板(用于RESTful请求)的基本URL。 tile-URL模板应该包含以下变量:{style}、{TileMatrixSet}、{TileMatrix}、{TileRow}、{TileCol}。 如果实际值是硬编码的,或者服务器不需要,那么前两个值是可选的。{s}关键字可用于指定子域。
format String 'image/jpeg' optional 从服务器检索图像的MIME类型。
layer String WMTS请求的图层名称。
style String WMTS请求的样式名。
tileMatrixSetID String 用于WMTS请求的TileMatrixSet的标识符。
tileMatrixLabels Array optional TileMatrix中用于WMTS请求的标识符列表,每个TileMatrix级别一个。
clock Clock optional 确定时间维度的值时使用的Clock实例。 当指定options.times时是必需的。
times TimeIntervalCollection optional TimeIntervalCollection及其data属性是一个包含时间动态维度及其值的对象。
dimensions Object optional 包含静态尺寸及其值的对象。
tileWidth Number 256 optional 瓦片宽。
tileHeight Number 256 optional 瓦片高。
tilingScheme TilingScheme optional 切片方案与TileMatrixSet中的切片组织相对应。
rectangle Rectangle Rectangle.MAX_VALUE optional 地图矩形范围。
minimumLevel Number 0 optional 最小级别。
maximumLevel Number optional 最大级别,如果没有限制,则为未定义。。
ellipsoid Ellipsoid optional 椭球。 如果未指定,则使用WGS84椭球。
credit Credit | String optional 数据源的版权,它显示在画布上。
subdomains String | Array.<String> 'abc' optional URL模板中用于 {s} 占位符的子域。 如果此参数是单个字符串,则字符串中的每个字符都是一个子域。 如果是数组,则数组中的每个元素都是一个子域。
Examples:
// 例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:
See:

Members

获取或设置一个时钟,该时钟用于获取保留用于时间动态参数的时间。
获取版权信息。WebMapTileServiceImageryProvider#ready返回true之前,不应调用此函数。
获取或设置一个包含静态尺寸及其值的对象。
获取异步错误时引发的事件。
获取此图像提供程序返回的图像的MIME类型。

readonlyhasAlphaChannel : Boolean

获取影像是否有Alpha通道。

readonlymaximumLevel : Number

获取最大级别。WebMapTileServiceImageryProvider#ready返回true之前,不应调用此函数。

readonlyminimumLevel : Number

获取最小级别。WebMapTileServiceImageryProvider#ready返回true之前,不应调用此函数。
获取此提供器使用的代理。
获取否准备就绪。

readonlyreadyPromise : Promise.<Boolean>

获取一个在提供器准备好使用时解析为true的Promise。
地图矩形范围。WebMapTileServiceImageryProvider#ready返回true之前,不应调用此函数。
获取瓦片忽略策略。如果未定义,则忽略策略负责通过其shouldDiscardImage函数过滤掉“丢失”的瓦片。 如果此函数返回未定义,则不过滤任何切片。 WebMapTileServiceImageryProvider#ready返回true之前,不应调用此函数。

readonlytileHeight : Number

获取瓦片高,以像素为单位。WebMapTileServiceImageryProvider#ready返回true之前,不应调用此函数。
获取瓦片宽,以像素为单位。WebMapTileServiceImageryProvider#ready返回true之前,不应调用此函数。
获取切片方案。WebMapTileServiceImageryProvider#ready返回true之前,不应调用此函数。
获取或设置一个时间间隔集合,该集合用于获取时间动态参数。每个的数据 TimeInterval是一个对象,其中包含切片请求期间使用的属性的键和值。
获取WMTS服务器的URL。

Methods

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

获取当请求的瓦片被显示出来时,要显示的版权信息。
Name Type Description
x Number 瓦片的X坐标。
y Number 瓦片的Y坐标。
level Number 瓦片的层级。
Returns:
返回的版权。
Throws:
  • 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 拾取要素的纬度。
Returns:
对所选要素的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对象(仅供内部使用)。
Returns:
返回值有以下3种情况: 1.当图像可用时,返回对图像的Promise。 2.如果有太多对服务器的活动请求,则返回未定义图像,并且应该稍后重新请求。 3.解析后的图像可以是图像,也可以是画布DOM对象。
Throws:
  • DeveloperError : 准备好图像提供器之前,不得调用 requestImage