如何在Folium地图中实现单选按钮式图层组且保留底图？

这个问题我之前也碰到过！你遇到的底图消失问题，根源是把overlay=False用在了主FeatureGroup上——这会把它们变成底图层（base layer），而Leaflet里同一时间只能显示一个底图层，所以选了你的自定义组就把默认底图挤掉了。

要实现techno和qualification两个主组单选，同时保留底图，正确的思路是：

• 保持主FeatureGroup的overlay为默认值True（叠加层）
• 通过LayerControl的配置选项，把这两个组标记为互斥组，让Leaflet自动把它们渲染成单选按钮

修改后的完整代码 #

import folium
from folium import plugins

# 初始化地图，底图默认保留
m = folium.Map(location=[0, 0], zoom_start=6)

# 主组保持默认overlay=True（无需手动设置）
techno = folium.FeatureGroup(name="Techno")
m.add_child(techno)
group2G = plugins.FeatureGroupSubGroup(techno, name="2G")
m.add_child(group2G)
group3G = plugins.FeatureGroupSubGroup(techno, name="3G")
m.add_child(group3G)

# qualification组保持show=False的初始状态，overlay默认True
qualification = folium.FeatureGroup(name="Qualification", show=False)
m.add_child(qualification)
group_home = plugins.FeatureGroupSubGroup(qualification, name="Home")
m.add_child(group_home)
group_work = plugins.FeatureGroupSubGroup(qualification, name="Work")
m.add_child(group_work)

# 关键：配置LayerControl的互斥组选项
folium.LayerControl(
    collapsed=False,
    options={
        # 指定要互斥的组名称，对应FeatureGroup的name参数
        "exclusiveGroups": ["Techno", "Qualification"],
        "sortLayers": False  # 可选，保持图层顺序和代码中添加的一致
    }
).add_to(m)

# 可选：添加测试标记验证功能
folium.Marker([0, 0], popup="2G Site").add_to(group2G)
folium.Marker([1, 1], popup="3G Site").add_to(group3G)
folium.Marker([-1, -1], popup="Home Qualification").add_to(group_home)
folium.Marker([-2, -2], popup="Work Qualification").add_to(group_work)

# 保存地图
m.save("radio_map.html")

核心原理说明 #

• exclusiveGroups是Leaflet原生LayerControl的配置项，Folium通过options参数把它传递给底层控件。当你把多个叠加层组放到同一个互斥组里，Leaflet会自动将它们的复选框替换为单选按钮，同一时间只能激活其中一个。
• 主组是叠加层（overlay=True），不会和底图（base layer）冲突，所以底图会一直保留，你切换主组时只会显示对应组的子图层。
• 子组（FeatureGroupSubGroup）会继承主组的激活状态，主组被选中时，子组可以正常通过复选框单独开关。

内容的提问来源于stack exchange，提问作者zhavorsa