new Cesium.ArcGisMapServerImageryProvider(options)
提供由ArcGIS MapServer托管的瓦片图像。默认情况下,使用服务器的预缓存切片(如果有)。
Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
Object |
此对象拥有以下属性:
|
示例:
var esri = new Cesium.ArcGisMapServerImageryProvider({
url : 'https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer'
});
参考:
成员变量
获取版权信息。 在
ArcGisMapServerImageryProvider#ready
返回true之前,不应调用此函数。
enablePickFeatures : Boolean
获取或设置一个值,该值指示是否启用要素拾取。
如果为true,
ArcGisMapServerImageryProvider#pickFeatures
将调用MapServer上的Identify服务并返回响应中包含的要素。
如果为false, ArcGisMapServerImageryProvider#pickFeatures
将立即返回undefined(表示没有可拾取的要素),而不与服务器通信。
-
Default Value:
true
获取此提供器遇到异步错误时触发的事件。
通过订阅事件,您将收到错误通知,并可能从中恢复。事件监听器传递一个
TileProviderError
的实例。
获取影像是否有Alpha通道。
-
Default Value:
true
layers : String
获取要显示的图层ID。
获取请求的最大级别。
在
ArcGisMapServerImageryProvider#ready
返回true之前,不应调用此函数。
获取请求的最小级别。
在
ArcGisMapServerImageryProvider#ready
返回true之前,不应调用此函数。
获取此提供器使用的代理。
获取一个值,该值指示提供器是否已准备好使用。
获取一个在提供器准备就绪时可以解析为true的Promise。
获取要显示的地图矩形范围(以弧度表示)。
在
ArcGisMapServerImageryProvider#ready
返回true之前,不应调用此函数。
获取瓦片忽略策略。如果未定义,则丢弃策略负责通过其shouldDiscardImage函数过滤掉“丢失”的瓦片。
如果此函数返回未定义,则不过滤任何切片。
在
ArcGisMapServerImageryProvider#ready
返回true之前,不应调用此函数。
获取瓦片高,以像素为单位。
在
ArcGisMapServerImageryProvider#ready
返回true之前,不应调用此函数。
获取瓦片宽,以像素为单位。
在
ArcGisMapServerImageryProvider#ready
返回true之前,不应调用此函数。
获取切片方案。
在
ArcGisMapServerImageryProvider#ready
返回true之前,不应调用此函数。
获取用于使用ArcGIS MapServer服务进行身份验证的ArcGIS令牌。
获取ArcGIS MapServer 的URL。
获取是否启使用预缓存瓦片。
如果图像提供器尚未准备就绪(
ArcGisMapServerImageryProvider#ready
),即使MapServer没有预缓存的瓦片,
此函数也会返回`options.usePreCachedTilesIfAvailable`的值。
-
Default Value:
true
内置方法
获取当请求的瓦片被显示出来时,要显示的版权信息。
Name | Type | Description |
---|---|---|
x |
Number | 瓦片的X坐标。 |
y |
Number | 瓦片的Y坐标。 |
level |
Number | 瓦片的层级。 |
返回值:
返回的版权。
异常情况:
-
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 | 拾取要素的纬度。 |
返回值:
对所选要素的promise,它将在异步拾取完成时解析。
解析后的值是
ImageryLayerFeatureInfo
实例的数组。如果在给定位置没有发现任何要素,则该数组可能为空。
如果不支持拾取,它也可能是未定义的。
异常情况:
-
DeveloperError :
pickFeatures
在图像提供器准备好之前不能被调用。
requestImage(x, y, level, request) → Promise.<(Image|Canvas)>|undefined
请求给定块的瓦片。
在
ArcGisMapServerImageryProvider#ready
返回true之前,不应调用此函数。
Name | Type | Description |
---|---|---|
x |
Number | 瓦片的X坐标。 |
y |
Number | 瓦片的Y坐标。 |
level |
Number | 瓦片的层级。 |
request |
Request | optional Request对象(仅供内部使用)。 |
返回值:
返回值有以下3种情况:
1.当图像可用时,返回对图像的Promise。
2.如果有太多对服务器的活动请求,则返回未定义图像,并且应该稍后重新请求。
3.解析后的图像可以是图像,也可以是画布DOM对象。
异常情况:
-
DeveloperError : 准备好图像提供器之前,不得调用
requestImage
。