【零代码秘籍】Folium交互式地图可视化：10分钟从菜鸟到大师的完全指南

莫比乌斯@卷

于 2025-05-03 09:00:00 发布

阅读量1.2k

点赞数 8

CC 4.0 BY-SA版权

分类专栏：技术技巧 # 地理数据处理与可视化文章标签：信息可视化交互式地图

本文链接：https://blog.csdn.net/maoyu_dual/article/details/147656264

【零代码秘籍】Folium交互式地图可视化：10分钟从菜鸟到大师的完全指南

1. 引言：地图可视化的利器

在数据可视化领域，地图作为一种直观的空间信息表达方式，具有无可替代的优势。而当地图从静态走向交互式，其表达力更是呈指数级提升。Folium库作为Python生态中最受欢迎的交互式地图可视化工具，以其简洁的语法和强大的功能，让数据分析师和开发者能够轻松创建专业级的Web地图应用。

本文将带你全面掌握Folium的使用技巧，从基础地图创建到高级功能应用，帮助你快速实现各类地理数据的可视化需求，无需编写一行JavaScript代码。

2. Folium基础：理解与安装

2.1 Folium是什么？

Folium是Python的一个强大库，它将Python的数据处理能力与Leaflet.js的交互式地图可视化能力完美结合。使用Folium，你可以：

在Python中创建交互式Web地图
利用各种底图服务（OpenStreetMap, Mapbox等）
添加标记、弹出窗口、线条、多边形等地图元素
集成地理数据（GeoJSON, TopoJSON等）
创建分级统计图（Choropleth Maps）
生成热力图、聚类图等高级可视化
导出为独立的HTML文件，可在任何浏览器中查看

2.2 安装与环境配置

# 使用pip安装Folium
pip install folium

# 如果需要高级功能，安装扩展包
pip install folium branca geojson numpy pandas

# 导入基础库
import folium
import pandas as pd
import numpy as np

3. 创建你的第一个交互式地图

3.1 基础地图创建

# 创建一个地图对象，指定中心点和缩放级别
m = folium.Map(location=[30.5928, 114.3055], zoom_start=12)  # 武汉市中心

# 保存为HTML文件
m.save('my_first_map.html')

3.2 切换底图样式

Folium提供多种底图样式选择：

# 常用的底图样式
tiles = {
   
   
    '默认OpenStreetMap': 'OpenStreetMap',
    '卫星图': 'Stamen Terrain',
    '黑白底图': 'CartoDB positron',
    '暗黑模式': 'CartoDB dark_matter',
    '水彩风格': 'Stamen Watercolor'
}

# 创建包含多种样式的地图
for name, tile in tiles.items():
    m = folium.Map(location=[30.5928, 114.3055], zoom_start=12, tiles=tile)
    m.save(f'map_{
     
     tile.replace(" ", "_")}.html')

3.3 添加简单标记

# 创建基础地图
m = folium.Map(location=[30.5928, 114.3055], zoom_start=12)

# 添加标记
folium.Marker(
    location=[30.5928, 114.3055],
    popup='武汉市中心',
    tooltip='点击查看详情',
    icon=folium.Icon(color='red', icon='info-sign')
).add_to(m)

# 保存地图
m.save('map_with_marker.html')

4. 基础地图元素

4.1 标记与图标

# 创建地图
m = folium.Map(location=[30.5928, 114.3055], zoom_start=12)

# 自定义图标
custom_icon = folium.Icon(
    color='green',           # 图标颜色
    icon_color='white',      # 图标中符号的颜色
    icon='university',       # Font Awesome图标名称
    prefix='fa'              # 图标库前缀
)

# 添加带自定义图标的标记
folium.Marker(
    location=[30.5928, 114.3055],
    popup='<b>武汉大学</b><br>中国顶尖高校',
    tooltip='武汉大学',
    icon=custom_icon
).add_to(m)

# 使用圆形标记
folium.CircleMarker(
    location=[30.5830, 114.2830],
    radius=50,               # 半径（像素）
    popup='华中科技大学',
    color='#3186cc',         # 边框颜色
    fill=True,
    fill_color='#3186cc',    # 填充颜色
    fill_opacity=0.2
).add_to(m)

m.save('markers_and_icons.html')

4.2 弹出窗口与工具提示

# 创建地图
m = folium.Map(location=[30.5928, 114.3055], zoom_start=12)

# 添加带HTML格式弹出窗口的标记
folium.Marker(
    location=[30.5928, 114.3055],
    popup=folium.Popup(
        '<h3>武汉大学</h3>'
        '<img src="https://example.com/whu.jpg" width="200px"><br>'
        '<p>始建于1893年，是中国著名的综合性大学。</p>'
        '<a href="https://www.whu.edu.cn" target="_blank">官网链接</a>',
        max_width=300
    ),
    tooltip='点击查看详情',
    icon=folium.Icon(color='red', icon='graduation-cap', prefix='fa')
).add_to(m)

# 添加IFrame弹出窗口
iframe = folium.IFrame(html='<h3>华中科技大学</h3>', width=200, height=100)
popup = folium.Popup(iframe, max_width=300)

folium.Marker(
    location=[30.5830, 114.2830],
    popup=popup,
    tooltip='华中科技大学',
    icon=folium.Icon(color='blue', icon='book', prefix='fa')
).add_to(m)

m.save('markers_with_popups.html')

4.3 线条与路径

# 创建地图
m = folium.Map(location=[30.5928, 114.3055], zoom_start=12)

# 添加一条线段
folium.PolyLine(
    locations=[
        [30.5928, 114.3055],  # 武汉大学
        [30.5830, 114.2830],  # 华中科技大学
        [30.5223, 114.3559]   # 华中师范大学
    ],
    color='blue',
    weight=5,                # 线宽
    opacity=0.8,
    popup='武汉高校连线'
).add_to(m)

# 添加带箭头的线段
folium.plugins.AntPath(
    locations=[
        [30.5928, 114.3055],  # 起点
        [30.6100, 114.3600]   # 终点
    ],
    color='red',
    weight=5,
    opacity=0.8,
    popup='路线A',
    tooltip='带动画效果的路径'
).add_to(m)

m.save('lines_and_paths.html')

4.4 多边形区域

# 创建地图
m = folium.Map(location=[30.5928, 114.3055], zoom_start=12)

# 创建多边形
folium.Polygon(
    locations=[
        [30.6000, 114.3000],
        [30.6000, 114.3200],
        [30.5800, 114.3200],
        [30.5800, 114.3000]
    ],
    color='purple',
    fill=True,
    fill_color='purple',
    fill_opacity=0.4,
    popup='武昌区域范围'
).add_to(m)

# 添加圆形区域
folium.Circle(
    location=[30.5928, 114.3055],
    radius=2000,             # 半径（米）
    color='green',
    fill=True,
    fill_color='green',
    fill_opacity=0.2,
    popup='2公里覆盖范围'
).add_to(m)

m.save('polygons_and_areas.html')

5. 高级地图功能

5.1 分级统计图 (Choropleth Maps)

# 加载示例数据
import pandas as pd
data = pd.DataFrame({
   
   
    'district': ['东湖高新区', '江岸区', '江汉区', '硚口区', '汉阳区', '武昌区', '洪山区'],
    'population': [10000, 85000, 75000, 65000, 70000, 90000, 80000]
})

# 加载区域GeoJSON数据（假设已有武汉市区域GeoJSON文件）
import json
with open('wuhan_districts.geojson', 'r', encoding='utf-8') as f:
    wuhan_geo = json.load(f)

# 创建地图
m = folium.Map(location=[30.5928, 114.3055], zoom_start=11)

# 添加分级统计图
folium.Choropleth(
    geo_data=wuhan_geo,
    name='人口分布',
    data=data,
    columns=['district', 'population'],
    key_on='feature.properties.name',  # GeoJSON中的属性名
    fill_color='YlOrRd',              # 色阶
    fill_opacity=0.7,
    line_opacity=0.2,
    legend_name='人口数量'
).add_to(m)

# 添加图层控制
folium.LayerControl().add_to(m)

m.save('choropleth_map.html')

5.2 热力图 (Heatmap)

# 加载示例点数据
import numpy as np
np.random.seed(42)
data = pd.DataFrame({
   
   
    'lat': np.random.normal(30.58, 0.05, 500),
    'lon': np.random.normal(114.30, 0.05, 500),
    'value': np.random.uniform(1, 10, 500)  # 权重值
})

# 创建地图
m = folium.Map(location=[30.5928, 114.3055], zoom_start=12)

# 添加热力图
from folium.plugins import HeatMap
HeatMap(
    data=data[['lat', 'lon', 'value']].values.tolist(),
    radius=15,              # 热点半径
    gradient={
   
   0.4: 'blue', 0.65: 'lime', 1: 'red'},  # 自定义色阶
    min_opacity=0.2,
    max_opacity=0.8,
    blur=10
).add_to(m)

m.save('heatmap.html')

5.3 标记聚类 (Marker Cluster)

# 创建地图
m = folium.Map(location=[30.5928, 114.3055], zoom_start=12)

# 创建聚类标记组
from folium.plugins import MarkerCluster
marker_cluster = MarkerCluster().add_to(m)

# 生成随机点
np.random.seed(42)
for i in range(100):
    lat = np.random.uniform(30.55, 30.65)
    lon = np.random.uniform(114.25, 114.35)
    
    folium.Marker(
        location=[lat, lon],
        popup=f'标记 #{
     
     i+1}',
        icon=folium.Icon(color='green', icon='info-sign')
    ).add_to(marker_cluster)

m.save('marker_cluster.html')

5.4 自定义图层控制

# 创建地图
m = folium.Map(location=[30.5928, 114.3055], zoom_start=12)

# 创建不同的特征组
universities = folium.FeatureGroup(name='高校')
hospitals = folium.FeatureGroup(name='医院')
parks = folium.FeatureGroup(name='公园')

# 添加高校标记
universities_data = [
    {
   
   'name': '武汉大学', 'location': [30.5928, 114.3055]},
    {
   
   'name': '华中科技大学', 'location': [30.5830, 114.2830]},
    {
   
   'name': '华中师范大学', 'location': [30.5223, 114.3559]}
]

for uni in universities_data:
    folium.Marker(
        location=uni['location'],
        popup=uni['name'],
        icon=folium.Icon(color='blue', icon='graduation-cap', prefix='fa')
    ).add_to(universities)

# 添加医院标记
hospitals_data = [
    {
   
   'name': '武汉协和医院', 'location': [30.5800, 114.3000]},
    {
   
   'name': '湖北省人民医院', 'location': [30.6000, 114.2800]}
]

for hospital in hospitals_data:
    folium.Marker(
        location=hospital['location'],
        popup=hospital['name'],
        icon=folium.Icon(color='red', icon='plus', prefix='fa')
    ).add_to(hospitals)

# 添加公园区域
parks_data = [
    {
   
   'name': '东湖', 'polygon': [
        [30.5800, 114.3600],
        [30.5800, 114.3900],
        [30.5500, 114.3900],
        [30.5500, 114.3600]
    ]}
]

for park in parks_data:
    folium.Polygon(
        locations=park['polygon'],
        popup=park['name'],
        color='green',
        fill=True,
        fill_color='green',
        fill_opacity=0.4
    ).add_to(parks)

# 将所有特征组添加到地图
universities.add_to(m)
hospitals.add_to(m)
parks.add_to(m)

# 添加图层控制
folium.LayerControl().add_to(m)

m.save('custom_layer_control.html')

6. 实用案例与扩展功能

6.1 房地产选址分析地图

# 创建地图
m = folium.Map(location=[30.5928, 114.3055], zoom_start=12)

# 添加房产标记
properties = [
    {
   
   'name': '项目A', 'location': [30.5900, 114.3100], 'price': 15000, 'area': 120},
    {
   
   'name': '项目B', 'location': [30.6000, 114.3200], 'price': 18000, 'area': 90},
    {
   
   'name': '项目C', 'location': [