WMTS map-wmts

WMTS 服务图层：OGC 标准 WMTS 或 vjmap CAD 多图叠加。

放在 map-2d 的 pieces 里；enabled 写在节点顶层。数据来源 data-input：bind-fields（绑工程连接）或 source（引用数据源）。

在线演示

无稳定公共演示源，本页不内嵌在线预览

WMTS 图层需要一个可访问的 WMTS 服务（KVP 端点）或 vjmap 服务图。公共 OGC WMTS 演示端点普遍不稳定 / 需要密钥，故本页不放在线预览；把下方配置里的 wmts-url / wmts-layer / wmts-matrix-set 换成你的服务即可在编辑器中出图。wmts-source-kind: "vjmap"（CAD 多图叠加）走「选择叠加图」对话框配置，见 2D 地图 · 服务图层与叠加。手写工程 JSON 时 wmts-maps 可写编辑器数组簇，也可写 [{ "mapid": "sys_hello", "version": "", "layernames": "" }] 数组，运行时两种都认。

完整字段级配置（OGC WMTS，键名与属性面板一致）：

{
  "type": "map-wmts",
  "uid": "ly_wmts",
  "enabled": true,
  "options": {
    "wmts-source-kind": "ogc",
    "wmts-url": "https://your-server/wmts",
    "wmts-layer": "layer0",
    "wmts-matrix-set": "EPSG:3857",
    "wmts-style": "default",
    "wmts-format": "image/png",
    "wmts-version": "1.0.0",
    "wmts-tile-size": 256,
    "wmts-opacity": 100
  }
}

属性

属性	名称	类型	默认	说明
wmts-source-kind	数据源类型	select(radioGroup)	vjmap	可选：vjmap / ogc
wmts-url	服务地址	string	—
wmts-layer	图层名	string	—
wmts-matrix-set	矩阵集	string	—
wmts-style	样式	string	default
wmts-format	图片格式	string	image/png
wmts-version	版本	string	1.0.0
wmts-pick	选择叠加图	cad-map-picker	—
wmts-maps		``	—
wmts-clip-mode	坐标裁剪范围	select	base	可选：base / union / custom
wmts-clip-bounds	自定义范围	string	—
wmts-vj-dark	深色背景	boolean	true
wmts-tile-size	瓦片尺寸	number(unit=px,min=128)	256
wmts-opacity	不透明度	slider(min=0,max=100,step=1,unit=%)	100
wmts-saturation	饱和度	slider(min=-100,max=100,step=1,unit=%)	0
wmts-hue	色相旋转	slider(min=0,max=360,step=1,unit=°)	0
wmts-brightness	亮度	slider(min=-100,max=100,step=1,unit=%)	0
wmts-contrast	对比度	slider(min=-100,max=100,step=1,unit=%)	0
wmts-resampling	采样方式	select	linear	可选：linear / nearest
wmts-fade-duration	渐隐时间	number(unit=ms,min=0,step=50)	300
row-row-filter-mode-id	选择数据规则	select(condition)	—

事件

触发器	名称	配在哪	payload
marker-click	点击点要素	map-2d 组件的 options.interactions（运行态按命中图层分流）	命中要素属性行，公式 {:name} / {:value} 取值
region-click	点击面要素	同上	同上
map-select / map-unselect	选中 / 取消	同上	选中项数据

事件写在地图组件上而非图层上。图层还支持 feature-panel-uid（点击要素弹锚定窗口）与 tooltip-enable（悬停浮层），见属性表。动作端可用 mapLayerVisible / mapSetLayerStyle / mapRefreshData 等 17 个地图动作，见 2D 地图 · 事件。

示例

{
  "type": "map-wmts",
  "uid": "ly_x",
  "enabled": true,
  "options": {
    "wmts-url": "https://your-server/wmts",
    "wmts-layer": "layer",
    "wmts-matrix-set": "EPSG:3857"
  }
}

CAD 多图叠加（空白 CAD + union，与 playground 65-overlay-wmts-union-no-base 同结构）：

{
  "type": "map-wmts",
  "uid": "layer-wmts",
  "enabled": true,
  "options": {
    "wmts-source-kind": "vjmap",
    "wmts-clip-mode": "union",
    "wmts-vj-dark": true,
    "wmts-maps": [
      { "mapid": "sys_hello", "version": "", "layernames": "" },
      { "mapid": "sys_world", "version": "", "layernames": "COUNTRY,经纬度标注" }
    ]
  }
}

先有底图且 wmts-clip-mode: "base"（坐标系不变）时，地图本体还要设 cad-clip-zoom: 3（openMap 的 clipbounds = 8），给叠加图预留范围，否则 hello/topo 会被裁在世界图外。

延伸阅读：2D 地图子系统 · 地图数据源 · 地图图层总览。