Map Widgets

Map Widgets help visualize geographic data directly within reports and dashboards. They allow you to display metrics across locations using interactive maps, making it easier to identify regional trends, compare performance, and analyze geographic distribution.

Map Widgets support two visualization styles:

• Marker

• Heat Map

These options are available on accounts where the updated maps have been enabled.

Creating a Map Widget

To create a Map Widget:

1. Open or create a report.

2. Add a new visualization or edit an existing widget.

3. Select Map from the chart types.

4. Choose your data source and date range.

5. Configure geographic dimensions and metrics.

Your dataset should include:

• At least one metric

• Geographic data such as:

  • Country

  • State/Region

  • City

  • DMA

  • Latitude/Longitude fields

Choosing a Map Type

Marker

Marker maps display values as circles positioned on geographic locations.

Marker size reflects the metric value, helping compare performance across regions.

Best used for:

• Comparing values by location

• Highlighting high-volume areas

• Visualizing point-based data, including cities and latitude/longitude points

Heat Map

Heat Maps shade geographic regions based on metric intensity and show a color legend that matches the metric scale.

Darker or stronger colors represent higher values.

Best used for:

• Regional performance analysis

• Density visualization

• Geographic trend comparisons

Geography Levels

The geography levels you can choose depend on the map type.

Heat Map offers Country, State / Region, and DMA (Designated Market Area). Marker also offers City and PIN (lat/long).

On PIN (lat/long), set Longitude, Latitude, and the metric. Markers appear at those coordinates. Switching map type clears fields that no longer apply. Longitude and Latitude are empty again each time you select PIN (lat/long).

The Country / region list shows fields that match the selected geography level. Use country names or country codes for Country, state names or codes for State / Region, a DMA code or name for DMA, and a city field for City.

Configuring Map Widgets

Map Widgets typically require:

You can also apply:

• Local Filters

• Filter Groups

• Additional dimensions and metrics

A date range or filter change refreshes the map, legend, and tooltips. The saved geography selection stays in place.

Styling & Colors

Map Widgets support configurable color styling for visual clarity.

Heat Maps

Color follows the selected metric, and the legend uses the same scale.

Marker maps

Marker size reflects the selected metric. The color legend is part of a heat map.

Turn on data labels to show formatted values on locations that have data. Overlapping labels are hidden, and labels stay readable while you zoom.

Viewing & Interacting

You can interact with Map Widgets directly within reports and dashboards.

Supported interactions include:

• Scroll, or use + and −, to zoom

• Drag to pan

• Reset returns the map to the fitted view

• Hover a region or marker to see the location and the formatted metric value

If the map cannot load, it shows “Unable to load map data.”

A narrative appears when the widget size is Full and narrative is turned on, the same as on other charts.

Best Practices

• Use consistent geographic naming. Country names and country codes both match.

• Match the geography level to the field you select.

• Use Marker maps for point comparisons, including city and latitude/longitude.

• Use Heat Maps for country, state, or DMA intensity.

• Keep metrics focused for clearer visualization.