# Map Visualization Guide

**Component Reference:** Map or @splunk/visualizations/Map

## Overview

A map is used to show geospatial data.

## Details

- **Category:** Spatial
- **Visualization Type:** splunk.map

## Tips

- Map cooperative gesture is enabled -- scroll-to-zoom requires using the control (Windows) or command (Mac) key while scrolling to zoom the map. On touch devices, panning requires using two fingers.
- Use bubble layers to visualize count distributions across geographic locations.
- Use marker layers to identify specific locations.
- Use choropleth layers to visualize relationships between elements in certain locations or areas
- Add color to distinguish specific categories or associated statuses.
- External developers should use their own API key. Request an API key for CARTO Basemaps at [https://carto.com/basemaps/apikey/](https://carto.com/basemaps/apikey/).

## Variations

| Variation | Description | Key |
| --- | --- | --- |
| Bubble: Single Series | Use a bubble layer with Splunk’s geostats command to show distribution across various locations, where bubble size correlates to count. | basicbubbletype |
| Bubble: Multi Series | Use a bubble layer with Splunk’s geostats command to show distribution of multiple series across various locations. Locations with data from multiple series will display as a pie chart. | bubbletypeseriescolors |
| Marker: Single Series | Use a marker layer to define specific locations with latitude and longitude points. | basicmarkertype |
| Marker: Multi Series | Use a marker layer with dynamic coloring to define specific, categorized locations with latitude and longitude points. Each color should correspond to a defined category or status. | markertypedatacolors |
| Choropleth | Use a choropleth layer with dynamic coloring to define relationships between geographic locations. The default colors will display a gradient from the configured area values. | basicchoroplethtype |
| Choropleth: Source World | Use a choropleth layer with world source geojson option to define relationships between geographic locations in the world. The default colors will display a gradient from the configured area values. | choroplethtypeworld |
| Choropleth: Source US | Use a choropleth layer with US source geojson option to define relationships between geographic locations in the US. The default colors will display a gradient from the configured area values. | choroplethtypeus |
