WebMapTileServiceImageryProvider

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

提供由 符合 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 : 'https://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 : 'https://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 479

获取或设置一个 clock，用于 get keep 用于 time 动态参数的时间。

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

获取此影像提供程序处于活动状态时要显示的点数。 通常，这用于贷记 图像的来源。

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

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

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

获取在影像提供程序遇到异步错误时引发的事件。 通过订阅 时，您将收到错误通知，并可能从中恢复。 事件侦听器 将传递 TileProviderError 的实例。

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

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

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

获取一个值，该值指示此图像提供程序是否提供图像 包括 Alpha 通道。 如果此属性为 false，则 Alpha 通道(如果存在)将 被忽略。 如果此属性为 true，则将处理任何没有 Alpha 通道的图像 就好像它们的 alpha 在所有地方都是 1.0 一样。 当此属性为 false 时，内存使用情况 和纹理上传时间缩短。

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

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

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

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

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

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

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

获取此实例提供的图像的矩形(以弧度为单位)。

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

获取瓦片丢弃策略。 如果未 undefined，则 discard 策略负责 用于通过其 shouldDiscardImage 函数过滤掉“缺失”的瓦片。 如果此功能 返回 undefined，不过滤任何图块。

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

获取每个图块的高度(以像素为单位)。

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

获取每个图块的宽度(以像素为单位)。

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

获取此提供程序使用的切片方案。

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

获取或设置用于获取时间动态参数的时间间隔集合。每个 TimeInterval 是一个对象，其中包含在 磁贴请求。

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

获取托管影像的服务的 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 588

此图像提供程序目前不支持选取功能，因此此函数仅返回 定义。
Name Type Description
x number 瓦片 X 坐标。
y number 瓦片 Y 坐标。
level number 瓦片级别。
longitude number 选取特征的经度。
latitude number 选取特征的纬度。
Returns:
Undefined，因为不支持拣选。

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

请求给定磁贴的图像。
Name Type Description
x number 瓦片 X 坐标。
y number 瓦片 Y 坐标。
level number 瓦片级别。
request Request optional 请求对象。仅供内部使用。
Returns:
当镜像可用时将解析的镜像的 Promise，或者 undefined 如果对服务器的活动请求过多，则应稍后重试该请求。

Type Definitions

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

WebMapTileServiceImageryProvider 构造函数的初始化选项
Properties:
Name Type Attributes Default Description
url Resource | string WMTS GetTile 操作(用于 KVP 编码的请求)或磁贴 URL 模板(用于 RESTful 请求)的基 URL。磁贴 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>
 图像提供商支持的最大细节层次，如果没有限制，则为 undefined。
ellipsoid Ellipsoid <optional>
 椭球体。 如果未指定，则使用 WGS84 椭球体。
credit Credit | string <optional>
 数据源的积分，显示在画布上。
subdomains string | Array.<string> <optional>
 'abc' 用于 URL 模板中 {s} 占位符的子域。 如果此参数是单个字符串，则字符串中的每个字符都是一个子域。 如果是 一个数组，数组中的每个元素都是一个子域。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.
CtrlK
packages/engine
packages/widgets