Class: WMSLayer

layer~WMSLayer(name, url, params, options)

WMS是Web Map Service的缩写，即网络地图服务，其是OGC的网络地图服务标准。WMSLayer即可以加载并显示WMS服务地图的一类图层。
如果缩放过程中出现图片模糊的情况，建议把地图创建时的参数zoomInterval设置为1。

Summary

Methods:

destroy	销毁图层。
getLayerType	获取图层类型
getLayerZIndex	返回图层的zIndex值。
getMap	获取当前图层所在的地图。
getName	获取图层名称。
getOpacity	获取图层透明度。
getTileSize	获取单张瓦片的尺寸。
getTileUrl	获取瓦片url
getVisibility	获取图层的可见性。
offMap	解除图层与地图的关联，即从图层去掉与地图对象有关的信息，同时在地图对象去掉与该图层有关的信息。关联解除后，图层依然存在，但与地图不再有关系。如果图层本身并未加载到地图上，那么该方法没有任何效果。
redraw	重新绘制图层
setLayerZIndex	设置图层在图层容器中的顺序。
setName	设置图层名称。
setOpacity	设置图层透明度。0表示完全透明，1表示完全不透明。
setVisibility	设置图层的可见性。仅设置该图层是否可见，而图层本身依然存在。

Constructor

new WMSLayer(name, url, params, options)

Parameters:

Name Type Description

name

String

图层名称

url

String

图层的服务地址比如：http://ip:port/arcgis/services/Zhe_96/MapServer/WMSServer?

params

Object

键值对对象，获取地图时必须的字符串参数和对应的参数值。params中的key不区分大小写。

Name	Type	Description
`layers`	String	地图图层列表，必设参数，图层之间以半角英文逗号隔开。最左边的图层在最下面，其后的图层依次在其上面。图层名称必须是GetCapabilities操作返回的文档中声明的Name元素的值。
`format`	String	(可选) 地图的输出格式。格式类型可以是PNG、GIF、JPEG等。如：”image/png“。
`version`	String	(可选) 请求版本号。现支持"1.1.1"和"1.3.0"。
`transparent`	Boolean	(可选) 图层是否透明，默认为true，即透明。

options

Object

在该类及其父类中开放的属性。

Name	Type	Description
`gridSize`	module:basetype~Size	瓦片大小

Example

const wmsUrl = "http://ip:port/arcgis/services/Zhe_96/MapServer/WMSServer?";//如有跨域问题，需设置为代理前的地址
const wmsParams ={
  CRS:"EPSG:4326",//坐标系，当WMS版本小于1.3时，key为SRS。
  VERSION:"1.3.0",//WMS的版本
  LAYERS:"1,2,3,4,5",//图层的id或名称，可以是多个，中间用逗号（,）分割。
  STYLES:"default,default,default,default,default",//样式和LAYERS中的layer一一对应
  FORMAT:"image/png",//图片格式为png
 TRANSPARENT:false,//图层是不透明的
};
 let wmsLayer = new hmap.layer.WMS("WMS图层",wmsUrl,wmsParams);
 map.addLayer(wmsLayer);

Methods

destroy()

销毁图层。

getLayerType() → {String}

获取图层类型

Returns:

String -

图层类型

getLayerZIndex() → {Number}

返回图层的zIndex值。

Returns:

Number -

图层的zIndex

getMap() → {module:Map}

获取当前图层所在的地图。

Returns:

module:Map -

图层所属的地图对象

getName() → {String}

获取图层名称。

Returns:

String -

图层名称

getOpacity() → {Number}

获取图层透明度。

Returns:

Number -

透明度

getTileSize() → {module:basetype~Size}

获取单张瓦片的尺寸。

Returns:

module:basetype~Size -

单张瓦片的尺寸

getTileUrl() → {String}

获取瓦片url

Returns:

String -

瓦片url

getVisibility() → {Boolean}

获取图层的可见性。

Returns:

Boolean -

true表示可见，false表示不可见。

offMap()

解除图层与地图的关联，即从图层去掉与地图对象有关的信息，同时在地图对象去掉与该图层有关的信息。关联解除后，图层依然存在，但与地图不再有关系。
如果图层本身并未加载到地图上，那么该方法没有任何效果。

redraw(type)

重新绘制图层

Parameters:

Name	Type	Default	Description
`type`	Number	1	取值为0或1，0表示map调用redraw，1表示layer调用redraw，默认为1。

setLayerZIndex(zIndex)

设置图层在图层容器中的顺序。

Parameters:

Name	Type	Description
`zIndex`	Number	图层的zIndex,值越大，图层越靠近上方。但是该值改变不了图层容器的上下顺序。

setName(name)

设置图层名称。

Parameters:

Name	Type	Description
`name`	String	图层名称

Throws:

Error -

当name不是String类型时抛出异常。

setOpacity(opacity)

设置图层透明度。0表示完全透明，1表示完全不透明。

Parameters:

Name	Type	Default	Description
`opacity`	Number	1	图层透明度，介于0-1之间。

Throws:

TypeError -

当图层的透明度值不是一个0-1之间的数字时，抛出异常。

setVisibility(visible)

设置图层的可见性。仅设置该图层是否可见，而图层本身依然存在。

Parameters:

Name	Type	Default	Description
`visible`	Boolean	true	是否可见，默认为true，可见。

Throws:

TypeError -

当参数不是布尔类型时，抛出异常。