如何解决folium保存地图为HTML时的‘Element不在Figure中’错误

错误原因 #

问题出在Search插件依赖的FeatureGroup未被添加到地图实例。你创建的feature_group仅用来存储marker，但没有将这个图层容器加入到map对象中，导致Search插件在渲染时找不到对应的上下文，触发该错误。

修复步骤 #

1. 将feature_group添加到map实例中，让其成为地图的一部分
2. 优化marker添加逻辑，避免重复添加（marker只需加入feature_group即可，无需同时添加到map）

修改后的完整代码 #

import psycopg2
import folium
import folium.plugins
import webbrowser

# 连接数据库
conn = psycopg2.connect(host="localhost", user="sde", password="xxxx", dbname="data")
cur = conn.cursor()

# 执行查询获取数据
cur.execute("SELECT y, x, type FROM cone")
data = cur.fetchall()

# 设置地图中心点坐标
y, x, _ = data[3]  
map = folium.Map(location=[y, x], zoom_start=8)

# 创建存储标记的FeatureGroup
feature_group = folium.FeatureGroup(name="Cones")
# 关键操作：将FeatureGroup添加到地图
feature_group.add_to(map)

# 遍历数据添加标记到FeatureGroup
for datapoint in data:
    y, x, type = datapoint
    marker = folium.Marker([float(y), float(x)], popup=type)
    # 仅添加到feature_group即可，无需重复添加到map
    feature_group.add_child(marker)

# 创建基于FeatureGroup的搜索栏
search = folium.plugins.Search(layer=feature_group, search_label='Search for cones',
                               search_zoom=12, search_marker=True)
search.add_to(map)

# 保存地图为HTML文件
map.save("map.html")

# 在浏览器中打开地图
webbrowser.open("map.html")

说明 #

FeatureGroup是folium的图层容器，只有将它添加到地图实例，其内部的元素才会被纳入地图的渲染上下文。Search插件依赖该图层实现搜索功能，未加入地图的图层无法被正确识别和渲染，从而引发错误。调整后，图层和插件都处于正确的渲染上下文中，即可正常保存并打开HTML文件。

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