数据可视化数据分析GIS【免费下载链接】foliumPython Data. Leaflet.js Maps.项目地址https://gitcode.com/gh_mirrors/fo/folium点击查看免费下载导读WMSWeb Map ServiceWeb 地图服务是地理信息系统领域广泛采用的 OGC 标准接口通过 HTTP 请求动态返回地图图像。本文将围绕 folium 的WmsTileLayer类讲解如何把 WMS 服务无缝叠加到 Leaflet 地图上包括类的完整参数体系、真实的气象雷达 WMS 接入示例、透明叠加与图层控制器的配合方式以及从源码层面剖析其底层实现机制URL 拼接、参数驼峰化、cql_filter特例处理等。读完本文你将能在 folium 中熟练接入任意符合 WMS 规范的服务器并完成多图层叠加与交互控制。什么是 WmsTileLayerfolium.WmsTileLayer是 folium 栅格图层家族folium/raster_layers.py中的一员与TileLayer普通瓦片层、ImageOverlay图片叠加层、VideoOverlay视频叠加层并列。它的定位是Creates a Web Map Service (WMS) layer.WMS 服务与普通的 XYZ 瓦片服务不同瓦片服务按固定的{z}/{x}/{y}网格提供静态切片而 WMS 服务则由客户端发送GetMap请求携带图层名、样式、坐标范围、输出格式等参数服务端实时渲染并返回地图图像。folium 通过WmsTileLayer把这类服务包装为 Leaflet 的L.tileLayer.wms图层可以直接叠加在任意地图之上。快速上手接入气象雷达 WMS 数据docs/user_guide/raster_layers/wms_tile_layer.md中给出了一个可直接运行的完整示例接入美国爱荷华州立大学IEM提供的 Nexrad 气象雷达 WMS 服务并叠加到 CartoDB Positron 底图上import folium m folium.Map(location[41, -70], zoom_start5, tilescartodb positron) folium.WmsTileLayer( urlhttps://mesonet.agron.iastate.edu/cgi-bin/wms/nexrad/n0r.cgi, nametest, fmtimage/png, layersnexrad-n0r-900913, attruWeather data © 2012 IEM Nexrad, transparentTrue, overlayTrue, controlTrue, ).add_to(m) folium.LayerControl().add_to(m) m这段代码做了四件事代表了 WMS 接入的核心套路创建底图folium.Map(location[41, -70], zoom_start5, tilescartodb positron)指定了初始中心美国东海岸附近与缩放级别底图使用 CartoDB Positron 浅色瓦片便于凸显半透明的雷达图层。配置 WMS 图层WmsTileLayer指向 IEM 的 Nexrad 雷达服务输出image/png格式并开启透明通道图层名为nexrad-n0r-900913。注册到地图.add_to(m)将图层挂载到地图对象上。添加图层控制器folium.LayerControl().add_to(m)让用户在网页上自由开关该 WMS 图层。在 Notebook 环境中最后一行m会直接渲染出交互式地图。该示例同样可以在 examples/WMS_and_WMTS.ipynb 中找到对应版本。WmsTileLayer 参数体系详解WmsTileLayer的完整签名定义在 folium/raster_layers.py 中与docs/user_guide/raster_layers/wms_tile_layer.md示例中出现的参数一一对应。下面逐个说明其含义、默认值与典型用法参数类型默认值说明urlstr必填WMS 服务器的GetMap服务端点地址。layersstr必填要显示的 WMS 图层名多个图层用逗号分隔Comma-separated list of WMS layers to show。stylesstr逗号分隔的 WMS 样式列表留空则使用服务端默认样式。fmtstrimage/jpeg服务输出图片格式例如image/png。该参数会被映射为 WMS 请求中的format参数。transparentboolFalse图层是否允许透明。叠加在底图上显示时通常设为True。versionstr1.1.1使用的 WMS 服务版本号。attrstr图层归属说明attribution显示在地图右下角。namestrNone图层名称显示在LayerControl中。overlayboolTrueTrue表示作为覆盖层overlay叠加在底图之上False则作为底图base layer。controlboolTrue是否把该图层纳入LayerControl便于用户勾选开关。showboolTrue地图打开时该图层是否默认显示。**kwargs——额外关键字参数会透传给 Leaflet 的tileLayer.wms对象既可作为瓦片层选项也可作为 WMS 请求中的附加参数例如时间维度参数。关于attr参数的一个实现细节与TileLayer不同自定义瓦片 URL 强制要求attr否则抛出ValueError见 folium/raster_layers.pyWmsTileLayer的attr默认值为空字符串即 WMS 图层不强制要求归属说明。不过从规范性与版权角度建议仍传入明确的归属信息。源码级原理WmsTileLayer 是如何工作的继承与图层语义WmsTileLayer直接继承自folium.map.Layerfolium/map.pyLayer是 folium 中一切可被LayerControl管理的图层的抽象基类其构造函数接收并存储四个核心字段name图层在控件中显示的名称overlay是否为覆盖层默认False但WmsTileLayer显式改为Truecontrol是否纳入图层控件show是否默认显示。此外Layer.render()会依据show的值决定是否生成addTo调用从而实现默认显示/默认隐藏的语义folium/map.py。模板与 JS 渲染WmsTileLayer定义了一个 Jinja 模板作为其渲染蓝图folium/raster_layers.py{% macro script(this, kwargs) %} var {{ this.get_name() }} L.tileLayer.wms( {{ this.url|tojson }}, {{ this.options|tojson }} ); {% endmacro %}当图层被添加到地图并渲染时folium 会把url与序列化后的options字典填入模板生成 Leaflet 的L.tileLayer.wms(url, options)调用。也就是说folium 的WmsTileLayer本质上是 Python 侧的声明式封装真正的渲染与请求逻辑由 Leaflet 的tileLayer.wms完成。参数处理流程构造函数中的核心逻辑folium/raster_layers.py如下super().__init__(namename, overlayoverlay, controlcontrol, showshow) self.url url kwargs[format] fmt cql_filter kwargs.pop(cql_filter, None) self.options parse_options( layerslayers, stylesstyles, transparenttransparent, versionversion, attributionattr, **kwargs, ) # special parameter that shouldnt be camelized if cql_filter: self.options[cql_filter] cql_filter其中有两个值得注意的机制fmt映射为formatfmt参数在进入 options 之前被改写为kwargs[format]因此最终传给 Leaflet 的是标准的format键WMSGetMap请求参数。parse_options的驼峰化parse_options定义于 folium/utilities.py会把 Python 风格的下划线键名转为 lowerCamelCase其实现为def parse_options(**kwargs): return {camelize(key): value for key, value in kwargs.items() if value is not None}其中camelizefolium/utilities.py将variable_name转换为variableName同时会过滤掉值为None的键保证传给 Leaflet 的 options 干净紧凑。cql_filter特例如果用户传入cql_filterECQL 过滤表达式常见于 GeoServer 等 WMS 服务用于做要素级过滤它会先被从 kwargs 中弹出再原样放回 options——故意不做驼峰化。因为cqlFilter驼峰化后的形式不是 WMS 标准参数Leaflet/GeoServer 需要的是保留下划线形式的cql_filter。测试用例的印证test_raster_layers.py 中的test_wms用例完整复现了上述流程并专门验证了cql_filter特例def test_wms(): m folium.Map([40, -100], zoom_start4) url http://mesonet.agron.iastate.edu/cgi-bin/wms/nexrad/n0r.cgi w folium.raster_layers.WmsTileLayer( urlurl, nametest, fmtimage/png, layersnexrad-n0r-900913, attrWeather data © 2012 IEM Nexrad, transparentTrue, cql_filtersomething, ) w.add_to(m) html m.get_root().render() # verify this special case wasnt converted to lowerCamelCase assert cql_filter: something, in html assert cqlFilter not in html该测试断言渲染后的 HTML 中必须包含cql_filter: something且不能出现cqlFilter从测试层面锁定了这一特例行为避免后续重构误伤。进阶用法透明叠加与图层控制回到示例本身几个参数组合值得单独拆解transparentTrue雷达图像通常是有颜色数据、无数据区域透明的 PNG开启透明后雷达回波才能叠加在地图上显示而非以不透明矩形遮挡底图。overlayTrue声明该图层是覆盖层。folium 的Layer基类会据此把图层归入 LayerControl 的Overlays分组folium/map.py中LayerControl类folium/map.py用户可以在Overlays分组中独立开关它而底图分组Base Layers不受影响。controlTrue确保该图层出现在 LayerControl 中。如果设为False图层仍会渲染但用户无法在界面上控制其显隐。nametest该名称会显示在图层控件的 Overlays 列表中实际使用时应改为可读性更强的名称例如NEXRAD Radar。这种底图 多个透明 WMS 覆盖层 LayerControl的组合是气象、海洋、国土等行业最常见的叠加分析范式底图负责地理上下文WMS 图层负责动态专题数据用户按需开关。与其他栅格图层的协同WmsTileLayer与同类栅格图层共享Layer基类语义overlay/control/show/name四个行为参数完全一致因此可以和其他图层自由叠加TileLayer普通 XYZ 瓦片底图对应 folium/raster_layers.pyImageOverlay将单张图片按指定地理范围贴图folium/raster_layers.pyVideoOverlay在地图上播放视频folium/raster_layers.py。例如可以在一张底图上同时叠加一个 WMS 遥感影像图层与一个ImageOverlay标注图层再由LayerControl统一管理显隐——这正体现了 folium 栅格图层体系的组合能力。它们共同的**kwargs透传机制意味着你始终可以按 LeaflettileLayer.wms的文档https://leafletjs.com/reference.html#tilelayer-wms补充额外选项。小结与使用建议最小可用配置url与layers为必填其余参数均有合理默认值示例中额外设置的fmt、transparent、overlay、control、attr属于接入外部 WMS 时的推荐标配。叠加显示三件套叠加到已有底图上时建议transparentTrue、overlayTrue、controlTrue配合LayerControl使用。格式选择需要透明叠加时优先fmtimage/png对 JPEG 可接受的场景可使用默认的image/jpeg以减小流量。cql_filter传参需要 ECQL 空间/属性过滤时直接传cql_filter...folium 会原样透传不会被改写成cqlFilter。归属说明虽然 WMS 图层不强制attr但为合规与可追溯建议填写数据来源说明。接入 WMS 是 folium 做专业地理数据可视化的重要一环服务端负责按需渲染folium 负责声明式配置与 Leaflet 桥接二者结合即可在几行代码内完成复杂专题图层的上线。赞分享数据可视化数据分析GIS【免费下载链接】foliumPython Data. Leaflet.js Maps.项目地址https://gitcode.com/gh_mirrors/fo/folium点击查看免费下载相关推荐Leaflet 中的 WMS 图层组合实战用 WMSTileLayer 叠加多图层并理解服务端合成Leaflet 中的 WMS 图层组合实战用 WMSTileLayer 叠加多图层并理解服务端合成 导读 本文基于 Leaflet 官方示例 docs/exa前端数据可视化GISLeaflet WMS 图层接入与识别实战从 WMSTileLayer 到增强插件 leaflet.wmsLeaflet WMS 图层接入与识别实战从 WMSTileLayer 到增强插件 leaflet.wms Web Map ServiceWMS是 GIS前端数据可视化GISLeaflet WMS 实战指南使用 WMSTileLayer 加载 SRTM30-Colored-Hillshade 高程晕渲图层Leaflet WMS 实战指南使用 WMSTileLayer 加载 SRTM30 Colored Hillshade 高程晕渲图层 导读 本文以仓库中 w前端数据可视化GIS上一篇Google Mobile Ads SDK社区支持与资源如何快速获取官方帮助指南下一篇rdev开发者指南Linux/Wayland/X11平台事件处理的底层实现原理创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考