Skip to content

Commit 7b01b89

Browse files
Add Map chart documentation (#290)
* Update references/chart-types.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> * Update references/chart-types.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> * Update references/chart-types.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
1 parent 6d94aa9 commit 7b01b89

File tree

1 file changed

+59
-0
lines changed

1 file changed

+59
-0
lines changed

references/chart-types.mdx

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@ In Lightdash, the data in your results tables can be visualized in a bunch of di
1717
- [Table](#table)
1818
- [Big value](#big-value)
1919
- [Gauge](#gauge)
20+
- [Map](#map)
2021
- [Custom chart](/references/custom-charts)
2122

2223
The visualization type that you pick determines how Lightdash shows the data series in your chart. To change how your data is displayed, click **Configure** when you're querying from a table. You have the option to change the chart type in the drop-down:
@@ -413,6 +414,64 @@ To use color ranges for your rules, select **Range** under **Conditional Formatt
413414

414415
The color range will use a set of 5 colors mapped across the min and max colors selected in your rule.
415416

417+
### Map (Beta)
418+
419+
Maps display geographic data on an interactive map. They support three visualization modes:
420+
421+
**Map types:**
422+
423+
- **Scatter** - Plot individual points using latitude/longitude coordinates
424+
- **Heatmap** - Show density of points as a heat overlay
425+
- **Area (Choropleth)** - Color regions based on values
426+
427+
Maps are useful when:
428+
429+
- Visualizing geographic distribution of data
430+
- Showing regional performance or metrics
431+
- Displaying location-based patterns
432+
433+
#### Layout options
434+
435+
**Map type** - Choose between Scatter, Heatmap, or Area modes.
436+
437+
**For Scatter/Heatmap:**
438+
439+
- **Latitude field** - Field containing latitude coordinates
440+
- **Longitude field** - Field containing longitude coordinates
441+
442+
**For Area (Choropleth):**
443+
444+
- **Map region** - World, Europe, US, or Custom
445+
- **Custom region** - Toggle to use a custom GeoJSON URL
446+
- **Region field** - Field containing region names to match
447+
448+
**Value field** (optional) - Metric to determine color intensity.
449+
450+
#### Display options
451+
452+
**Color range:**
453+
454+
- Configure gradient colors (2-5 colors)
455+
- Low to high color mapping
456+
457+
**Legend:**
458+
459+
- Show/hide legend
460+
461+
**Background map:**
462+
463+
- None, Light, OpenStreetMap, Dark, Satellite
464+
- Custom background color (when None selected)
465+
466+
**Bubbles (Scatter mode only):**
467+
468+
- Size based on field (optional)
469+
- Size range slider (min/max bubble size)
470+
471+
**Map extent:**
472+
473+
- Save current map extent - Preserves zoom/pan position
474+
416475
### Big value
417476

418477
<Frame>

0 commit comments

Comments
 (0)