Geo charts
Celiq has three map-based chart types. They activate automatically when your data contains geographic fields.
Requirements
Your node must have a field with a geo_type annotation, or a column whose name matches a known geo pattern (lat, longitude, country, country_code, city, state, zip).
See Forge → Geo types → for the full annotation guide.
Geo Bubble (🌍)
Plots circles on a map. Circle size encodes the metric. Best for point-level data (stores, events, transactions by city).
Auto-selected when: latitude + longitude columns + metric, or any named-place geo field + metric.
Settings
| Setting | Options | Default |
|---|---|---|
| Max bubble size | 10–60 px | 28 px |
| Fill opacity | 20–100% | 65% |
| Map style | Light / Dark / Streets / Satellite | Light |
Geo Heatmap (🌡)
Density heatmap on a map — shows concentration of values without explicit sizing.
Settings
| Setting | Options | Default |
|---|---|---|
| Map style | Light / Dark / Streets | Light |
Geo Area / Choropleth (🗺)
Fills country or region polygons with colour based on a metric value. Best for country-level or state-level data.
Auto-selected when: country_name or country_code column + metric.
Settings
| Setting | Options | Default |
|---|---|---|
| Colour scale | Indigo / Teal / Red / Orange | Indigo |
| Reverse scale | On / Off | Off |
| Map style | Light / Dark / Minimal | Light |
Name resolution
Celiq resolves named places (country names, city names, US states) to lat/lng coordinates automatically using built-in lookup tables:
- Countries: 194 entries (ISO 2, ISO 3, full name)
- US states: 51 entries (50 states + DC, abbreviation + full name)
- Cities: 164 major world cities
If a place name can't be resolved, that row is excluded from the map and a warning is shown.
Related
- Forge → Geo types → — annotate geo columns in CML