##  heatmap  â

A ` heatmap ` style layer renders a range of colors to represent the density
of points in an area.

[ This visualization of earthquake data ](https://docs.mapbox.com/mapbox-gl-
js/example/heatmap-layer/) uses a heatmap layer with carefully defined [ paint
](/style-spec/reference/layers/#paint-property) properties to highlight areas
where earthquake frequency is high and many points are clustered closely
together.

###  heatmap-color  â

[ Paint ](/style-spec/reference/layers/#paint-property) property.  Optional  [
color ](/style-spec/reference/types/#color) .  Defaults to `
["interpolate",["linear"],["heatmap-density"],0,"rgba(0, 0, 255,
0)",0.1,"royalblue",0.3,"cyan",0.5,"lime",0.7,"yellow",1,"red"] ` .  Supports
[ smooth-ramp  ` interpolate ` ](/style-
spec/reference/expressions/#interpolate) expressions.

Defines the color of each pixel based on its density value in a heatmap.
Should be an expression that uses ` ["heatmap-density"] ` as input.

SDK Support  |  Mapbox GL JS  |  Android SDK  |  iOS SDK   
---|---|---|---  
basic functionality  |  >= 0.41.0  |  >= 6.0.0  |  >= 4.0.0   
data-driven styling  |  Not yet supported  |  Not yet supported  |  Not yet supported   
  
###  heatmap-intensity  â

[ Paint ](/style-spec/reference/layers/#paint-property) property.  Optional  [
number ](/style-spec/reference/types/#number) greater than or equal to ` 0 ` .
Defaults to ` 1 ` .  Supports  [ smooth-ramp  ` interpolate ` ](/style-
spec/reference/expressions/#interpolate) expressions.  opacity
Transitionable.

Similar to ` heatmap-weight ` but controls the intensity of the heatmap
globally. Primarily used for adjusting the heatmap based on zoom level.

SDK Support  |  Mapbox GL JS  |  Android SDK  |  iOS SDK   
---|---|---|---  
basic functionality  |  >= 0.41.0  |  >= 6.0.0  |  >= 4.0.0   
  
###  heatmap-opacity  â

[ Paint ](/style-spec/reference/layers/#paint-property) property.  Optional  [
number ](/style-spec/reference/types/#number) between ` 0 ` and ` 1 `
inclusive  .  Defaults to ` 1 ` .  Supports  [ smooth-ramp  ` interpolate `
](/style-spec/reference/expressions/#interpolate) expressions.  opacity
Transitionable.

The global opacity at which the heatmap layer will be drawn.

SDK Support  |  Mapbox GL JS  |  Android SDK  |  iOS SDK   
---|---|---|---  
basic functionality  |  >= 0.41.0  |  >= 6.0.0  |  >= 4.0.0   
  
###  heatmap-radius  â

[ Paint ](/style-spec/reference/layers/#paint-property) property.  Optional  [
number ](/style-spec/reference/types/#number) greater than or equal to ` 1 ` .
Units in  pixels  .  Defaults to ` 30 ` .  Supports  _[ combine  ` feature-
state ` ](/style-spec/reference/expressions/#feature-state) _ and [ smooth-
ramp  ` interpolate ` ](/style-spec/reference/expressions/#interpolate)
expressions.  opacity  Transitionable.

Radius of influence of one heatmap point in pixels. Increasing the value makes
the heatmap smoother, but less detailed. ` queryRenderedFeatures ` on heatmap
layers will return points within this radius.

SDK Support  |  Mapbox GL JS  |  Android SDK  |  iOS SDK   
---|---|---|---  
basic functionality  |  >= 0.41.0  |  >= 6.0.0  |  >= 4.0.0   
data-driven styling  |  >= 0.43.0  |  >= 6.0.0  |  >= 4.0.0   
  
###  heatmap-weight  â

[ Paint ](/style-spec/reference/layers/#paint-property) property.  Optional  [
number ](/style-spec/reference/types/#number) greater than or equal to ` 0 ` .
Defaults to ` 1 ` .  Supports  _[ combine  ` feature-state ` ](/style-
spec/reference/expressions/#feature-state) _ and [ smooth-ramp  ` interpolate
` ](/style-spec/reference/expressions/#interpolate) expressions.

A measure of how much an individual point contributes to the heatmap. A value
of 10 would be equivalent to having 10 points of weight 1 in the same spot.
Especially useful when combined with clustering.

SDK Support  |  Mapbox GL JS  |  Android SDK  |  iOS SDK   
---|---|---|---  
basic functionality  |  >= 0.41.0  |  >= 6.0.0  |  >= 4.0.0   
data-dr