Add Map chart documentation

references/chart-types.mdx

@@ -17,6 +17,7 @@ In Lightdash, the data in your results tables can be visualized in a bunch of di
 - [Table](#table)
 - [Big value](#big-value)
  - [Gauge](#gauge)
+- [Map](#map)
 - [Custom chart](/references/custom-charts)
 
 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
 
 The color range will use a set of 5 colors mapped across the min and max colors selected in your rule.
 
+### Map (Beta)
+
+Maps display geographic data on an interactive map. They support three visualization modes:
+
+**Map types:**
+
+- **Scatter** - Plot individual points using latitude/longitude coordinates
+- **Heatmap** - Show density of points as a heat overlay
+- **Area (Choropleth)** - Color regions based on values
+
+Maps are useful when:
+
+- Visualizing geographic distribution of data
+- Showing regional performance or metrics
+- Displaying location-based patterns
+
+#### Layout options
+
+**Map type** - Choose between Scatter, Heatmap, or Area modes.
+
+**For Scatter/Heatmap:**
+
+- **Latitude field** - Field containing latitude coordinates
+- **Longitude field** - Field containing longitude coordinates
+
+**For Area (Choropleth):**
+
+- **Map region** - World, Europe, US, or Custom
+- **Custom region** - Toggle to use a custom GeoJSON URL
+- **Region field** - Field containing region names to match
+
+**Value field** (optional) - Metric to determine color intensity.
+
+#### Display options
+
+**Color range:**
+
+- Configure gradient colors (2-5 colors)
+- Low to high color mapping
+
+**Legend:**
+
+- Show/hide legend
+
+**Background map:**
+
+- None, Light, OpenStreetMap, Dark, Satellite
+- Custom background color (when None selected)
+
+**Bubbles (Scatter mode only):**
+
+- Size based on field (optional)
+- Size range slider (min/max bubble size)
+
+**Map extent:**
+
+- Save current map extent - Preserves zoom/pan position
+
 ### Big value
 
 <Frame>