WMS map-wms

2026年7月20日大约 3 分钟

WMS `map-wms`

WMS 服务图层：OGC 标准 WMS 或 vjmap 图叠加（含 CAD↔互联网互叠）。

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

在线演示

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

WMS 图层需要一个可访问的 WMS 服务地址（自建 GeoServer / MapServer，或 vjmap 服务图）。公共 OGC WMS 演示端点普遍不稳定，故本页不放在线预览；把下方配置里的 wms-url / wms-layers 换成你的服务即可在编辑器中出图。wms-source-kind: "vjmap"（vjmap 服务图叠加）走「选择叠加图」对话框配置，见 2D 地图 · 服务图层与叠加。

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

{
  "type": "map-wms",
  "uid": "ly_wms",
  "enabled": true,
  "options": {
    "wms-source-kind": "ogc",
    "wms-url": "https://your-geoserver/geoserver/wms",
    "wms-layers": "workspace:layer0,workspace:layer1",
    "wms-version": "1.3.0",
    "wms-format": "image/png",
    "wms-transparent": true,
    "wms-tile-size": 256,
    "wms-opacity": 100,
    "wms-resampling": "linear",
    "wms-fade-duration": 300
  }
}

属性

属性	名称	类型	默认	说明
`wms-source-kind`	数据源类型	`select(radioGroup)`	`vjmap`	可选：`vjmap` / `ogc`
`wms-url`	服务地址	`string`	—
`wms-layers`	图层名	`string`	—
`wms-version`	版本	`select`	`1.3.0`	可选：`1.3.0` / `1.1.1`
`wms-format`	图片格式	`string`	`image/png`
`wms-transparent`	透明背景	`boolean`	`true`
`ov-pick`	选择叠加图	`cad-map-picker`	—
`ov-as-base`	作为底图(置于最底)	`boolean`	`false`
`ov-click-pick`	点击选择 CAD 实体	`boolean`	`false`	播放态点击叠加 CAD 栅格：四参数反算后查询并高亮实体，触发地图 `map-select`
`ov-maps`		``	—
`ov-mode`	叠加方式	`select`	`direct`	可选：`none` / `direct` / `auto` / `param` / `arrange`
`ov-arrange-cols`	排列列数	`number(min=1,step=1)`	`2`
`ov-crs`	坐标系(EPSG)	`string`	—
`ov-offset-x`	X 偏移	`number`	`0`
`ov-offset-y`	Y 偏移	`number`	`0`
`ov-scale`	缩放	`number(step=0.0001)`	`1`
`ov-rotate`	旋转(弧度)	`number(step=0.0001)`	`0`
`ov-rotate-zero`	禁止旋转	`boolean`	`false`
`ov-points`		``	—
`ov-transparent`	透明背景	`boolean`	`true`
`ov-bg-color`	背景色	`color`	—
`ov-mapid`	图 ID(旧)	`string`	—
`ov-version`	版本(旧)	`string`	—
`wms-tile-size`	瓦片尺寸	`number(unit=px,min=128)`	`256`
`wms-opacity`	不透明度	`slider(min=0,max=100,step=1,unit=%)`	`100`
`wms-saturation`	饱和度	`slider(min=-100,max=100,step=1,unit=%)`	`0`
`wms-hue`	色相旋转	`slider(min=0,max=360,step=1,unit=°)`	`0`
`wms-brightness`	亮度	`slider(min=-100,max=100,step=1,unit=%)`	`0`
`wms-contrast`	对比度	`slider(min=-100,max=100,step=1,unit=%)`	`0`
`wms-resampling`	采样方式	`select`	`linear`	可选：`linear` / `nearest`
`wms-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-wms",
  "uid": "ly_x",
  "enabled": true,
  "options": {
    "wms-url": "https://your-geoserver/wms",
    "wms-layers": "workspace:layer"
  }
}

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