VWmsSource

VWmsSource：Web Map Service (WMS) 数据源，用于请求和获取地图图像。WMS 提供了基于 HTTP 的标准地图服务接口，支持动态生成和显示地图图像。

• Web地图服务（WMS）
• GeoServer WMS
• OGC WMS

基础用法

使用 WMS 源加载栅格图层：

wms-source.vue

<script lang="ts" setup>
import { VMapbox, VRasterLayer, VUIControl, VWmsSource } from '@movk-repo/mapbox'

const accessToken = import.meta.env.VITE_MAPBOX_ACCESS_TOKEN

const url = 'https://ows.terrestris.de/osm/service'
const layers = 'OSM-WMS'

const visible = ref(true)
</script>

<template>
  <VMapbox :access-token="accessToken" :zoom="1" projection="mercator">
    <VWmsSource :url="url" :layers="layers">
      <VRasterLayer :visible="visible" />
    </VWmsSource>
    <VUIControl>
      <ElSwitch v-model="visible" size="small" active-text="显示" inactive-text="隐藏" />
    </VUIControl>
  </VMapbox>
</template>

隐藏源代码

Api

wmsSourceProps

属性名	说明	类型	默认值
继承属性	rasterSourceProps	-	-
url	服务地址	string	必填
layers	图层名称(逗号分隔)	string	必填
version	服务版本	string	1.3.0
styles	图层样式列表（逗号分隔）	string	default
crs	空间参考系统（WMS 1.3.0）	string	EPSG:3857
bbox	地图范围边界框（minx,miny,maxx,maxy）	string	{bbox-epsg-3857}
width	地图输出宽度（像素）	number	256
height	地图输出高度（像素）	number	256
format	地图输出格式	string	image/png
transparent	地图背景是否透明	boolean	true
bgcolor	地图背景色（RRGGBB）	string	-
exceptions	异常报告格式	string	application/vnd.ogc.se_xml
time	地图数据的时间值或范围	string	-
sld	StyledLayerDescriptor XML文件URL	string	-
sld_body	URL编码的SLD XML文档	string	-
customParams	自定义参数	object	-
defaultOptions	配置选项（覆盖同名属性）	object	-

wmsSourceEmits

事件名	说明	回调参数
继承事件	rasterSourceEmits	-

类型定义

WmsSourceSpecification

interface WmsSourceSpecification {
  service?: 'WMS'
  request?: 'GetCapabilities' | 'GetMap' | 'GetFeatureInfo'
  version?: string
  url?: string
  layers?: string
  styles?: string
  crs?: string
  srs?: string
  bbox?: string
  width?: number
  height?: number
  format?: string
  transparent?: string | boolean
  bgcolor?: string
  exceptions?: string
  time?: string
  sld?: string
  sld_body?: string
  customParams?: Record<string, any>
}