提供将在椭球体表面显示的图像。此类型描述了一个接口,
并不打算被直接实例化。
- ArcGisMapServerImageryProvider
- BingMapsImageryProvider
- OpenStreetMapImageryProvider
- TileMapServiceImageryProvider
- GoogleEarthEnterpriseImageryProvider
- GoogleEarthEnterpriseMapsProvider
- GridImageryProvider
- IonImageryProvider
- MapboxImageryProvider
- MapboxStyleImageryProvider
- SingleTileImageryProvider
- TileCoordinatesImageryProvider
- UrlTemplateImageryProvider
- WebMapServiceImageryProvider
- WebMapTileServiceImageryProvider
Demo:
See:
Members
readonly credit : Credit
获取在此图像提供者激活时要显示的信用信息。通常用于信用
图像的来源。
获取一个值,指示此图像提供者提供的图像是否包含 alpha 通道。
如果此属性为 false,如果存在,将忽略 alpha 通道。
如果此属性为 true,则没有 alpha 通道的图像将被视为其
alpha 在所有地方都是 1.0。当此属性为 false 时,
内存使用量和纹理上传时间会减少。
获取可以请求的最大细节级别。
获取可以请求的最小细节级别。通常,
仅当图像的矩形足够小,使得最小级别的瓦片数量较小时,才应使用最小级别。
拥有超过几个瓦片的图像提供者在最小级别将导致
渲染问题。
readonly proxy : Proxy
获取此提供者使用的代理。
readonly rectangle : Rectangle
获取此实例提供的图像的矩形,单位为弧度。
readonly tileDiscardPolicy : TileDiscardPolicy
获取瓦片丢弃策略。如果未定义,丢弃策略负责
通过其 shouldDiscardImage 函数过滤掉“缺失”瓦片。如果此函数
返回未定义,则不过滤任何瓦片。
获取每个瓦片的高度,单位为像素。
获取每个瓦片的宽度,单位为像素。
readonly tilingScheme : TilingScheme
获取提供者使用的瓦片方案。
Methods
static Cesium.ImageryProvider.loadImage(imageryProvider, url) → Promise.<(ImageryTypes|CompressedTextureBuffer)>|undefined
从给定 URL 加载图像。如果 URL 所引用的服务器已经有
太多待处理请求,则此函数将返回 undefined,指示
请求应稍后重试。
| Name | Type | Description |
|---|---|---|
imageryProvider |
ImageryProvider | 该 URL 的图像提供者。 |
url |
Resource | string | 图像的 URL。 |
Returns:
一个 Promise,该 Promise 在图像可用时解析为图像,或
如果对服务器的活动请求过多,则返回 undefined,表示请求应稍后重试。
getTileCredits(x, y, level) → Array.<Credit>
获取在给定瓦片显示时要显示的信用信息。
| Name | Type | Description |
|---|---|---|
x |
number | 瓦片的 X 坐标。 |
y |
number | 瓦片的 Y 坐标。 |
level |
number | 瓦片级别; |
Returns:
在瓦片显示时要展示的信用信息。
pickFeatures(x, y, level, longitude, latitude) → Promise.<Array.<ImageryLayerFeatureInfo>>|undefined
异步确定在给定经度和纬度内,瓦片上是否存在特征(如果有的话)。
此函数是可选的,因此并非所有的 ImageryProviders 都会存在该函数。
| Name | Type | Description |
|---|---|---|
x |
number | 瓦片的 X 坐标。 |
y |
number | 瓦片的 Y 坐标。 |
level |
number | 瓦片级别。 |
longitude |
number | 要选择特征的经度。 |
latitude |
number | 要选择特征的纬度。 |
Returns:
一个 Promise,表示选中的特征,在异步选择完成时解析。解析值是一个
ImageryLayerFeatureInfo 实例的数组。如果在给定位置未找到特征,数组可能为空。如果不支持选择,则可能返回 undefined。
requestImage(x, y, level, request) → Promise.<ImageryTypes>|undefined
请求给定瓦片的图像。
| Name | Type | Description |
|---|---|---|
x |
number | 瓦片的 X 坐标。 |
y |
number | 瓦片的 Y 坐标。 |
level |
number | 瓦片级别。 |
request |
Request | optional 请求对象。仅供内部使用。 |
Returns:
返回一个 Promise,该 Promise 在图像可用时解析;如果对服务器的活动请求过多,则返回 undefined,表示请求应稍后重试。
