Folium 0.14.0无地图显示、0.15.0报错问题求助

问题分析 #

• 0.14.0版本无法显示地图：大概率是该版本默认瓦片服务配置存在兼容性问题，或是本地网络、依赖库版本变化导致加载失败。
• 0.15.0版本报错ValueError: Custom tiles must have an attribution：这是Folium 0.15.0开始强制要求自定义瓦片必须添加版权归属（attribution），官方为合规性新增了该校验，此前版本无强制要求。

解决步骤 #

1. 修复0.15.0版本自定义瓦片报错问题 #

使用自定义瓦片时，必须在folium.Map()中指定attr参数，提供瓦片服务的版权声明。示例代码：

import folium

# 示例：替换为你需要的瓦片URL和对应版权声明
m = folium.Map(
    location=[39.9042, 116.4074],
    zoom_start=10,
    tiles='https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png',
    attr='© OpenStreetMap contributors'
)
m.save('map.html')

若使用第三方瓦片服务（如高德、谷歌），需替换为对应瓦片URL和正确版权声明，比如高德瓦片可设置attr='© 高德地图'。

2. 回退到0.14.0版本并修复显示问题（可选） #

若不想升级到0.15.0，可回退版本并手动指定可用瓦片服务：

• 卸载当前版本：pip uninstall folium -y
• 安装0.14.0版本：pip install folium==0.14.0
• 使用时显式指定瓦片URL和attr参数，避免默认配置失效，代码结构同上。

3. 排查网络环境问题 #

无论哪个版本，若地图无法显示，先检查：

• 本地网络能否访问瓦片服务URL（直接在浏览器打开瓦片链接，确认是否能加载图片）
• 若使用国内瓦片服务，替换为国内可访问的瓦片地址，规避网络限制导致的加载失败。

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