WebMapTileServiceImageryProvider

new Cesium.WebMapTileServiceImageryProvider (options)
Scene/WebMapTileServiceImageryProvider.js 117

提供由 WMTS 1.0.0 兼容服务器提供的平铺图像。该提供程序支持HTTP KVP编码和RESTful GetTile请求，但尚不支持SOAP编码。
Name Type Description
options WebMapTileServiceImageryProvider.ConstructorOptions 描述初始化选项的对象
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:
翻译by:http://cesium.xin

Members

clock : Clock
Scene/WebMapTileServiceImageryProvider.js 579

获取或设置一个时钟，该时钟用于获取保留用于时间动态参数的时间。

readonly credit : Credit
Scene/WebMapTileServiceImageryProvider.js 553

获取此图像提供者处于活动状态时要显示的功劳。通常，这用于记入图像的来源。在 WebMapTileServiceImageryProvider＃ready 返回true之前，不应调用此函数。

defaultAlpha : Number|undefined
Scene/WebMapTileServiceImageryProvider.js 147

此提供程序的默认alpha混合值，其中0.0表示完全透明，1.0表示完全不透明。
Default Value: undefined

defaultBrightness : Number|undefined
Scene/WebMapTileServiceImageryProvider.js 174

此提供程序的默认亮度。 1.0使用未修改的图像颜色。小于1.0使图像更暗，而大于1.0则使图像更亮。
Default Value: undefined

defaultContrast : Number|undefined
Scene/WebMapTileServiceImageryProvider.js 183

此提供程序的默认对比。 1.0使用未修改的图像颜色。小于1.0减少大于1.0时，对比度增加。
Default Value: undefined

defaultDayAlpha : Number|undefined
Scene/WebMapTileServiceImageryProvider.js 165

此提供程序的全球日期的默认alpha混合值，其中0.0表示完全透明，1.0表示完全不透明。
Default Value: undefined

defaultGamma : Number|undefined
Scene/WebMapTileServiceImageryProvider.js 208

适用于此提供程序的默认伽玛校正。 1.0使用未修改的图像颜色。
Default Value: undefined

defaultHue : Number|undefined
Scene/WebMapTileServiceImageryProvider.js 191

此提供程序的默认色调（以弧度为单位）。 0.0使用未修改的图像颜色。
Default Value: undefined

defaultMagnificationFilter : TextureMagnificationFilter
Scene/WebMapTileServiceImageryProvider.js 224

应用于该提供程序的默认纹理放大滤镜。
Default Value: undefined

defaultMinificationFilter : TextureMinificationFilter
Scene/WebMapTileServiceImageryProvider.js 216

应用于该提供程序的默认纹理缩小过滤器。
Default Value: undefined

defaultNightAlpha : Number|undefined
Scene/WebMapTileServiceImageryProvider.js 156

此提供程序的地球仪夜间的默认alpha混合值，其中0.0表示完全透明，1.0表示完全不透明。
Default Value: undefined

defaultSaturation : Number|undefined
Scene/WebMapTileServiceImageryProvider.js 200

此提供程序的默认饱和度。 1.0使用未修改的图像颜色。小于1.0会降低饱和度大于1.0时会增加饱和度。
Default Value: undefined

dimensions : Object
Scene/WebMapTileServiceImageryProvider.js 607

获取或设置一个包含静态尺寸及其值的对象。

readonly errorEvent : Event
Scene/WebMapTileServiceImageryProvider.js 506

获取当图像提供程序遇到异步错误时引发的事件。通过订阅针对该事件，您将收到有关该错误的通知，并有可能从中恢复。事件监听器传递了 TileProviderError 的实例。

readonly format : String
Scene/WebMapTileServiceImageryProvider.js 518

获取此图像提供程序返回的图像的MIME类型。

readonly hasAlphaChannel : Boolean
Scene/WebMapTileServiceImageryProvider.js 569

获取一个值，该值指示此图像提供者是否提供了图像包括一个Alpha通道。如果此属性为false，则Alpha通道（如果存在）将被忽略。如果此属性为true，则将处理任何没有alpha通道的图像好像他们的alpha到处都是1.0。当此属性为false时，内存使用情况并且减少了纹理上载时间。

readonly maximumLevel : Number|undefined
Scene/WebMapTileServiceImageryProvider.js 438

获取可以请求的最大详细程度。该功能应在 WebMapTileServiceImageryProvider＃ready 返回true之前不会被调用。

readonly minimumLevel : Number
Scene/WebMapTileServiceImageryProvider.js 451

获取可以请求的最低详细程度。该功能应在 WebMapTileServiceImageryProvider＃ready 返回true之前不会被调用。

readonly proxy : Proxy
Scene/WebMapTileServiceImageryProvider.js 399

获取此提供程序使用的代理。

readonly ready : Boolean
Scene/WebMapTileServiceImageryProvider.js 530

获取一个值，该值指示提供者是否已准备好使用。

readonly readyPromise : Promise.<Boolean>
Scene/WebMapTileServiceImageryProvider.js 540

获取一个在提供程序准备好使用时解析为true的承诺。

readonly rectangle : Rectangle
Scene/WebMapTileServiceImageryProvider.js 477

获取此实例提供的图像的矩形（以弧度表示）。该功能应在 WebMapTileServiceImageryProvider＃ready 返回true之前不会被调用。

readonly tileDiscardPolicy : TileDiscardPolicy
Scene/WebMapTileServiceImageryProvider.js 492

获取切片丢弃策略。如果未定义，则丢弃策略负责用于通过其shouldDiscardImage函数过滤掉'缺失'的图块。如果这个功能返回未定义，不过滤任何图块。该功能应在 WebMapTileServiceImageryProvider＃ready 返回true之前不会被调用。

readonly tileHeight : Number
Scene/WebMapTileServiceImageryProvider.js 425

获取每个图块的高度，以像素为单位。该功能应在 WebMapTileServiceImageryProvider＃ready 返回true之前不会被调用。

readonly tileWidth : Number
Scene/WebMapTileServiceImageryProvider.js 412

获取每个图块的宽度，以像素为单位。该功能应在 WebMapTileServiceImageryProvider＃ready 返回true之前不会被调用。

readonly tilingScheme : TilingScheme
Scene/WebMapTileServiceImageryProvider.js 464

获取此提供程序使用的切片方案。该功能应在 WebMapTileServiceImageryProvider＃ready 返回true之前不会被调用。

times : TimeIntervalCollection
Scene/WebMapTileServiceImageryProvider.js 594

获取或设置一个时间间隔集合，该集合用于获取时间动态参数。每个的数据TimeInterval是一个对象，其中包含在操作过程中使用的属性的键和值平铺请求。

readonly url : String
Scene/WebMapTileServiceImageryProvider.js 387

获取托管图像的服务的URL。

Methods

getTileCredits (x, y, level) → Array.< Credit >
Scene/WebMapTileServiceImageryProvider.js 632

获取显示给定图块时要显示的信用。
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
Scene/WebMapTileServiceImageryProvider.js 698

该图像提供者当前不支持拾取功能，因此该函数仅返回未定义。
Name Type Description
x Number 瓦片X坐标。
y Number 瓷砖的Y坐标。
level Number 平铺级别。
longitude Number 选择要素的经度。
latitude Number 选择要素的纬度。
Returns:
对所选择功能的承诺将在异步时解决 采摘完成。解析值是一个数组 ImageryLayerFeatureInfo 实例。如果在给定位置找不到要素，则数组可能为空。 如果不支持拣配，则它也可能是未定义的。

requestImage (x, y, level, request ) → Promise.<(HTMLImageElement|HTMLCanvasElement)>|undefined
Scene/WebMapTileServiceImageryProvider.js 655

请求给定图块的图像。该功能应在 WebMapTileServiceImageryProvider＃ready 返回true之前不会被调用。
Name Type Description
x Number 瓦片X坐标。
y Number 瓷砖的Y坐标。
level Number 平铺级别。
request Request 可选 请求对象。仅供内部使用。
Returns:
对图像的承诺，将在图像可用时解决，或者 如果对服务器的活动请求过多，并且请求过多，则不确定 应稍后重试。解析的图像可能是 图片或Canvas DOM对象。
Throws:
  • DeveloperError : requestImage 影像提供者准备就绪之前，不得调用它。

Type Definitions

Cesium.WebMapTileServiceImageryProvider.ConstructorOptions
Scene/WebMapTileServiceImageryProvider.js 20

WebMapTileServiceImageryProvider构造函数的初始化选项
Properties:
Name Type Attributes Default Description
url Resource | String WMTS GetTile操作的基本URL（用于KVP编码的请求）或tile-URL模板（用于RESTful请求）。 tile-URL模板应包含以下变量:{style}，{TileMatrixSet}，{TileMatrix}，{TileRow}，{TileCol}。如果实际值是硬编码的或服务器不需要，则前两个是可选的。 {s}关键字可用于指定子域。
format String <optional>
'image/jpeg' 要从服务器检索的图像的MIME类型。
layer String WMTS请求的层名称。
style String WMTS请求的样式名称。
tileMatrixSetID String 用于WMTS请求的TileMatrixSet的标识符。
tileMatrixLabels Array <optional>
TileMatrix中用于WMTS请求的标识符列表，每个TileMatrix级别一个。
clock Clock <optional>
一个Clock实例，用于确定时间维度的值。指定`times'时必需。
times TimeIntervalCollection <optional>
TimeIntervalCollection及其 data 属性是一个包含时间动态维度及其值的对象。
dimensions Object <optional>
包含静态尺寸及其值的对象。
tileWidth Number <optional>
256 图块宽度（以像素为单位）。
tileHeight Number <optional>
256 图块高度（以像素为单位）。
tilingScheme TilingScheme <optional>
切片方案，与TileMatrixSet中的切片组织相对应。
rectangle Rectangle <optional>
Rectangle.MAX_VALUE 由图层覆盖的矩形。
minimumLevel Number <optional>
0 图像提供商所支持的最低详细程度。
maximumLevel Number <optional>
图像提供者支持的最大详细程度，如果没有限制，则未定义。
ellipsoid Ellipsoid <optional>
椭球。如果未指定，则使用WGS84椭球。
credit Credit | String <optional>
数据源的信用，显示在画布上。
subdomains String | Array.<String> <optional>
'abc' URL模板中用于 {s} 占位符的子域。 如果此参数是单个字符串，则字符串中的每个字符都是一个子域。如果是 一个数组，数组中的每个元素都是一个子域。