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。 |
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 xNumber 瓦片的X坐标。
yNumber 瓦片的Y坐标。
levelNumber 瓦片的级别。
Throws:
-
getTileCredits不得在影像提供程序准备就绪前调用。 - Type
- DeveloperError
Returns:
Type Description Array.<Credit> 显示瓦片时要显示的版权声明。 -
-
pickFeatures(x, y, level, longitude, latitude){Promise.<Array.<ImageryLayerFeatureInfo>>|undefined}
-
该影像提供程序目前不支持选择特征,因此该函数返回未定义。
Name Type Description xNumber 瓦片的X坐标。
yNumber 瓦片的Y坐标。
levelNumber 瓦片的级别。
longitudeNumber 选取特征的经度。
latitudeNumber 选取特征的纬度。
Returns:
Type Description Promise.<Array.<ImageryLayerFeatureInfo>> | undefined 当异步提取完成时,将解析所提取特征的Promise。 解析值是一个由 ImageryLayerFeatureInfo实例组成的数组。 如果在给定位置没有找到特征,数组可能为空。如果不支持提取,该数组也可能是未定义的。 -
requestImage(x, y, level, request){Promise.<(Image|Canvas)>|undefined}
-
请求指定瓦片的影像。此函数不应在
SingleTileImageryProvider#ready返回 true 之前调用。Name Type Description xNumber 瓦片的X坐标。
yNumber 瓦片的Y坐标。
levelNumber 瓦片的级别。
requestRequest 可选 请求对象。仅供内部使用。
Throws:
-
requestImage不得在影像提供程序准备就绪前调用。 - Type
- DeveloperError
Returns:
Type Description Promise.<(Image|Canvas)> | undefined 影像的Promise,该Promise将在影像可用时解析该影像;如果服务器上有太多请求,则未定义该Promise,请求应稍后重试。 解析的影像可以是影像或 Canvas DOM 对象。 -