WebMapTileServiceImageryProvider

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

提供由WMTS 1.0.0兼容服务器提供的平铺图像。 此提供程序支持httpkvp编码和restfulgettile请求，但还不支持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:

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

要应用于此提供程序的默认gamma校正。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 大于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 optional 请求对象。仅供内部使用。
Returns:
对映像的承诺，当映像可用时将解决该问题，或 如果对服务器的活动请求太多，则未定义 应该稍后重试。解析图像可以是 图像或画布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请求的tileMatrix集的标识符。
tileMatrixLabels Array <optional>
 TileMatrix中用于WMTS请求的标识符列表，每个TileMatrix级别一个。
clock Clock <optional>
 确定时间维度的值时使用的时钟实例。指定“times”时为必需。
times TimeIntervalCollection <optional>
 TimeIntervalCollection，其data属性是一个包含时间动态维度及其值的对象。
dimensions Object <optional>
 包含静态维度及其值的对象。
tileWidth Number <optional>
 256 以像素为单位的平铺宽度。
tileHeight Number <optional>
 256 以像素为单位的平铺高度。
tilingScheme TilingScheme <optional>
 与tileMatrix集中的分片组织相对应的平铺方案。
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}占位符的子域。 如果此参数是单个字符串，则字符串中的每个字符都是子域。如果是的话 一个数组，数组中的每个元素都是一个子域。