WebMapTileServiceImageryProvider

new Cesium.WebMapTileServiceImageryProvider(options)
engine/Source/Scene/WebMapTileServiceImageryProvider.js 115

提供由符合 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

clock : Clock
engine/Source/Scene/WebMapTileServiceImageryProvider.js 478

获取或设置用于获取时间动态参数的时钟。

readonly credit : Credit
engine/Source/Scene/WebMapTileServiceImageryProvider.js 455

获取激活此影像提供者时要显示的版权信息。通常用于给出 影像的来源。

dimensions : object
engine/Source/Scene/WebMapTileServiceImageryProvider.js 506

获取或设置包含静态维度及其值的对象。

readonly errorEvent : Event
engine/Source/Scene/WebMapTileServiceImageryProvider.js 430

获取在影像提供者遇到异步错误时引发的事件。通过订阅 该事件，您将被通知错误并可以潜在地从中恢复。事件监听器 会接收到 TileProviderError 的实例。

readonly format : string
engine/Source/Scene/WebMapTileServiceImageryProvider.js 442

获取此影像提供者返回的图像的 MIME 类型。

readonly hasAlphaChannel : boolean
engine/Source/Scene/WebMapTileServiceImageryProvider.js 467

获取一个值，指示此影像提供者提供的图像是否包含 alpha 通道。如果此属性为 false，则会忽略任何存在的 alpha 通道。如果此属性为 true，则任何没有 alpha 通道的图像都将被视为其 alpha 在各处为 1.0。当此属性为 false 时，内存使用和纹理上传时间会减少。

readonly maximumLevel : number|undefined
engine/Source/Scene/WebMapTileServiceImageryProvider.js 366

获取可以请求的最大细节级别。

readonly minimumLevel : number
engine/Source/Scene/WebMapTileServiceImageryProvider.js 378

获取可以请求的最小细节级别。

readonly proxy : Proxy
engine/Source/Scene/WebMapTileServiceImageryProvider.js 330

获取此提供者使用的代理。

readonly rectangle : Rectangle
engine/Source/Scene/WebMapTileServiceImageryProvider.js 402

获取此实例提供的影像的矩形（以弧度为单位）。

readonly tileDiscardPolicy : TileDiscardPolicy
engine/Source/Scene/WebMapTileServiceImageryProvider.js 416

获取瓦片丢弃策略。如果未定义，则丢弃策略负责 通过其 shouldDiscardImage 函数过滤掉“缺失”的瓦片。如果此函数 返回未定义，则没有瓦片被过滤。

readonly tileHeight : number
engine/Source/Scene/WebMapTileServiceImageryProvider.js 354

获取每个瓦片的高度（以像素为单位）。

readonly tileWidth : number
engine/Source/Scene/WebMapTileServiceImageryProvider.js 342

获取每个瓦片的宽度（以像素为单位）。

readonly tilingScheme : TilingScheme
engine/Source/Scene/WebMapTileServiceImageryProvider.js 390

获取此提供者使用的瓦片方案。

times : TimeIntervalCollection
engine/Source/Scene/WebMapTileServiceImageryProvider.js 492

获取或设置用于获取时间动态参数的时间区间集合。每个时间区间的数据是一个包含在瓦片请求期间使用的属性的键和值的对象。

readonly url : string
engine/Source/Scene/WebMapTileServiceImageryProvider.js 318

获取承载影像的服务 URL。

Methods

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

获取在显示给定瓦片时要显示的版权信息。
Name Type Description
x number 瓦片的 X 坐标。
y number 瓦片的 Y 坐标。
level number 瓦片级别。
Returns:
在显示瓦片时要显示的版权信息。

pickFeatures(x, y, level, longitude, latitude) → undefined
engine/Source/Scene/WebMapTileServiceImageryProvider.js 590

当前不支持此影像提供者的特征选择，因此此函数仅返回 未定义。
Name Type Description
x number 瓦片的 X 坐标。
y number 瓦片的 Y 坐标。
level number 瓦片级别。
longitude number 要选择特征的经度。
latitude number 要选择特征的纬度。
Returns:
未定义，因为不支持选择功能。

requestImage(x, y, level, request) → Promise.<ImageryTypes>|undefined
engine/Source/Scene/WebMapTileServiceImageryProvider.js 549

请求给定瓦片的图像。
Name Type Description
x number 瓦片的 X 坐标。
y number 瓦片的 Y 坐标。
level number 瓦片级别。
request Request optional 请求对象。仅供内部使用。
Returns:
图像的承诺，该承诺将在图像可用时解析，或者 如果活动请求过多，则返回未定义，请求应稍后重试。

Type Definitions

Cesium.WebMapTileServiceImageryProvider.ConstructorOptions
engine/Source/Scene/WebMapTileServiceImageryProvider.js 19

WebMapTileServiceImageryProvider 构造函数的初始化选项
Properties:
Name Type Attributes Default Description
url Resource | string WMTS GetTile 操作的基本 URL（用于 KVP 编码请求）或瓦片 URL 模板（用于 RESTful 请求）。瓦片 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>
 要用于 WMTS 请求的 TileMatrix 中的标识符列表，每个 TileMatrix 级别一个。
clock Clock <optional>
 在确定时间维度的值时使用的时钟实例。当指定 `times` 时，这是必需的。
times TimeIntervalCollection <optional>
 其 data 属性为包含时间动态维度及其值的对象的 TimeIntervalCollection。
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} 占位符的子域。如果此参数是单个字符串，则字符串中的每个字符都是一个子域。如果是数组，则数组中的每个元素都是一个子域。
需要帮助？获得答案的最快方法是来自社区和团队 Cesium Forum.
packages/engine
packages/widgets