提供由Web地图服务(WMS)服务器托管的瓦片图像。
| Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
Object |
此对象拥有以下属性：
|
Example:
var provider = new Cesium.WebMapServiceImageryProvider({
url : 'https://sampleserver1.arcgisonline.com/ArcGIS/services/Specialty/ESRI_StatesCitiesRivers_USA/MapServer/WMSServer',
layers : '0',
proxy: new Cesium.DefaultProxy('/proxy/')
});
viewer.imageryLayers.addImageryProvider(provider);See:
Members
要包含在WMS URL中的默认参数以获取图像。取值如下：
service=WMS
version=1.1.1
request=GetMap
styles=
format=image/jpeg
WMS URL中包含的默认参数以获取要素信息。取值如下：
service=WMS
version=1.1.1
request=GetFeatureInfo
获取或设置用于获取用于时间动态参数的时间的时钟实例。
readonlycredit : Credit
获取版权信息。在
WebMapServiceImageryProvider#ready返回true之前，不应该调用此函数。
如果为true，
WebMapServiceImageryProvider#pickFeatures将调用WMS服务器上的GetFeatureInfo操作，并返回响应中包含的要素。
如果是false， WebMapServiceImageryProvider#pickFeatures将立即返回undefined（表示没有可拾取的要素），而不需要与服务器通信。
如果您知道您的WMS服务器不支持GetFeatureInfo，或者您不希望该提供者的要素可拾取，则将此属性设置为false。
-
Default Value:
true
readonlyerrorEvent : Event
获取此提供器遇到异步错误时触发的事件。
通过订阅事件，您将收到错误通知，并可能从中恢复。事件监听器传递一个
TileProviderError的实例。
获取影像是否有Alpha通道。
要包括的图层，以逗号分隔。
获取可以请求的最大级别。在
WebMapServiceImageryProvider#ready返回true之前，不应该调用此函数。
获取可以请求的最小级别。在
WebMapServiceImageryProvider#ready返回true之前，不应该调用此函数。
获取此提供器使用的代理。
获取一个值，该值指示提供器是否已准备好使用。
获取一个在提供器准备好使用时解析为true的Promise。
readonlyrectangle : Rectangle
地图矩形范围。在
WebMapServiceImageryProvider#ready返回true之前，不应该调用此函数。
readonlytileDiscardPolicy : TileDiscardPolicy
获取瓦片忽略策略。如果未定义，则忽略策略负责通过其shouldDiscardImage函数过滤掉“丢失”的瓦片。
如果此函数返回未定义，则不过滤任何切片。在
WebMapServiceImageryProvider#ready返回true之前，不应该调用此函数。
获取瓦片高，以像素为单位。在
WebMapServiceImageryProvider#ready返回true之前，不应该调用此函数。
获取瓦片宽，以像素为单位。在
WebMapServiceImageryProvider#ready返回true之前，不应该调用此函数。
readonlytilingScheme : TilingScheme
获取切片方案。在
WebMapServiceImageryProvider#ready返回true之前，不应该调用此函数。
获取或设置用于获取时间动态参数的时间间隔集合。每个的数据
TimeInterval是一个对象，它包含在瓦片请求期间使用的属性的键和值。
获取WMS服务器的URL。
Methods
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在图像提供器准备好之前不能被调用。
请求给定块的瓦片。在
WebMapServiceImageryProvider#ready返回true之前，不应该调用此函数。
| Name | Type | Description |
|---|---|---|
x |
Number | 瓦片的X坐标。 |
y |
Number | 瓦片的Y坐标。 |
level |
Number | 瓦片的层级。 |
request |
Request | optional Request对象（仅供内部使用）。 |
Returns:
返回值有以下3种情况：
1.当图像可用时，返回对图像的Promise。
2.如果有太多对服务器的活动请求，则返回未定义图像，并且应该稍后重新请求。
3.解析后的图像可以是图像，也可以是画布DOM对象。
Throws:
-
DeveloperError :
requestImagemust not be called before the imagery provider is ready.