WMTSLayer
构造函数
创建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);
WMTS图层,用于加载WMTS标准瓦片服务。 内部自动拼接WMTS标准请求参数(Service、Request、Version、Format、TileMatrixSet等), 用户只需提供服务地址和图层参数即可快速加载WMTS瓦片。