SingleTileImageryProvider

new SuperMap3D.SingleTileImageryProvider(options)

提供单个顶级影像瓦片。假设单个影像使用GeographicTilingScheme。
Name Type Description
options Object 具有以下属性的对象:
Name Type Default Description
url String 瓦片的url。
rectangle Rectangle Rectangle.MAX_VALUE optional 影像覆盖的矩形（以弧度为单位）。
credit Credit | String optional 数据源的凭证，显示在画布上。
ellipsoid Ellipsoid optional 椭球。如果未指定，则使用 WGS84 椭球。
proxy Object optional 用于请求的代理。如果需要，该对象应具有一个 getURL 函数，用于返回代理 URL。
See:

Members

readonlycredit : Credit

获取该影像提供者激活时要显示的凭证。通常情况下，这将用于为影像来源加注信用。此函数不应在 SingleTileImageryProvider#ready 返回 true 之前调用。

readonlyerrorEvent : Event

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

readonlyhasAlphaChannel : Boolean

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

readonlymaximumLevel : Number

获取可请求的最大精细级别。在 SingleTileImageryProvider#ready 返回 true 之前不应调用此函数。

readonlyminimumLevel : Number

获取可请求的最小精细级别。在 SingleTileImageryProvider#ready 返回 true 之前不应调用此函数。

readonlyproxy : Proxy

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

readonlyready : Boolean

获取表示提供程序是否可以使用的值。

readonlyreadyPromise : Promise.<Boolean>

获取当提供程序准备就绪时解析为 true 的Promise。

readonlyrectangle : Rectangle

获取此实例所提供影像的矩形（以弧度为单位）。此函数不应在 SingleTileImageryProvider#ready 返回 true 之前调用。

readonlytileDiscardPolicy : TileDiscardPolicy

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

readonlytileHeight : Number

获取每个瓦片的高度（以像素为单位）。 此函数应在 SingleTileImageryProvider#ready 返回 true 之前不应调用。

readonlytileWidth : Number

获取每个瓦片的宽度（像素）。此函数不应在 SingleTileImageryProvider#ready 返回 true 之前调用。

readonlytilingScheme : TilingScheme

获取此提供程序使用的切图方案。此函数不应在 SingleTileImageryProvider#ready 返回 true 之前调用。

readonlyurl : String

获取单个顶级影像瓦片的 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) → Promise.<Array.<ImageryLayerFeatureInfo>>|undefined

该影像提供程序目前不支持选择特征，因此该函数返回未定义。
Name Type Description
x Number 瓦片的X坐标。
y Number 瓦片的Y坐标。
level Number 瓦片的级别。
longitude Number 选取特征的经度。
latitude Number 选取特征的纬度。
Returns:
当异步提取完成时，将解析所提取特征的Promise。 解析值是一个由 ImageryLayerFeatureInfo 实例组成的数组。 如果在给定位置没有找到特征，数组可能为空。如果不支持提取，该数组也可能是未定义的。

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

请求指定瓦片的影像。此函数不应在 SingleTileImageryProvider#ready 返回 true 之前调用。
Name Type Description
x Number 瓦片的X坐标。
y Number 瓦片的Y坐标。
level Number 瓦片的级别。
request Request optional 请求对象。仅供内部使用。
Returns:
影像的Promise，该Promise将在影像可用时解析该影像；如果服务器上有太多请求，则未定义该Promise，请求应稍后重试。 解析的影像可以是影像或 Canvas DOM 对象。
Throws:
  • DeveloperError : requestImage 不得在影像提供程序准备就绪前调用。