You need to enable JavaScript to run this app. Folium制作芝加哥交互Choropleth地图时如何实现鼠标悬停展示关联区域信息
优惠活动
大模型
产品
解决方案
定价
更多

Folium制作芝加哥交互Choropleth地图时如何实现鼠标悬停展示关联区域信息

核心问题根因

你当前的代码逻辑存在三个直接导致功能异常的问题:

  • 传入GeoJsonTooltip的fields参数写法错误:Tooltip读取要素属性时,仅需要填写GeoJSON properties节点下的直接键名,不能加上feature.properties.的路径前缀,错误的写法会导致字段匹配完全失败,tooltip直接不渲染。
  • 原生folium.Choropleth是简化封装组件:它在关联GeoJSON和你的DataFrame数据时,只会用匹配到的数值做区域填色,不会把匹配到的TOTAL字段值写回GeoJSON的要素属性中,哪怕修好tooltip的字段写法,也读不到DataFrame里存储的关联数据。
  • 你当前传给Choropleth的columns参数写法错误:这个参数要求传入DataFrame中的列名字符串,用来标记关联键列和数值列;直接传入percan.index索引对象的写法会导致Choropleth和GeoJSON的join流程完全失效,后续所有关联逻辑都无法正常运行。
可直接落地的实现方案

1. 手动完成GeoJSON和DataFrame的属性绑定

不要依赖Choropleth的自动匹配逻辑,提前把DataFrame的关联值写入每个GeoJSON要素的属性中,让tooltip可以直接读取:

import requests
import json
import folium

# 加载你使用的芝加哥社区GeoJSON数据源
geo_resp = requests.get(CHI_geodata_url)
chi_geo = json.loads(geo_resp.text)

# 逐要素匹配DataFrame中的TOTAL值
for feature in chi_geo['features']:
    # 读取当前GeoJSON要素对应的社区名
    community_name = feature['properties']['community']
    # 从你的percan DataFrame中匹配对应值
    if community_name in percan.index:
        feature['properties']['TOTAL'] = percan.loc[community_name, 'TOTAL']
    else:
        feature['properties']['TOTAL'] = '无匹配数据'

注意:这一步要确保percan的索引值和GeoJSON中存储的社区名称完全一致(大小写、特殊字符、空格都不能有差异),名称不匹配、关联键写法错误是Choropleth关联失败、tooltip读不到值的最常见诱因。

2. 替换为灵活度更高的GeoJson图层实现填色+悬停提示

放弃简化版的Choropleth组件,直接用底层的folium.GeoJson实现同样的填色效果,同时支持自定义tooltip读取绑定好的属性:

from branca.colormap import linear

# 初始化你的芝加哥地图底图
CHI_map = folium.Map(location=[41.8781, -87.6298], zoom_start=10)

# 配置和你之前一致的YlOrRd填色比例尺
colormap = linear.YlOrRd_09.scale(
    percan['TOTAL'].min(),
    percan['TOTAL'].max()
)

# 构造带填色规则、悬停高亮、自定义提示的GeoJson图层
folium.GeoJson(
    chi_geo,
    name="社区犯罪率",
    # 区域填色规则
    style_function=lambda feature: {
        'fillColor': colormap(feature['properties'].get('TOTAL', 0)),
        'color': 'gray',
        'weight': 0.2,
        'fillOpacity': 0.7,
    },
    # 鼠标悬停时的高亮效果
    highlight_function=lambda x: {'weight': 3, 'fillOpacity': 0.9},
    # 自定义悬停提示,直接读取properties下的两个关联字段
    tooltip=folium.GeoJsonTooltip(
        fields=['community', 'TOTAL'],
        aliases=['社区名称:', '统计总数:'],
        localize=True,
        sticky=False
    )
).add_to(CHI_map)

# 添加图层控制器和填色图例
folium.LayerControl().add_to(CHI_map)
colormap.caption = "Crime Rate (%)"
colormap.add_to(CHI_map)

3. 匹配逻辑校验小技巧

如果绑定后还是读不到对应值,可以临时打印几个样本做校验,确认匹配链路正常:

# 抽查前3个社区的属性绑定结果
for feature in chi_geo['features'][:3]:
    print(feature['properties']['community'], feature['properties']['TOTAL'])
实操避坑提醒
  • 尽量不要在Choropleth方法里自定义传入tooltip参数:这个组件的内置提示逻辑和自身的自动join流程深度绑定,自定义传参经常出现不渲染、读不到值的问题,底层的GeoJson组件对自定义提示、属性读取的支持灵活度更高。
  • 不要把feature.properties.这类路径前缀写到fields参数里,这是很多人刚用folium tooltip时容易踩的语法坑。
  • 如果坚持使用简化版的Choropleth组件,一定要先把percan的索引转成普通列,再把列名传给columns参数,不要直接把索引对象传进去。

内容的提问来源于stack exchange,提问作者formont2u

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.07 21:45:02