WebMapTileServiceImageryProvider

new Cesium.WebMapTileServiceImageryProvider (options)

提供由符合 WMTS 1.0.0 的服务器提供的平铺图像。此提供程序支持 HTTP KVP 编码和 RESTful GetTile 请求,但尚不支持 SOAP 编码。
Name Type Description
options WebMapTileServiceImageryProvider.ConstructorOptions 描述初始化选项的对象
Examples:
// Example 1. USGS shaded relief tiles (KVP)
const 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)
const 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)
const times = Cesium.TimeIntervalCollection.fromIso8601({
    iso8601: '2015-07-30/2017-06-16/P1D',
    dataCallback: function dataCallback(interval, index) {
        return {
            Time: Cesium.JulianDate.toIso8601(interval.start)
        };
    }
});
const 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 之前不应调用此函数。
此提供程序的默认 alpha 混合值,0.0 表示完全透明,1.0 表示完全不透明。
Default Value: undefined

defaultBrightness : Number|undefined

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

defaultContrast : Number|undefined

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

defaultDayAlpha : Number|undefined

此提供程序的地球日侧的默认 alpha 混合值,0.0 表示完全透明,1.0 表示完全不透明。
Default Value: undefined
应用于此提供程序的默认伽马校正。 1.0 使用未修改的图像颜色。
Default Value: undefined
此提供程序的默认色调(以弧度为单位)。 0.0 使用未修改的图像颜色。
Default Value: undefined
应用于此提供程序的默认纹理放大过滤器。
Default Value: undefined
应用于此提供程序的默认纹理缩小过滤器。
Default Value: undefined

defaultNightAlpha : Number|undefined

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

defaultSaturation : Number|undefined

此提供程序的默认饱和度。 1.0 使用未修改的图像颜色。小于 1.0 会降低饱和度,而大于 1.0 会增加饱和度。
Default Value: undefined
获取或设置包含静态维度及其值的对象。
获取图像提供程序遇到异步错误时引发的事件。通过订阅该事件,您将收到错误通知,并有可能从中恢复。事件侦听器被传递一个 TileProviderError 实例。
获取此图像提供程序返回的图像的 MIME 类型。

readonly hasAlphaChannel : Boolean

获取一个值,该值指示此图像提供程序提供的图像是否包含 Alpha 通道。如果此属性为 false,则 Alpha 通道(如果存在)将被忽略。如果此属性为真,则任何没有 alpha 通道的图像都将被视为其 alpha 在任何地方都是 1.0。当此属性为 false 时,内存使用量和纹理上传时间会减少。

readonly maximumLevel : Number|undefined

获取可以请求的最大细节级别。在 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) undefined

此图像提供程序当前不支持选择要素,因此此函数仅返回未定义。
Name Type Description
x Number 平铺 X 坐标。
y Number 瓦片 Y 坐标。
level Number 瓷砖级别。
longitude Number 选择要素的经度。
latitude Number 选择要素的纬度。
Returns:
未定义,因为不支持拾取。

requestImage (x, y, level, request ) Promise.< ImageryTypes >|undefined

请求给定图块的图像。在 WebMapTileServiceImageryProvider#ready 返回 true 之前不应调用此函数。
Name Type Description
x Number 平铺 X 坐标。
y Number 瓦片 Y 坐标。
level Number 瓷砖级别。
request Request 可选 请求对象。仅供内部使用。
Returns:
对图像的承诺,当图像可用时将解析,或者如果对服务器的活动请求过多,则未定义,并且应稍后重试请求。
Throws:
  • DeveloperError :在图像提供程序准备好之前,不得调用 requestImage

Type Definitions

Cesium.WebMapTileServiceImageryProvider.ConstructorOptions

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} 占位符的子域。如果此参数是单个字符串,则字符串中的每个字符都是一个子域。如果是数组,则数组中的每个元素都是一个子域。