WebMapTileServiceImageryProvider

new Cesium.WebMapTileServiceImageryProvider (options)

提供由 WMTS 1.0.0 兼容服务器提供的平铺图像。该提供程序支持HTTP KVP编码和RESTful GetTile请求,但尚不支持SOAP编码。
Name Type Description
options Object Object with the following properties:
Name Type Default Description
url Resource | String WMTS GetTile操作的基本URL(用于KVP编码的请求)或tile-URL模板(用于RESTful请求)。 tile-URL模板应包含以下变量:{style},{TileMatrixSet},{TileMatrix},{TileRow},{TileCol}。如果实际值是硬编码的,或者服务器不需要,则前两个是可选的。 {s}关键字可用于指定子域。
format String 'image/jpeg' 可选 从服务器检索图像的MIME类型。
layer String WMTS请求的层名称。
style String WMTS请求的样式名称。
tileMatrixSetID String 用于WMTS请求的TileMatrixSet的标识符。
tileMatrixLabels Array 可选 TileMatrix中用于WMTS请求的标识符的列表,每个TileMatrix级别一个。
clock Clock 可选 确定时间维度的值时使用的Clock实例。指定options.times时必需。
times TimeIntervalCollection 可选 具有 data 属性的TimeIntervalCollection是一个包含时间动态维度及其值的对象。
dimensions Object 可选 包含静态尺寸及其值的对象。
tileWidth Number 256 可选 平铺宽度(以像素为单位)。
tileHeight Number 256 可选 平铺高度(以像素为单位)。
tilingScheme TilingScheme 可选 与TileMatrixSet中的拼贴组织相对应的拼贴方案。
rectangle Rectangle Rectangle.MAX_VALUE 可选 图层所覆盖的矩形。
minimumLevel Number 0 可选 图像提供者支持的最低详细程度。
maximumLevel Number 可选 图像提供程序支持的最大详细程度,如果没有限制,则为未定义。
ellipsoid Ellipsoid 可选 椭球。如果未指定,则使用WGS84椭球。
credit Credit | String 可选 数据源的信用,显示在画布上。
subdomains String | Array.<String> 'abc' 可选 URL模板中用于 {s} 占位符的子域。                         如果此参数是单个字符串,则字符串中的每个字符都是一个子域。如果是                         一个数组,数组中的每个元素都是一个子域。
Examples:
// Example 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);
// Example 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);
// Example 3. NASA time dynamic weather data (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之前,不应调用此函数。
获取或设置一个包含静态尺寸及其值的对象。
获取当图像提供程序遇到异步错误时引发的事件。通过订阅事件发生后,您将收到有关该错误的通知,并有可能从中恢复。事件监听器传递了 TileProviderError 的实例。
获取此图像提供程序返回的图像的MIME类型。

readonly hasAlphaChannel : Boolean

获取一个值,该值指示此图像提供者是否提供了图像包括一个Alpha通道。如果此属性为false,则Alpha通道(如果存在)将被忽略。如果此属性为true,则将处理没有alpha通道的任何图像好像他们的alpha到处都是1.0。当此属性为false时,内存使用情况并且减少了纹理上载时间。
获取可以请求的最大详细程度。该功能应在 WebMapTileServiceImageryProvider#ready 返回true之前不会被调用。
获取可以请求的最低详细程度。该功能应在 WebMapTileServiceImageryProvider#ready 返回true之前不会被调用。
获取此提供程序使用的代理。
获取一个值,该值指示提供程序是否准备就绪。

readonly readyPromise : Promise.<Boolean>

获取一个在提供程序准备好使用时解析为true的承诺。
获取此实例提供的图像的矩形(以弧度表示)。该功能应在 WebMapTileServiceImageryProvider#ready 返回true之前不会被调用。
获取切片丢弃策略。如果未定义,则丢弃策略负责用于通过其shouldDiscardImage函数过滤掉'缺失'的图块。如果这个功能返回未定义,不过滤任何图块。该功能应在 WebMapTileServiceImageryProvider#ready 返回true之前不会被调用。
获取每个图块的高度,以像素为单位。该功能应在 WebMapTileServiceImageryProvider#ready 返回true之前不会被调用。
获取每个图块的宽度,以像素为单位。该功能应在 WebMapTileServiceImageryProvider#ready 返回true之前不会被调用。
获取此提供程序使用的切片方案。该功能应在 WebMapTileServiceImageryProvider#ready 返回true之前不会被调用。
获取或设置一个时间间隔集合,该集合用于获取时间动态参数。每个的数据TimeInterval是一个对象,包含在操作过程中使用的属性的键和值平铺请求。
获取托管图像的服务的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:
对所选择功能的承诺将在异步时解决                  采摘完成。解析的值是一个数组 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 可选 请求对象。仅供内部使用。
Returns:
对图像的承诺,将在图像可用时解决,或者         如果对服务器的活动请求过多,并且请求过多,则不确定         应稍后重试。解析的图像可能是         图片或Canvas DOM对象。
Throws:
  • DeveloperError : requestImage 影像提供者准备就绪之前,不得调用它。