Cesium API - SingleTileImageryProvider 中文文档

new Cesium.SingleTileImageryProvider(options)

提供单个顶层图像瓦片。假定单个图像使用GeographicTilingScheme。普通图片文件影像提供器 - 使用一张普通图片创建影像图层。

Name Type Description

options

Object

此对象拥有以下属性：

Name	Type	Default	Description
`url`	Resource \| String		瓦片url。
`rectangle`	Rectangle	`Rectangle.MAX_VALUE`	optional 地图矩形范围（弧度表示的）。
`credit`	Credit \| String		optional 数据源的版权，它显示在画布上。
`ellipsoid`	Ellipsoid		optional 椭球。如果未指定，则使用WGS84椭球。

参考：

成员变量

readonlycredit : Credit

Scene/SingleTileImageryProvider.js 296

获取版权信息。SingleTileImageryProvider#ready 返回true之前，不应调用此函数。

readonlyerrorEvent : Event

Scene/SingleTileImageryProvider.js 260

获取此提供器遇到异步错误时触发的事件。通过订阅事件，您将收到错误通知，并可能从中恢复。事件监听器传递一个TileProviderError的实例。

readonlyhasAlphaChannel : Boolean

Scene/SingleTileImageryProvider.js 308

获取影像是否有Alpha通道。

readonlymaximumLevel : Number

Scene/SingleTileImageryProvider.js 174

获取最大级别。 SingleTileImageryProvider#ready 返回true之前，不应调用此函数。

readonlyminimumLevel : Number

Scene/SingleTileImageryProvider.js 192

获取最小级别。 SingleTileImageryProvider#ready 返回true之前，不应调用此函数。

readonlyproxy : Proxy

Scene/SingleTileImageryProvider.js 126

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

readonlyready : Boolean

Scene/SingleTileImageryProvider.js 272

获取一个值，该值指示提供器是否已准备好使用。

readonlyreadyPromise : Promise.<Boolean>

Scene/SingleTileImageryProvider.js 284

获取一个在提供器准备好使用时解析为true的Promise。

readonlyrectangle : Rectangle

Scene/SingleTileImageryProvider.js 228

获取要显示的地图矩形范围（以弧度表示）。 SingleTileImageryProvider#ready 返回true之前，不应调用此函数。

readonlytileDiscardPolicy : TileDiscardPolicy

Scene/SingleTileImageryProvider.js 241

获取瓦片忽略策略。如果未定义，则忽略策略负责通过其shouldDiscardImage函数过滤掉“丢失”的瓦片。如果此函数返回未定义，则不过滤任何切片。 SingleTileImageryProvider#ready 返回true之前，不应调用此函数。

readonlytileHeight : Number

Scene/SingleTileImageryProvider.js 156

获取瓦片高，以像素为单位。SingleTileImageryProvider#ready 返回true之前，不应调用此函数。

readonlytileWidth : Number

Scene/SingleTileImageryProvider.js 138

获取瓦片宽，以像素为单位。SingleTileImageryProvider#ready 返回true之前，不应调用此函数。

readonlytilingScheme : TilingScheme

Scene/SingleTileImageryProvider.js 210

获取切片方案。SingleTileImageryProvider#ready 返回true之前，不应调用此函数。

readonlyurl : String

Scene/SingleTileImageryProvider.js 114

获取单个顶级图像瓦片的URL。

内置方法

getTileCredits(x, y, level) → Array.<Credit>

Scene/SingleTileImageryProvider.js 325

获取当请求的瓦片被显示出来时，要显示的版权信息。

Name	Type	Description
`x`	Number	瓦片的X坐标。
`y`	Number	瓦片的Y坐标。
`level`	Number	瓦片的层级。

返回值：

返回的版权。

异常情况：

DeveloperError : 在图像提供器准备就绪之前，不得调用 getTileCredits 。

pickFeatures(x, y, level, longitude, latitude) → Promise.<Array.<ImageryLayerFeatureInfo>>|undefined

Scene/SingleTileImageryProvider.js 365

这个图像提供器目前不支持拾取功能，所以这个函数只是返回未定义。

Name	Type	Description
`x`	Number	瓦片的X坐标。
`y`	Number	瓦片的Y坐标。
`level`	Number	瓦片的级别。
`longitude`	Number	拾取要素的经度。
`latitude`	Number	拾取要素的纬度。

返回值：

对所选要素的promise，它将在异步拾取完成时解析。解析后的值是ImageryLayerFeatureInfo实例的数组。如果在给定位置没有发现任何要素，则该数组可能为空。如果不支持拾取，它也可能是未定义的。

requestImage(x, y, level, request) → Promise.<(Image|Canvas)>|undefined

Scene/SingleTileImageryProvider.js 343

请求给定块的瓦片。SingleTileImageryProvider＃ready返回true之前，不应调用此函数。

Name	Type	Description
`x`	Number	瓦片的X坐标。
`y`	Number	瓦片的Y坐标。
`level`	Number	瓦片的层级。
`request`	Request	optional Request对象（仅供内部使用）。