Heatmaps

Heatmaps are used to visualize the density of points on a map.

Heatmaps work on point layers only, and show concentration rather than individual feature values — if you need to read a specific attribute, use a numeric visualization instead. The config block must be empty ({}), and heatmaps support no popups or labels.

Heatmap visualizations are defined using "type": "heatmap" and allow the following properties to be set:

Field name	Type	Default	Typical range	Description
color	string	"@geyser"	—	A heatmap palette name, from less density to more.
size	number	10	1–30 px	Radius of influence in pixels. Larger = smoother, smaller = more detailed.
intensity	number	0.5	0.1–3.0	How quickly density saturates. Higher = more contrast.
opacity	number	0.9	0–1	Transparency.

Tune size for the zoom you expect to view at — larger at low zoom, smaller at high zoom.

This is an example of a heatmap visualization

defined with the following visualization

{
  "version": "2.3.1",
  "type": "heatmap",
  "config": {},
  "legend": {"displayName": {"0": "Low", "1": "High"}},
  "paint": {"color": "@purpYlPink", "size": 10, "intensity": 0.2}
}