Geo Map

A full-screen, general-purpose interactive map — think Google My Maps, but built directly on top of your own Chomper event data. One map, made of independently-toggleable layers: heatmaps and point clusters driven by SQL against chomper.events, and hand-placed marker layers for things that aren't in your event stream at all (offices, warehouses, branches). Everything renders on the same canvas, with the same time-range and Filters controls you already know from dashboards.

Two kinds of layer

Layer type	What it shows	Configured by
SQL layer	A density heatmap or discrete point clusters, built from any query returning `lat`/`lon` (and optionally `weight`, `layer`)	A query, same convention as the `sql_geo` dashboard panel
Marker layer	Hand-placed pins — a title, an icon, an optional rich-text note, an optional expiry	Drag-and-drop on the map, or the management API

Every viewer toggles which layers they personally want visible, independent of what anyone else logged in sees — a shared map, without forcing everyone to look at the same clutter.

Geo Map showing a Sales heatmap, a Calls heatmap, and Stores marker pins around Kyiv — A Sales heatmap (green→amber→red density), a Calls heatmap layered underneath, and hand-placed Stores markers on top — all on one canvas.

The layer panel

Every layer — SQL or marker — gets its own row: visibility toggle, color swatch, a drill-down button, and a settings gear. Adding a new layer is two clicks away at the bottom of the panel.

Geo Map layer panel showing Sales, Calls, Complaints heatmap layers and a Stores marker layer — Sales/Calls/Complaints are SQL heatmap layers against real event data; Stores is a marker layer with five hand-placed pins.

Heatmap vs. points, and point clustering

Every SQL layer picks one of two rendering modes, switched with a click in that layer's own settings — no need to touch the query. Heatmap renders a density gradient (see the Sales layer above); points plots one discrete circle per row instead, which reads better once you care about individual events rather than an overall density picture.

Calls layer switched to points mode, showing individual dots for each call event — The same Calls data as before, switched to points mode — one dot per real call_inbound event instead of a density blob.

Points mode has an optional clustering toggle: points that visually touch at the current zoom level merge into a single circle, sized by how many points it represents — hover it to see the exact count. Zoom or pan and it recomputes on the fly, so a cluster splits back into its individual points as soon as there's enough screen space to tell them apart.

Same points layer with clustering enabled, showing merged circles and a hover tooltip reading 114 points — Clustering enabled, same zoom level: the loose dots above merge into size-scaled circles — hovering the biggest one here shows the real count, 114 points.

Markers with notes

A marker can carry a short rich-text note — bold, italic, an image — shown on hover. Useful for anything that deserves a label beyond just a pin: what a location is, when it opened, who to contact.

Hovering a marker pin shows its title and a formatted note — Hovering any pin shows its title and note inline — no click, no separate panel.

Drill-down: click a hot spot, see the raw rows

Arm a SQL layer's drill-down, then drag a circle anywhere on the map — every matching event inside that radius opens in a filterable, sortable, paginated table, with a one-click CSV export. The exact same drill-down mechanism used throughout the rest of Chomper's dashboards, just triggered by a map gesture instead of clicking a chart.

Drill-down modal showing 70 real sale events after dragging a circle on the heatmap — Dragging a circle over the hottest part of the Sales heatmap pulled up all 70 real sale events underneath it — filterable per column, exportable as CSV.

Managing it from your own scripts

Same shape as every other module's automation story: generate a module-wide management key from this module's own Settings, then create/edit/delete layers, markers, and Filters over a plain HTTP API — no need to walk someone through the drag-and-drop UI to add "one pin per warehouse" from a spreadsheet. Full request/response reference: import docs/ai-context/geo-map.md into your own assistant alongside the core Chomper context file.

Also included

Per-marker lifespan — a pin can fade to grayscale with a crack overlay once it "expires," relative to whatever time window you're currently viewing.
Full version history for the whole map — every layer/marker/filter change is snapshotted, with one-click restore.
Global Filters, the same dashboard-Variables mechanism, scoped to the map.

Pricing

$15 one-time per server, bought from your customer portal (Servers → Modules) — no subscription.