WorldHeatmap
ChartsKernel density heatmap over a world map — colour encodes point concentration.
Gaussian kernel-density heatmap projected over the world atlas. Pass weighted [longitude, latitude] points and the KDE raster is clipped to landmass by default. Ideal for incident density, earthquake epicentres, or geolocated event streams.
Import
import { WorldHeatmap } from "nosible-ux"Examples
Earthquake epicentres (magnitude-weighted)
Magnitude
LOWHIGH
Tighter bandwidth, cool ramp
Signal density
LOWHIGH
Accessibility
The wrapper carries role="img" — aria-label must summarise what the map shows. The KDE raster is a visual aid only; pair heatmaps with a tabular source to preserve information for screen-reader users.
Props
| Name | Type | Default | Description |
|---|---|---|---|
aria-label | string | undefined | — | Defines a string value that labels the current element. |
bandwidth | number | undefined | — | Kernel bandwidth in px. Default: `18`. |
cellSize | number | undefined | — | KDE raster cell size in px. Default: `4`. |
clipToLand | boolean | undefined | — | Mask density cells to the landmass only. Default: `true`. |
height | number | undefined | — | |
legendTitle | string | undefined | — | |
points | HeatmapPoint[] | — | |
projection | WorldProjectionKind | undefined | — | |
ramp | string[] | undefined | — | Colour ramp (low → high). Default: Slate Core → Neo Green → Amber → Critical. |
width | number | undefined | — | |
withLegend | boolean | undefined | — |