Skip to main content
{% map %}
    {% heatmap_layer
        data="events"
        lat="latitude"
        lng="longitude"
    /%}
{% /map %}

​
Examples

​
Basic Heatmap

{% map %}
    {% heatmap_layer
        data="events"
        lat="latitude"
        lng="longitude"
    /%}
{% /map %}

​
Weighted Heatmap

{% map %}
    {% heatmap_layer
        data="sales"
        lat="latitude"
        lng="longitude"
        weight="sum(revenue)"
    /%}
{% /map %}

​
Custom Color Palette

{% map %}
    {% heatmap_layer
        data="incidents"
        lat="latitude"
        lng="longitude"
        color_palette=["#ffffb2", "#fecc5c", "#fd8d3c", "#f03b20", "#bd0026"]
    /%}
{% /map %}

​
Adjusted Radius and Intensity

{% map %}
    {% heatmap_layer
        data="visits"
        lat="latitude"
        lng="longitude"
        weight="visit_count"
        radius=50
        intensity=2
    /%}
{% /map %}

​
Attributes

​
data
string
required
Name of the table to query
​
filters
array
Array of filter IDs to apply
​
lat
string
required
Column name for latitude values
​
lng
string
required
Column name for longitude values
​
weight
string
Column or expression for weighting points in the heatmap (e.g., “sum(sales)”). Higher values create more intense heat
​
radius
number
default:"30"
Base radius of influence for each point in pixels (adjusts with zoom)
​
intensity
number
default:"1"
Intensity multiplier for the heatmap. Higher values create more pronounced heat
​
opacity
number
default:"0.8"
Opacity of the heatmap layer (0-1)
​
color_palette
array
Array of colors for the heatmap gradient, from lowest to highest density. Defaults to theme color scale
​
zoom_threshold
array
Zoom range [min, max] where this layer is visible (e.g., [0, 8] shows layer from zoom 0 to 8)
​
where
string
Custom SQL WHERE condition to apply to the query. For date filters, use date_range instead.
​
having
string
Custom SQL HAVING condition to apply to the query after GROUP BY
​
limit
number
Maximum number of rows to return from the query. Note: When used with tables, limit will disable subtotals to prevent incomplete subtotal rows.
​
order
string
Column name(s) with optional direction (e.g. “column_name”, “column_name desc”)
​
qualify
string
Custom SQL QUALIFY condition to filter windowed results

​
Allowed Parents