提供要在椭球体表面显示的图像。 此类型描述
接口,并且不打算直接实例化。
- ArcGisMapServerImageryProvider
- BingMapsImageryProvider
- OpenStreetMapImageryProvider
- TileMapServiceImageryProvider
- GoogleEarthEnterpriseImageryProvider
- GoogleEarthEnterpriseMapsProvider
- GridImageryProvider
- IonImageryProvider
- MapboxImageryProvider
- MapboxStyleImageryProvider
- SingleTileImageryProvider
- TileCoordinatesImageryProvider
- UrlTemplateImageryProvider
- WebMapServiceImageryProvider
- WebMapTileServiceImageryProvider
Demo:
See:
Members
readonly credit : Credit
获取此影像提供程序处于活动状态时要显示的点数。 通常,这用于贷记
图像的来源。
readonly errorEvent : Event
获取在影像提供程序遇到异步错误时引发的事件。 通过订阅
时,您将收到错误通知,并可能从中恢复。 事件侦听器
将传递
TileProviderError
的实例。
获取一个值,该值指示此图像提供程序是否提供图像
包括 Alpha 通道。 如果此属性为 false,则 Alpha 通道(如果存在)将
被忽略。 如果此属性为 true,则将处理任何没有 Alpha 通道的图像
就好像它们的 alpha 在所有地方都是 1.0 一样。 当此属性为 false 时,内存使用情况
和纹理上传时间缩短。
获取可请求的最大详细级别。
获取可请求的最低详细级别。 一般
仅当图像的矩形较小时,才应使用最低级别
足以使最低级别的图块数量很少。 图像
提供者在最低级别上拥有多个图块将导致
渲染问题。
readonly proxy : Proxy
获取此提供程序使用的代理。
readonly rectangle : Rectangle
获取实例提供的图像的矩形(以弧度为单位)。
readonly tileDiscardPolicy : TileDiscardPolicy
获取瓦片丢弃策略。 如果未 undefined,则 discard 策略负责
用于通过其 shouldDiscardImage 函数过滤掉“缺失”的瓦片。 如果此功能
返回 undefined,不过滤任何图块。
获取每个图块的高度(以像素为单位)。
获取每个图块的宽度(以像素为单位)。
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,当图像可用时将解析,或者
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
异步确定哪些要素(如果有)位于给定的经度和纬度
一个图块。
此函数是可选的,因此它可能并非存在于所有 ImageryProvider 中。
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 如果对服务器的活动请求过多,则应稍后重试该请求。