OpenLayers热力图Heatmap实现方法
OpenLayers 热力图用 ol/layer/Heatmap 图层实现:准备装有 Point(或 LineString)的 VectorSource,创建 Heatmap 图层并设置 blur、radius、weight,再加到 Map 即可。它基于 WebGL 渲染密度,适合地震点、轨迹等空间分布可视化。截至 2026 年 11 月,推荐使用 OpenLayers v10.11.0(2026 年 10 月 4 日发布)。完整类定义与选项见 Heatmap 类 API 文档。

如何快速创建 OpenLayers 热力图
面向会动手的 GIS 学习者,先明确问题:把离散点要素转成连续密度面,方便一眼看出热点。下面给出可执行步骤,验收标准是地图上出现平滑渐变的热力云,缩放平移无闪烁。
- 安装依赖:执行 npm install ol,并在入口引入 CSS(ol/ol.css)。生产环境用 Vite、webpack 等打包;开发可临时用 CDN,但不建议上线。
- 准备数据源:创建 VectorSource。点数据最稳妥,可从 GeoJSON、KML 加载,或直接 push Feature。示例常用地震 KML 或轨迹 GeoJSON。
- 实例化图层:new HeatmapLayer({ source, blur: 15, radius: 8, weight: ‘weight’ 或函数 })。weight 返回 0~1 的值,超出范围会被钳制。
- 加入地图:map.addLayer(heatmapLayer)。如需底图,先加 TileLayer(OSM 等)。
- 验收:打开浏览器控制台无 WebGL 报错;拖动滑块改 blur/radius 能即时刷新;缩放后密度仍连贯。
官方地震热力图示例完整演示了 KML 解析与交互调参,可对照 Earthquakes Heatmap 示例页面 自测。

核心配置选项与参数对照
Heatmap 继承 BaseVectorLayer,主要选项决定视觉效果与性能。下表列出常用参数(与当前主线 API 一致),不确定的以官网为准。
| 选项 | 类型 / 默认值 | 说明与注意 |
|---|---|---|
| source | VectorSource(可选) | 点要素为主;LineString 时线宽约为 2×radius |
| gradient | string[] / [‘#00f’,’#0ff’,’#0f0′,’#ff0′,’#f00′] | CSS 颜色数组,从低到高密度 |
| radius | NumberExpression / 8 | 像素半径,支持表达式;影响单个点贡献范围 |
| blur | NumberExpression / 15 | 模糊像素,最终模糊大小 ≈ radius + blur |
| weight | WeightExpression / ‘weight’ | 属性名、表达式或函数,返回 0~1 权重 |
| filter / variables | BooleanExpression / Object(可选) | 过滤要素;给表达式提供变量 |
| opacity / visible / zIndex 等 | 通用图层属性 | opacity 默认 1,visible 默认 true |
动态改参用 setBlur()、setRadius()、setGradient(),它们是可观察的,会触发 change:blur 等事件。浏览器需支持 WebGL;权重务必落在 0~1,否则视觉会失真。
权重函数与动态更新怎么写
权重决定每个点对热力的贡献。属性字段可直接写字符串 ‘magnitude’;更灵活的是函数:
- 从要素属性取值并归一化(例如地震震级 / 最大震级)。
- 按时间或类别给不同系数,突出近期事件。
- 返回值 <0 或 >1 会被自动钳制,避免异常亮斑。
交互更新常见做法:页面放两个 range 输入框,监听 input 事件后调用 layer.setBlur(value) 和 layer.setRadius(value)。轨迹数据可用 LineString,官方有 Trajectories Heatmap 示例可参考写法。表达式写法(如 [‘get’,’blur’])在部分版本可能触发 shader 编译问题,简单场景优先用数字或函数更稳妥。
注意事项与验收标准
热力图是 WebGL 图层,和普通 Canvas 矢量层行为略有不同,动手前先记住这些坑:
- 优先用 setVisible(true/false) 控制显隐,少做 removeLayer / addLayer,可减少 GL_INVALID_OPERATION 和闪烁。
- 必须移除时,可先把对应 canvas 的 style.display 设为 ‘none’ 再 remove,缓解视觉闪烁(近期 WebGL 版本常见)。
- wrapX 对热力图经常不生效,跨日界线数据需自己做预处理或切分。
- loadingstrategy.tile / bbox 与 WebGL Points 组合易出空白或循环,简单 VectorSource(全量或按需 load)更可靠。
- 导出地图(toDataURL)时热力可能丢失或偏移,需开启 preserveDrawingBuffer 并注意 pixelRatio。
- 数据量过大时先做聚合或抽稀,再喂给 Heatmap;默认是累加密度,不直接支持“平均值”(如温度场)。
验收清单:图层加载后控制台无 WebGL 错误;改 blur/radius 实时生效;缩放至不同级别密度连续;移动端或低端机无明显掉帧。
常见问题
热力图添加或移除时出现闪烁或 WebGL 报错怎么办?
先改用 layer.setVisible(false/true) 代替频繁 remove/add。若必须移除,先隐藏对应 canvas 再执行 removeLayer。多数 GL_INVALID_OPERATION 与 buffer 生命周期有关,可见性切换通常能规避。
weight 写了属性名却全是均匀颜色?
检查要素是否真有该属性,且数值已归一化到 0~1。函数形式更直观:return feature.get(‘mag’) / 10; 超出范围会被钳制,导致看起来“没变化”。
LineString 轨迹热力线宽不对或看不见?
确认几何是 LineString,并适当增大 radius(线宽约等于 2×radius)。同时检查 blur 是否过大导致过散,以及数据坐标系与地图 view 投影一致。
导出图片时热力图丢失或位置偏移?
WebGL 默认可能不保留绘制缓冲。创建 Map 时相关选项开启 preserveDrawingBuffer,并按官方 export-map 思路处理 pixelRatio 与 canvas 尺寸。
总结:用 VectorSource + HeatmapLayer,配好 blur、radius、weight,再通过 set 方法做交互,就能稳定做出 OpenLayers 热力图。建议先跑通官方地震示例验证环境,再换成自己的点数据;显隐优先用 setVisible,避免 WebGL 生命周期坑。动手前确认浏览器支持 WebGL,数据权重落在 0~1,验收时以无报错、可调参、密度连续为标准。