WebMapServiceImageryProvider

提供由Web地图服务（WMS）服务器托管的平铺图像。

new WebMapServiceImageryProvider(options)

Parameters:

options (Object)

Name	Description
options.url `(Resource \| String)`	WMS服务的URL。URL支持与`UrlTemplateImageryProvider`相同的关键字。
options.layers `String`	要包含的层，用逗号分隔。
options.parameters `Object` default `WebMapServiceImageryProvider.DefaultParameters`	要在getmap url中传递给WMS服务器的其他参数。
options.getFeatureInfoParameters `Object` default `WebMapServiceImageryProvider.GetFeatureInfoDefaultParameters`	要在getFeatureInfo URL中传递给WMS服务器的其他参数。
options.enablePickFeatures `Boolean` default `true`	如果为真，`WebMapServiceImageryProvider#pickFeatures`将在WMS服务器上调用GetFeatureInfo操作，并返回响应中包含的功能。如果为false，`WebMapServiceImageryProvider#pickFeatures`将立即返回未定义（表示没有可选择的功能），而不与服务器通信。如果知道WMS服务器不支持GetFeatureInfo，或者不希望此提供程序的功能可供选择，请将此属性设置为false。请注意，可以通过修改WebMapServiceImageryProvider#EnablePickFeatures属性来动态覆盖此属性。
options.getFeatureInfoFormats `Array.<GetFeatureInfoFormat>` default `WebMapServiceImageryProvider.DefaultGetFeatureInfoFormats`	尝试WMS GetFeatureInfo请求的格式。
options.rectangle `Rectangle` default `Rectangle.MAX_VALUE`	层的矩形。
options.tilingScheme `TilingScheme` default `new GeographicTilingScheme()`	将世界划分为瓦片的瓦片切片方案。
options.ellipsoid `Ellipsoid`	椭球体。如果指定了平铺切片方案，则忽略此参数，而使用平铺方案的椭球体。如果未指定任何参数，则使用wgs84椭球体。
options.tileWidth `Number` default `256`	每个瓦片的宽度（像素）。
options.tileHeight `Number` default `256`	每个瓦片的高度（像素）。
options.minimumLevel `Number` default `0`	图像提供商支持的最低详细程度。在指定此选项时，请注意最低级别的瓦片数量很小，例如四个或更少。较大的数字可能会导致渲染问题。
options.maximumLevel `Number`	图像提供者支持的最大细节级别，如果没有限制，则未定义。如果未指定，则没有限制。
options.crs `String`	CRS规范，用于WMS规范>=1.3.0。
options.srs `String`	SRS规范，用于WMS规范1.1.0或1.1.1
options.credit `(Credit \| String)`	数据源的信用，显示在画布上。
options.subdomains `(String \| Array.<String>)` default `'abc'`	用于URL模板中`{s}`占位符的子域。如果此参数是单个字符串，则字符串中的每个字符都是子域。如果是数组，则数组中的每个元素都是子域。
options.clock `Clock`	确定时间维度值时使用的时钟实例。指定options.times时必需。
options.times `TimeIntervalCollection`	TimeIntervalCollection的数据属性为包含时间动态维度及其值的对象。

Example

var provider = new bmgl.WebMapServiceImageryProvider({
    url : 'https://sampleserver1.arcgisonline.com/ArcGIS/services/Specialty/ESRI_StatesCitiesRivers_USA/MapServer/WMSServer',
    layers : '0',
    proxy: new bmgl.DefaultProxy('/proxy/')
});

viewer.imageryLayers.addImageryProvider(provider);

See:

Members

(static, constant) DefaultParameters : Object

要包含在WMS URL中以获取图像的默认参数。值如下：service=wms version=1.1.1 request=getmap styles=format=image/jpeg

(static, constant) GetFeatureInfoDefaultParameters : Object

要包含在WMS URL中以获取功能信息的默认参数。值如下：service=wms version=1.1.1 request=getFeatureInfo

clock : Clock

获取或设置用于获取保持时间动态参数所用时间的时钟。

(readonly) credit : Credit

获取此图像提供程序处于活动状态时要显示的信用。通常情况下，这是用来赞扬图像的来源。在WebMapServiceImageryProvider#ready返回true之前，不应调用此函数。

enablePickFeatures : Boolean

获取或设置一个值，该值指示是否启用功能选取。如果为真，WebMapServiceImageryProvider#pickFeatures将调用WMS服务器上的GetFeatureInfo服务，并尝试解释响应中包含的功能。如果为false，WebMapServiceImageryProvider#pickFeatures将立即返回未定义（表示没有可选择的功能），而不与服务器通信。如果知道数据源不支持选取功能，或者不希望此提供程序的功能可选取，请将此属性设置为false。

Default Value: true

(readonly) errorEvent : Event

获取图像提供程序遇到异步错误时引发的事件。通过订阅事件，您将收到错误通知，并可能从中恢复。向事件侦听器传递TileProviderError的实例。

(readonly) hasAlphaChannel : Boolean

获取一个值，该值指示此图像提供程序提供的图像是否包含alpha通道。如果此属性为假，则忽略alpha通道（如果存在）。如果此属性为真，则任何没有alpha通道的图像都将被视为其alpha在任何地方都是1.0。如果该属性为假，则会减少内存使用和纹理上载时间。

(readonly) layers : String

获取用逗号分隔的WMS层的名称。

(readonly) maximumLevel : Number

获取可以请求的最大详细级别。在WebMapServiceImageryProvider#ready返回true之前，不应调用此函数。

(readonly) minimumLevel : Number

获取可以请求的最低详细级别。在WebMapServiceImageryProvider#ready返回true之前，不应调用此函数。

(readonly) proxy : Proxy

获取此提供程序使用的代理。

(readonly) ready : Boolean

获取一个值，该值指示提供程序是否准备好使用。

(readonly) readyPromise : Promise.<Boolean>

获取当提供程序准备好使用时解析为true的承诺。

(readonly) rectangle : Rectangle

获取此实例提供的图像的矩形（以弧度表示）。在WebMapServiceImageryProvider#ready返回true之前，不应调用此函数。

(readonly) tileDiscardPolicy : TileDiscardPolicy

获取瓦片丢弃策略。如果未定义，则丢弃策略负责通过其shouldDiscardimage函数过滤掉“丢失”的瓦片。如果此函数返回UNdefined，则不会筛选任何瓦片。在WebMapServiceImageryProvider#ready返回true之前，不应调用此函数。

(readonly) tileHeight : Number

获取每个瓦片的高度（像素）。在WebMapServiceImageryProvider#ready返回true之前，不应调用此函数。

(readonly) tileWidth : Number

获取每个瓦片的宽度（像素）。在WebMapServiceImageryProvider#ready返回true之前，不应调用此函数。

(readonly) tilingScheme : TilingScheme

获取此提供程序使用的平铺方案。切片方案。在WebMapServiceImageryProvider#ready返回true之前，不应调用此函数。

times : TimeIntervalCollection

获取或设置用于获取时间动态参数的时间间隔集合。每个时间间隔的数据是一个对象，其中包含瓦片请求期间使用的属性的键和值。

(readonly) url : String

获取WMS服务器的URL。

Methods

getTileCredits(x, y, level) → {Array.<Credit>}

获取显示给定瓦片时要显示的片尾。

Parameters:

x (Number) 瓦片X坐标。

y (Number) 瓦片Y坐标。

level (Number) 瓦片级别；

Throws

DeveloperError : getTileCredits在图像提供者准备就绪之前不得调用。

pickFeatures(x, y, level, longitude, latitude) → {Promise.<Array.<ImageryLayerFeatureInfo>>|undefined}

异步地确定瓦片中给定经度和纬度的哪些特性（如果有的话）。在ImageryProvider#ready返回true之前，不应调用此函数。

Parameters:

x (Number) 瓦片X坐标。

y (Number) 瓦片Y坐标。

level (Number) 瓦片级别。

longitude (Number) 选择特征的经度。

latitude (Number) 选择特征的纬度。

Throws

DeveloperError : pickFeatures在图像提供者准备就绪之前不得调用。

requestImage(x, y, level, request) → {Promise.<(Image|Canvas)>|undefined}

请求给定瓦片的图像。在WebMapServiceImageryProvider#ready返回true之前，不应调用此函数。

Parameters:

x (Number) 瓦片X坐标。

y (Number) 瓦片Y坐标。

level (Number) 瓦片级别。

request (Request) 请求对象。仅供内部使用。

Throws

DeveloperError : requestImage在图像提供者准备就绪之前不得调用。