TileMapServiceImageryProvider

new Cesium.TileMapServiceImageryProvider(options)
engine/Source/Scene/TileMapServiceImageryProvider.js 75

要构造 TileMapServiceImageryProvider，请调用 TileMapServiceImageryProvider.fromUrl。不要直接调用构造函数。
一个影像提供者，提供由 MapTiler、GDAL2Tiles 等工具生成的瓦片影像。
Name Type Description
options TileMapServiceImageryProvider.ConstructorOptions optional 描述初始化选项的对象
Example:
const tms = await Cesium.TileMapServiceImageryProvider.fromUrl(
   "../images/cesium_maptiler/Cesium_Logo_Color", {
     fileExtension: 'png',
     maximumLevel: 4,
     rectangle: new Cesium.Rectangle(
       Cesium.Math.toRadians(-120.0),
       Cesium.Math.toRadians(20.0),
       Cesium.Math.toRadians(-60.0),
       Cesium.Math.toRadians(40.0))
});
See:

Extends

Members

readonly credit : Credit
engine/Source/Scene/UrlTemplateImageryProvider.js 476

获取当此影像提供者激活时显示的版权信息。通常用于注明 影像的来源。
Inherited From:
Default Value: undefined

enablePickFeatures : boolean
engine/Source/Scene/UrlTemplateImageryProvider.js 263

获取或设置一个值，该值指示是否启用要素拾取。如果为 true，UrlTemplateImageryProvider#pickFeatures 将 请求 options.pickFeaturesUrl 并尝试解释响应中包含的要素。如果为 false， UrlTemplateImageryProvider#pickFeatures 将立即返回 undefined（表示没有可拾取的 要素）而不与服务器通信。如果您知道数据源不支持拾取要素或不想 让此提供者的要素可拾取，请将此属性设置为 false。
Inherited From:
Default Value: true

readonly errorEvent : Event
engine/Source/Scene/UrlTemplateImageryProvider.js 462

获取当影像提供者遇到异步错误时引发的事件。通过订阅 该事件，您将收到错误通知并可能从中恢复。事件监听器 将接收一个 TileProviderError 实例。
Inherited From:

readonly hasAlphaChannel : boolean
engine/Source/Scene/UrlTemplateImageryProvider.js 493

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

readonly maximumLevel : number|undefined
engine/Source/Scene/UrlTemplateImageryProvider.js 394

获取可以请求的最大细节层级，如果没有限制则为 undefined。
Inherited From:
Default Value: undefined

readonly minimumLevel : number
engine/Source/Scene/UrlTemplateImageryProvider.js 407

获取可以请求的最小细节层级。
Inherited From:
Default Value: 0

readonly pickFeaturesUrl : string
engine/Source/Scene/UrlTemplateImageryProvider.js 342

获取用于拾取要素的 URL 模板。如果未指定此属性， UrlTemplateImageryProvider#pickFeatures 将立即返回 undefined，表示没有 拾取到要素。该 URL 模板支持 UrlTemplateImageryProvider#url 属性支持的 所有关键字，以及以下关键字：
  • {i}：拾取位置的像素列（水平坐标），其中最西边的像素为 0。
  • {j}：拾取位置的像素行（垂直坐标），其中最北边的像素为 0。
  • {reverseI}：拾取位置的像素列（水平坐标），其中最东边的像素为 0。
  • {reverseJ}：拾取位置的像素行（垂直坐标），其中最南边的像素为 0。
  • {longitudeDegrees}：拾取位置的经度，单位为度。
  • {latitudeDegrees}：拾取位置的纬度，单位为度。
  • {longitudeProjected}：拾取位置的经度，使用平铺方案的投影坐标。
  • {latitudeProjected}：拾取位置的纬度，使用平铺方案的投影坐标。
  • {format}：获取要素信息的格式，如 GetFeatureInfoFormat 中所指定。
Inherited From:

readonly proxy : Proxy
engine/Source/Scene/UrlTemplateImageryProvider.js 355

获取此提供者使用的代理。
Inherited From:
Default Value: undefined

readonly rectangle : Rectangle
engine/Source/Scene/UrlTemplateImageryProvider.js 433

获取此实例提供的影像的矩形区域，单位为弧度。
Inherited From:
Default Value: tilingScheme.rectangle

readonly tileDiscardPolicy : TileDiscardPolicy
engine/Source/Scene/UrlTemplateImageryProvider.js 448

获取瓦片丢弃策略。如果未定义，丢弃策略负责 通过其 shouldDiscardImage 函数过滤掉"缺失"的瓦片。如果此函数 返回 undefined，则不过滤任何瓦片。
Inherited From:
Default Value: undefined

readonly tileHeight : number
engine/Source/Scene/UrlTemplateImageryProvider.js 381

获取每个瓦片的高度，单位为像素。
Inherited From:
Default Value: 256

readonly tileWidth : number
engine/Source/Scene/UrlTemplateImageryProvider.js 368

获取每个瓦片的宽度，单位为像素。
Inherited From:
Default Value: 256

readonly tilingScheme : TilingScheme
engine/Source/Scene/UrlTemplateImageryProvider.js 420

获取此提供者使用的平铺方案。
Inherited From:
Default Value: new WebMercatorTilingScheme()

readonly url : string
engine/Source/Scene/UrlTemplateImageryProvider.js 292

获取用于请求瓦片的 URL 模板。它包含以下关键字：
  • {z}：瓦片在平铺方案中的层级。层级零是四叉树金字塔的根节点。
  • {x}：瓦片在平铺方案中的 X 坐标，其中 0 是最西边的瓦片。
  • {y}：瓦片在平铺方案中的 Y 坐标，其中 0 是最北边的瓦片。
  • {s}：可用子域名之一，用于克服浏览器对每个主机同时请求数量的限制。
  • {reverseX}：瓦片在平铺方案中的 X 坐标，其中 0 是最东边的瓦片。
  • {reverseY}：瓦片在平铺方案中的 Y 坐标，其中 0 是最南边的瓦片。
  • {reverseZ}：瓦片在平铺方案中的层级，其中层级零是四叉树金字塔的最大层级。要使用 reverseZ，必须定义 maximumLevel。
  • {westDegrees}：瓦片的西边界，单位为大地度数。
  • {southDegrees}：瓦片的南边界，单位为大地度数。
  • {eastDegrees}：瓦片的东边界，单位为大地度数。
  • {northDegrees}：瓦片的北边界，单位为大地度数。
  • {westProjected}：瓦片的西边界，使用平铺方案的投影坐标。
  • {southProjected}：瓦片的南边界，使用平铺方案的投影坐标。
  • {eastProjected}：瓦片的东边界，使用平铺方案的投影坐标。
  • {northProjected}：瓦片的北边界，使用平铺方案的投影坐标。
  • {width}：每个瓦片的宽度，单位为像素。
  • {height}：每个瓦片的高度，单位为像素。
Inherited From:

readonly urlSchemeZeroPadding : object
engine/Source/Scene/UrlTemplateImageryProvider.js 316

获取每个瓦片坐标的 URL 方案零填充。格式为 '000'，其中每个坐标将在左侧 填充零以匹配传入的零字符串的宽度。例如，设置： urlSchemeZeroPadding : { '{x}' : '0000'} 将使 x 值 12 在生成的 URL 中返回字符串 '0012'。 它包含以下关键字：
  • {z}：瓦片在平铺方案中层级的零填充。
  • {x}：瓦片在平铺方案中 X 坐标的零填充。
  • {y}：瓦片在平铺方案中 Y 坐标的零填充。
  • {reverseX}：瓦片在平铺方案中 reverseX 坐标的零填充。
  • {reverseY}：瓦片在平铺方案中 reverseY 坐标的零填充。
  • {reverseZ}：瓦片在平铺方案中 reverseZ 坐标的零填充。
Inherited From:

Methods

static Cesium.TileMapServiceImageryProvider.fromUrl(url, options) → Promise.<TileMapServiceImageryProvider>
engine/Source/Scene/TileMapServiceImageryProvider.js 128

从指定的 URL 创建 TileMapServiceImageryProvider。
Name Type Description
url Resource | string 服务器上图像瓦片的路径。
options TileMapServiceImageryProvider.ConstructorOptions optional 描述初始化选项的对象。
Returns:
一个解析为所创建的 TileMapServiceImageryProvider 的 Promise。
Throws:
  • RuntimeError : 在 tilemapresource.xml 中无法找到预期的 tilesets 或 bbox 属性
  • RuntimeError : tilemapresource.xml 指定了不支持的 profile 属性
Example:
const tms = await Cesium.TileMapServiceImageryProvider.fromUrl(
   '../images/cesium_maptiler/Cesium_Logo_Color', {
     fileExtension: 'png',
     maximumLevel: 4,
     rectangle: new Cesium.Rectangle(
       Cesium.Math.toRadians(-120.0),
       Cesium.Math.toRadians(20.0),
       Cesium.Math.toRadians(-60.0),
       Cesium.Math.toRadians(40.0))
});

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

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

pickFeatures(x, y, level, longitude, latitude) → Promise.<Array.<ImageryLayerFeatureInfo>>|undefined
engine/Source/Scene/UrlTemplateImageryProvider.js 545

异步确定在瓦片内给定经度和纬度处存在哪些要素（如果有）。
Name Type Description
x number 瓦片的 X 坐标。
y number 瓦片的 Y 坐标。
level number 瓦片的层级。
longitude number 用于拾取要素的经度。
latitude number 用于拾取要素的纬度。
Returns:
拾取要素的承诺，将在异步 拾取完成时解析。解析的值是 ImageryLayerFeatureInfo 实例的数组。如果在给定位置未找到要素，数组可能为空。 如果不支持拾取，也可能为 undefined。
Inherited From:

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

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

Type Definitions

Cesium.TileMapServiceImageryProvider.ConstructorOptions
engine/Source/Scene/TileMapServiceImageryProvider.js 16

TileMapServiceImageryProvider 构造函数的初始化选项
Properties:
Name Type Attributes Default Description
fileExtension string <optional>
 'png' 服务器上图像的文件扩展名。
credit Credit | string <optional>
 '' 数据源的署名信息，显示在画布上。
minimumLevel number <optional>
 0 影像提供者支持的最小细节级别。指定此值时需注意， 最小级别的瓦片数量应较少，如四个或更少。较大的数值可能会导致 渲染问题。
maximumLevel number <optional>
 影像提供者支持的最大细节级别，如果无限制则为 undefined。
rectangle Rectangle <optional>
 Rectangle.MAX_VALUE 图像覆盖的矩形区域，单位为弧度。
tilingScheme TilingScheme <optional>
 指定如何将椭球面 分割为瓦片的瓦片方案。如果未提供此参数，则使用 WebMercatorTilingScheme。
ellipsoid Ellipsoid <optional>
 椭球体。如果指定了 tilingScheme， 则忽略此参数，转而使用瓦片方案的椭球体。如果两个 参数都未指定，则使用 WGS84 椭球体。
tileWidth number <optional>
 256 图像瓦片的像素宽度。
tileHeight number <optional>
 256 图像瓦片的像素高度。
flipXY boolean <optional>
 旧版本的 gdal2tiles.py 在 tilemapresource.xml 中翻转了 X 和 Y 值。
tileDiscardPolicy TileDiscardPolicy <optional>
 根据某些条件丢弃瓦片图像的策略。 指定此选项将执行相同操作，允许加载这些不正确的瓦片集。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.
CtrlK
packages/engine
packages/widgets