麻辣GIS微信平台

更多 GIS 干货

微信关注不错过

Cesium API - WebMapTileServiceImageryProvider 中文文档

本文介绍下Cesium中 WebMapTileServiceImageryProvider API的详细使用说明。

WebMapTileServiceImageryProvider API 调用方法

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} 占位符的子域。 如果此参数是单个字符串,则字符串中的每个字符都是一个子域。 如果是数组,则数组中的每个元素都是一个子域。
示例:
// 例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之前,不应调用此函数。
获取或设置一个包含静态尺寸及其值的对象。
获取异步错误时引发的事件。
获取此图像提供程序返回的图像的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。

内置方法

getTileCredits(x, y, level)Array.<Credit>
获取当请求的瓦片被显示出来时,要显示的版权信息。
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

其他API

Cesium中文API文档手册(v1.63.1版本)参考:《Cesium中文API文档手册(v1.63.1版本)

相关阅读

麻辣GIS-Sailor

作者:

GIS爱好者,学GIS,更爱玩GIS。

声明

1.本文所分享的所有需要用户下载使用的内容(包括但不限于软件、数据、图片)来自于网络或者麻辣GIS粉丝自行分享,版权归该下载资源的合法拥有者所有,如有侵权请第一时间联系本站删除。

2.下载内容仅限个人学习使用,请切勿用作商用等其他用途,否则后果自负。

手机阅读
公众号关注
知识星球
手机阅读
麻辣GIS微信公众号关注
最新GIS干货
关注麻辣GIS知识星球
私享圈子

留言板(小编看到第一时间回复)