Class: SingleTileImageryProvider

SingleTileImageryProvider

new SingleTileImageryProvider()

用于加载单张静态图片作为影像图层类

Name Type Default Description
options.url String

瓦片的url。

options.rectangle Rectangle Rectangle.MAX_VALUE 可选

影像覆盖的矩形(以弧度为单位)。

options.credit Credit | String 可选

数据源的版权声明,显示在画布上。

options.ellipsoid Ellipsoid 可选

椭球。如果未指定,则使用 WGS84 椭球。

options.proxy Object 可选

用于请求的代理。如果需要,该对象应具有一个 getURL 函数,用于返回代理 URL。

See:

Members

readonly creditCredit

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

readonly errorEventEvent

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

readonly hasAlphaChannelBoolean

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

readonly maximumLevelNumber

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

readonly minimumLevelNumber

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

readonly proxyProxy

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

readonly readyBoolean

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

readonly readyPromisePromise.<Boolean>

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

readonly rectangleRectangle

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

readonly tileDiscardPolicyTileDiscardPolicy

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

readonly tileHeightNumber

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

readonly tileWidthNumber

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

readonly tilingSchemeTilingScheme

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

readonly urlString

获取单一顶层影像瓦片的URL。

Methods

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

获取显示给定瓦片时要显示的版权声明。

Name Type Description
x Number

瓦片的X坐标。

y Number

瓦片的Y坐标。

level Number

瓦片的级别。

Throws:

getTileCredits 不得在影像提供程序准备就绪前调用。

Type
DeveloperError
Returns:
Type Description
Array.<Credit> 显示瓦片时要显示的版权声明。

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:
Type Description
Promise.<Array.<ImageryLayerFeatureInfo>> | undefined 当异步提取完成时,将解析所提取特征的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 可选

请求对象。仅供内部使用。

Throws:

requestImage 不得在影像提供程序准备就绪前调用。

Type
DeveloperError
Returns:
Type Description
Promise.<(Image|Canvas)> | undefined 影像的Promise,该Promise将在影像可用时解析该影像;如果服务器上有太多请求,则未定义该Promise,请求应稍后重试。 解析的影像可以是影像或 Canvas DOM 对象。