Leafmap中Streamlit集成时多边形样式问题的解决方案

问题背景

在使用Leafmap与Streamlit集成时，开发者遇到了多边形样式无法正常显示的问题。具体表现为通过两种方式设置的多边形样式在Streamlit界面中均未生效：

1. 使用add_gdf方法的style_callback参数
2. 在GeoJSON中直接为每个要素设置颜色属性

技术分析

经过项目维护者的验证，发现问题的关键在于参数名称的使用不当。开发者尝试使用的style_callback参数实际上应为style_function。这是一个常见的API使用误区，特别是在Leafmap这类封装了多种底层库(如Folium)的工具中。

正确使用方法

以下是经过验证可正常工作的代码示例，展示了如何在Leafmap与Streamlit集成时正确设置多边形样式：

import streamlit as st
import geopandas as gpd
import leafmap.foliumap as leafmap

# 创建基础地图
m = leafmap.Map(location=[45.5236, -122.6750], zoom_start=13)

# 加载示例地理数据
gdf = gpd.read_file(gpd.datasets.get_path('naturalearth_lowres'))

# 定义样式函数
def style_function(feature):
    return {
        'fillColor': '#228B22' if feature['properties']['pop_est'] < 10000000 else '#FF0000',
        'color': 'black',
        'weight': 2,
        'dashArray': '5, 5',
        'fillOpacity': 0.7,
    }

# 添加地理数据并应用样式
m.add_gdf(gdf, style_function=style_function)

# 渲染到Streamlit
m.to_streamlit()

关键点说明

1. 样式函数定义：样式函数应返回一个包含各种样式属性的字典，如填充颜色(fillColor)、边框颜色(color)、线宽(weight)等。

2. 条件样式：示例中根据人口数量(pop_est)动态设置不同填充颜色，展示了条件样式的实现方式。

3. 参数名称：必须使用style_function而非style_callback，这是与底层Folium库保持一致的API设计。

最佳实践建议

1. 对于复杂样式需求，建议将样式函数单独定义并测试，确保其返回正确的样式字典。

2. 在Streamlit环境中调试地图样式时，可以先在Jupyter Notebook中验证样式效果，再迁移到Streamlit应用。

3. 考虑使用颜色映射库(如matplotlib.cm)为连续值属性生成平滑的颜色渐变，提升可视化效果。

通过正确使用style_function参数，开发者可以充分利用Leafmap在Streamlit中的地理数据可视化能力，创建富有表现力的交互式地图应用。