提供在地球表面显示的图像（接口描述，不直接实例化）。
- ArcGisMapServerImageryProvider
- BingMapsImageryProvider
- OpenStreetMapImageryProvider
- TileMapServiceImageryProvider
- GoogleEarthEnterpriseImageryProvider
- GoogleEarthEnterpriseMapsProvider
- GridImageryProvider
- MapboxImageryProvider
- MapboxStyleImageryProvider
- SingleTileImageryProvider
- TileCoordinatesImageryProvider
- UrlTemplateImageryProvider
- WebMapServiceImageryProvider
- WebMapTileServiceImageryProvider
Demo:
See:
Members
readonlycredit : Credit
获取此提供器在活跃状态下要显示的Credit。通常这是用来确认图像的来源。
在
ImageryProvider#ready返回true之前，不应该调用此函数。
默认的alpha混合值，0.0表示完全透明，1.0表示完全不透明。
-
Default Value:
undefined
此提供器的默认亮度值。值为1.0表示使用原图；值大于1.0时图像将变亮；值小于1.0时图像将变暗。
-
Default Value:
undefined
默认的对比度。值为1.0表示使用原图；值大于1.0表示增加对比度；值小于1.0表示降低对比度。
-
Default Value:
undefined
默认的伽马校正。值为1.0表示使用原图。
-
Default Value:
undefined
默认的色调。值为0.0表示使用原图。
-
Default Value:
undefined
defaultMagnificationFilter : TextureMagnificationFilter
默认的纹理放大过滤器。
-
Default Value:
undefined
defaultMinificationFilter : TextureMinificationFilter
默认的纹理缩小过滤器。
-
Default Value:
undefined
默认的饱和度。值为1.0表示使用原图；值大于1.0表示增加饱和度；值小于1.0表示降低饱和度。
-
Default Value:
undefined
readonlyerrorEvent : Event
获取此提供器遇到异步错误时触发的事件。
通过订阅事件，您将收到错误通知，并可能从中恢复。事件监听器传递一个
TileProviderError的实例。
获取一个值，该值指示此图像提供器提供的图像是否包含alpha通道。
如果此属性为false，则alpha通道（如果存在）将被忽略。如果此属性为true，则任何没有alpha通道的图像都将被视为alpha值为1.0。
当此属性为false时，内存使用和纹理上传时间将减少。
获取可以请求的最大层级。在
ImageryProvider#ready返回true之前，不应该调用此函数。
获取可以请求的最小级别。在
ImageryProvider#ready返回true之前，不应该调用此函数。
通常，只有当图像的矩形足够小，使得最小级别的瓦片数量足够少时，才应该使用最小级别。
一个图像提供器如果在最小级别上有多个图像瓦片，就会导致渲染问题。
获取此提供器使用的代理。
获取一个值，该值指示提供器是否已准备好使用。
获取在提供器准备使用时解析为true的promise。
readonlyrectangle : Rectangle
获取实例提供的图像的矩形（以弧度为单位）。在
ImageryProvider#ready返回true之前，不应该调用此函数。
readonlytileDiscardPolicy : TileDiscardPolicy
设置瓦片的丢弃策略。如果定义，丢弃策略负责通过其shouldDiscardImage函数过滤掉"missing"瓦片。
如果此函数返回未定义，则不过滤任何瓦片。在
ImageryProvider#ready返回true之前，不应该调用此函数。
获取每个瓦片的高度（以像素为单位）。在
ImageryProvider#ready返回true之前，不应该调用此函数。
获取每个瓦片的宽度（以像素为单位）。在
ImageryProvider#ready返回true之前，不应该调用此函数。
readonlytilingScheme : TilingScheme
获取此提供器使用的切片方案。在
ImageryProvider#ready返回true之前，不应该调用此函数。
Methods
从提供的的URL加载图像。如果URL引用的服务器已经有太多的请求等待处理，那么这个函数将返回undefined，这表示稍后应该重试请求。
| Name | Type | Description |
|---|---|---|
imageryProvider |
ImageryProvider | URL的图像提供器。 |
url |
Resource | String | 图像的URL。 |
Returns:
对图像的promise，当图像可用时，它将解析图像；
如果有太多对服务器的活动请求，则为未定义，并且应该稍后重试请求。解析后的图像可以是Image，也可以是画布DOM对象。
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
异步地确定哪些要素（如果有的话）位于瓦片中给定的经度和纬度。
在
ImageryProvider#ready返回true之前，不应该调用此函数。
这个函数是可选的，所以它可能不存在于所有的ImageryProviders上。
| Name | Type | Description |
|---|---|---|
x |
Number | 瓦片的X坐标。 |
y |
Number | 瓦片的Y坐标。 |
level |
Number | 瓦片的级别。 |
longitude |
Number | 拾取要素的经度。 |
latitude |
Number | 拾取要素的纬度。 |
Returns:
对所选要素的promise，它将在异步拾取完成时解析。
解析后的值是
ImageryLayerFeatureInfo实例的数组。如果在给定位置没有发现任何要素，则该数组可能为空。
如果不支持拾取，它也可能是未定义的。
Throws:
-
DeveloperError :
pickFeatures在图像提供器准备好之前不能被调用。
请求给定瓦片的图像。在
ImageryProvider#ready返回true之前，不应该调用此函数。
| Name | Type | Description |
|---|---|---|
x |
Number | 瓦片的X坐标。 |
y |
Number | 瓦片的Y坐标。 |
level |
Number | 瓦片的层级。 |
request |
Request | optional Request对象（仅供内部使用）。 |
Returns:
请求到的结果。
Throws:
-
DeveloperError :
requestImage在图像提供器准备好之前不能被调用。