WMSLayer

WMS图层,用于加载瓦片式WMS地图服务。 内部自动拼接WMS标准请求参数(SERVICE、REQUEST、VERSION、FORMAT、CRS/SRS等), 并通过BBOX、WIDTH、HEIGHT驱动瓦片请求。 用户只需提供服务地址和图层参数(LAYERS)即可快速接入WMS服务。

构造函数

  • 创建WMS图层实例

    参数类型说明
    optionsWMSLayerOptionsWMS图层配置选项
    属性类型说明
    boundarystring[]设置图层掩膜。可通过BMapGL.Boundary()获取行政区域的坐标数据
    cacheSizenumber瓦片缓存数量
    dataTypestring数据类型
    extentnumber[]设置图层加载数据的四至范围,输入的范围数值为EPSG:3857坐标[minX,minY,maxX,maxY]
    extentCRSIsWGS84boolean标记参数extent数组数据是否为EPSG:4326坐标
    heightnumber瓦片高度
    maxZoomnumber设置图层显示的最大缩放等级
    minZoomnumber设置图层显示的最小缩放等级
    opacitynumber图层透明度,取值范围0 - 1
    paramsRecord<string, string>WMS请求参数。 LAYERS 为必填项,指定要请求的图层名(多图层用逗号分隔)。 可选参数如 VERSION(默认'1.3.0')、FORMAT(默认'image/png')、STYLES、TRANSPARENT 等。 内部会自动补充 SERVICE=WMS、REQUEST=GetMap 等标准参数,用户参数优先级更高。 BBOX/WIDTH/HEIGHT 由内部驱动,无需手动设置。
    png8boolean是否使用PNG8格式
    projectionstring投影坐标系,目前仅支持 'EPSG:3857'
    reprojectboolean是否进行坐标重投影
    reprojectSourceCRSstring重投影源坐标系
    retryboolean瓦片加载失败时是否重试
    retryTimenumber重试次数
    spanLevelnumber跨层缩略瓦片的跨度等级
    thumbChildDepthnumber向下查找缩略瓦片的层数
    thumbParentDepthnumber向上查找缩略瓦片的层数
    tileLoadFunctionFunction自定义瓦片加载函数
    tileSizenumber瓦片像素尺寸,对应 WMS 请求中的 WIDTH/HEIGHT
    urlstringWMS服务地址
    useThumbDataboolean缩放图层时,是否使用跨图层的瓦片进行平滑切换
    zIndexnumber图层层叠顺序

    返回值 WMSLayer

    示例代码1:加载GeoServer WMS服务

    const wmsLayer = new BMap.WMSLayer({
    url: 'https://yourhost/geoserver/wms',
    params: {
    LAYERS: 'workspace:layername',
    VERSION: '1.1.1',
    FORMAT: 'image/png',
    TRANSPARENT: 'true'
    },
    minZoom: 3,
    maxZoom: 18
    });
    map.addLayer(wmsLayer);

    示例代码2:加载多图层WMS服务

    const wmsLayer = new BMap.WMSLayer({
    url: 'https://yourhost/geoserver/wms',
    params: {
    LAYERS: 'layer1,layer2,layer3',
    STYLES: 'style1,style2,style3'
    },
    tileSize: 512,
    opacity: 0.8
    });
    map.addLayer(wmsLayer);

方法

  • 设置图层掩膜,在掩膜区域内显示瓦片

    参数类型说明
    boundarystring | string[]掩膜边界坐标字符串或字符串数组

    返回值 void

  • 清空图层掩膜

    返回值 void

  • 清除瓦片缓存并强制重新加载

    返回值 void

  • 设置图层的叠加顺序

    参数类型说明
    zIndexnumber层级值

    返回值 void