PyQt嵌入Folium地图放大到15级及以上变灰卡顿如何解决？

• 核心原因是你使用的Stamen Terrain公开瓦片源默认最高仅支持14级缩放，当你放大到15级及以上时，没有对应的瓦片资源可以加载，就会出现地图区域变灰的情况。
• 嵌入PyQt时使用的QWebEngineView组件在大量瓦片请求失败时，会触发无效渲染请求、内存占用异常升高，最终导致卡顿甚至界面冻结。
• 你代码中写的Popup="Start"属于无效参数，该参数是Marker类的配置项，写在Map初始化参数中不会生效，也不会对功能产生负面影响。

方案1：限制地图最大缩放层级（适配Stamen Terrain瓦片） #

直接在Map初始化时添加max_zoom=14参数，禁止用户放大到瓦片不支持的层级，从根源避免问题触发，修改后的代码如下：

coordinate = (32.6, -97.4)
m = folium.Map(
    tiles='Stamen Terrain',
    zoom_start=14,
    location=coordinate,
    max_zoom=14
)
# 正确添加弹窗的方式
folium.Marker(
    location=coordinate,
    popup="Start"
).add_to(m)

方案2：更换支持更高缩放的瓦片源 #

如果需要15级及以上的缩放能力，可以替换为支持更高缩放的瓦片源，比如默认的OpenStreetMap瓦片最高支持19级缩放，修改代码如下：

coordinate = (32.6, -97.4)
m = folium.Map(
    tiles='OpenStreetMap',
    zoom_start=14,
    location=coordinate,
    max_zoom=19
)
folium.Marker(
    location=coordinate,
    popup="Start"
).add_to(m)

方案3：优化PyQt嵌入配置 #

如果替换瓦片后还是存在卡顿问题，可以优化QWebEngineView的配置：

• 开启硬件加速，减少渲染卡顿
• 开启本地缓存，避免重复加载瓦片占用带宽
• 配置瓦片请求超时时间，避免无效请求阻塞渲染线程

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