Skip to main content
{% map %}
    {% point_layer
        data="store_locations"
        lat="latitude"
        lng="longitude"
        point_title="store_name"
    /%}
{% /map %}

​
Examples

​
Basic Point Map

{% map %}
    {% point_layer
        data="store_locations"
        lat="latitude"
        lng="longitude"
        point_title="store_name"
    /%}
{% /map %}

​
Colored by Value

{% map %}
    {% point_layer
        data="store_sales"
        lat="latitude"
        lng="longitude"
        point_title="store_name"
        color_value="sum(sales)"
        color_palette=["#feedde", "#fdd0a2", "#fdae6b", "#fd8d3c", "#e6550d", "#a63603"]
        color_value_fmt="usd"
    /%}
{% /map %}

​
Sized by Value

{% map %}
    {% point_layer
        data="store_locations"
        lat="latitude"
        lng="longitude"
        point_title="store_name"
        size_value="sum(customers)"
    /%}
{% /map %}

​
Color and Size by Different Values

{% map %}
    {% point_layer
        data="store_metrics"
        lat="latitude"
        lng="longitude"
        color_value="sum(sales)"
        size_value="sum(customers)"
        color_palette=["#feedde", "#fdd0a2", "#fdae6b", "#fd8d3c", "#e6550d", "#a63603"]
    /%}
{% /map %}

​
Categorical Coloring

{% point_layer
    data="locations"
    lat="latitude"
    lng="longitude"
    point_title="name"
    color_value="category"
    color_palette=["#236aa4", "#45a1bf", "#a5cdee", "#8dacbf", "#85c7c6"]
/%}

​
Custom Tooltip Fields

{% map %}
    {% point_layer
        data="power_plants"
        lat="latitude"
        lng="longitude"
        point_title="name"
        point_subtitle="region"
        tooltip_fields=["fuel_type", "capacity_mw", "emissions"]
    /%}
{% /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
​
color_value
string
Column or expression for coloring points. Numeric values create a gradient scale, categorical values (strings) assign discrete colors from the palette. Examples: “sum(sales)” (numeric gradient), “category” (categorical colors)
​
size_value
string
Column or expression for sizing points (e.g., “sum(customers)”). If not provided, all points will be the same size
​
point_title
string
Column name to use as the point title in tooltips (e.g., “city_name”). If not provided, lat/lng will be shown
​
point_subtitle
string
Column name to use as the point subtitle in tooltips (e.g., “region”). Displays as a second line with muted text
​
shape
string
default:"circle"
Shape of the point markerAllowed values:
  • circle
  • pin
  • square
  • triangle
  • star
  • diamond
​
color
string
Single color for all points (hex, rgb/rgba, or CSS color name)
​
color_palette
array
Array of colors for coloring. For numeric color_value: creates gradient. For categorical color_value: assigns discrete colors to categories (cycles if more categories than colors)
​
size
number
default:"6"
Base size of points in pixels
​
size_scale
number
default:"1"
Scale multiplier for value-based sizing. Higher values create larger size differences
​
tooltip
boolean
default:"true"
Show tooltips on hover
​
tooltip_fields
array
Array of SQL expressions for additional fields to show in tooltip (e.g., [“category”, “emissions”])
​
color_value_fmt
string
default:"num"
Format for color values in tooltip. See Value Formatting for available formats.
​
size_value_fmt
string
default:"num"
Format for size values in tooltip. See Value Formatting for available formats.
​
zoom_threshold
array
Zoom range [min, max] where this layer is visible (e.g., [0, 8] shows layer from zoom 0 to 8)
​
legend
boolean
default:"true"
Show legend for this layer
​
legend_label
string
Custom label for the legend (defaults to table name)
​
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