Leaflet.heat

A tiny, simple and fast Leaflet heatmap plugin (community bugfix fork). Uses simpleheat under the hood, additionally clustering points into a grid for performance.

• Package: @daishu10000/leaflet-heat
• Homepage: https://github.com/daishu0000/Leaflet.heat
• License: BSD-2-Clause

Demos

• 10,000 points →
• Adding points dynamically →

Basic Usage

var heat = L.heatLayer([
	[50.5, 30.5, 0.2], // lat, lng, intensity
	[50.6, 30.4, 0.5],
	...
], {radius: 25}).addTo(map);

To include the plugin, just use leaflet-heat.js from the dist folder:

<script src="leaflet-heat.js"></script>

Building

To build the dist files run: npm install && npm run prepublish

Reference

L.heatLayer(latlngs, options)

Constructs a heatmap layer given an array of points and an object with the following options:

• minOpacity - the minimum opacity the heat will start at
• maxZoom - zoom level where the points reach maximum intensity (as intensity scales with zoom), equals maxZoom of the map by default
• max - maximum point intensity, 1.0 by default
• radius - radius of each "point" of the heatmap, 25 by default
• blur - amount of blur, 15 by default
• gradient - color gradient config, e.g. {0.4: 'blue', 0.65: 'lime', 1: 'red'}
• pane - Map pane where the heat will be drawn. Defaults to 'overlayPane'.

Each point in the input array can be either an array like [50.5, 30.5, 0.5], or a Leaflet LatLng object.

Optional third argument in each LatLng point (altitude) represents point intensity. Unless max option is specified, intensity should range between 0.0 and 1.0.

Methods

• setOptions(options): Sets new heatmap options and redraws it.
• addLatLng(latlng): Adds a new point to the heatmap and redraws it.
• setLatLngs(latlngs): Resets heatmap data and redraws it.
• redraw(): Redraws the heatmap.

Changelog

This fork is maintained from version 0.2.1 onward. For 0.2.0 and earlier, see the upstream repository.

0.2.1 — Feb 20, 2026

• Fix crash when map and heat use different Leaflet instances.

0.2.2 — Feb 21, 2026

• A better max setting.

0.3.0 — Feb 21, 2026

• Use the newest version of simpleheat.js and modernize the environment.

0.3.1 — Feb 21, 2026

• Update the license.

0.3.2 — Feb 21, 2026

• Update eslint.

0.3.3 — Feb 21, 2026

• Update README.md.