WMTSLayer

WMTS图层,用于加载WMTS标准瓦片服务。 内部自动拼接WMTS标准请求参数(Service、Request、Version、Format、TileMatrixSet等), 用户只需提供服务地址和图层参数即可快速加载WMTS瓦片。

构造函数

  • 创建WMTS图层实例

    参数类型说明
    optionsWMTSLayerOptionsWMTS图层配置选项
    属性类型说明
    boundarystring[]设置图层掩膜。可通过BMapGL.Boundary()获取行政区域的坐标数据
    cacheSizenumber瓦片缓存数量
    dataTypestring数据类型
    extentnumber[]设置图层加载数据的四至范围,输入的范围数值为EPSG:3857坐标[minX,minY,maxX,maxY]
    extentCRSIsWGS84boolean标记参数extent数组数据是否为EPSG:4326坐标。如果设置为true,参数extent数值需要是EPSG:4326坐标
    heightnumber瓦片高度
    maxZoomnumber设置图层显示的最大缩放等级
    minZoomnumber设置图层显示的最小缩放等级
    opacitynumber图层透明度,取值范围0 - 1
    paramsRecord<string, string>WMTS请求参数,如Layer、Style、TileMatrixSet等。 默认包含:Service=WMTS, Request=GetTile, Version=1.0.0, Format=image/png, TileMatrixSet=GoogleMapsCompatible。 用户参数优先级高于默认值。 瓦片坐标参数TileMatrix/TileCol/TileRow可通过此参数自定义格式(如 'EPSG:3857:[z]'),默认使用 [z]/[x]/[y] 占位符。
    png8boolean是否使用PNG8格式
    reprojectboolean是否进行坐标重投影
    reprojectSourceCRSstring重投影源坐标系
    retryboolean瓦片加载失败时是否重试
    retryTimenumber重试次数
    spanLevelnumber跨层缩略瓦片的跨度等级
    thumbChildDepthnumber向下查找缩略瓦片的层数
    thumbParentDepthnumber向上查找缩略瓦片的层数
    tileLoadFunctionFunction自定义瓦片加载函数
    transform{ source?: string; target?: string }坐标系转换配置,source 为瓦片源坐标系,target 为目标坐标系
    urlstringWMTS服务地址
    useThumbDataboolean缩放图层时,是否使用跨图层的瓦片进行平滑切换
    xTemplateFunction通过输入的网格x、y、z参数计算[x]具体返回值
    yTemplateFunction通过输入的网格x、y、z参数计算[y]具体返回值
    zIndexnumber图层层叠顺序
    zTemplateFunction通过输入的网格x、y、z参数计算[z]具体返回值

    返回值 WMTSLayer

    示例代码1:加载天地图影像WMTS服务

    const wmtsLayer = new BMap.WMTSLayer({
    url: 'https://t0.tianditu.gov.cn/img_w/wmts',
    params: {
    Layer: 'img',
    Style: 'default',
    TileMatrixSet: 'w',
    Format: 'tiles',
    tk: '你的天地图key'
    },
    minZoom: 1,
    maxZoom: 18
    });
    map.addLayer(wmtsLayer);

    示例代码2:加载GeoServer WMTS服务

    const wmtsLayer = new BMap.WMTSLayer({
    url: 'https://yourhost/geoserver/gwc/service/wmts',
    params: {
    Layer: 'workspace:layername',
    Style: '',
    TileMatrixSet: 'EPSG:3857',
    Format: 'image/png'
    }
    });
    map.addLayer(wmtsLayer);

方法

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

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

    返回值 void

  • 清空图层掩膜

    返回值 void

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

    返回值 void

  • 设置图层的叠加顺序

    参数类型说明
    zIndexnumber层级值

    返回值 void