Geo chart reference

How to use and configure Geo charts.

A Geo chart provides an easy way to visualize how a measurement varies across a geographic area.

Geo charts in Insights

An Insights Geo chart requires you to provide 3 pieces of information:

  • a geographic dimension, such as Country, City, Region, etc.

  • a metric, such as Sessions, Units Sold, Population, etc.

  • the map's zoom area.

Zoom area

The zoom area determines how much of the world the map displays. It also can restrict the data shown by the Geo chart. For example, selecting the City dimension and setting the zoom area to Germany (DE), limits the Geo chart to showing cities in Germany. The map itself zooms in to focus on Germany.

If there is not a 1:1 mapping between the selected geo field type and available zoom areas, you may be able to restrict the data using a filter, as shown in the examples below.

Geo chart examples

Example 1: Limit the map display to a specific country (e.g., France).

Step 1: Set the dimension and visible area

  • Dimension: Country

  • Metric: Number of Sessions per User

  • Zoom Area: Western Europe

Step 2: Filter the country dimension to only include France.

  • Dimension: Country

  • Match Type: Equals

  • Expression: France

Example 2: Display US state map

Step 1: Set the dimension and visible area

  • Dimension: Region

  • Metric: Number of Sessions per User

  • Visible Area: US

Step 2: Filter the country dimension to only include the United States

  • Dimension: Country

  • Match Type: Equals

  • Expression: United States

Configure the chart

Select the chart, then on the right, use the properties panel to configure the chart options.

Data properties

The options in a chart's data properties panel affect how the data is organized and displayed.

Data source

A data source provides the connection between the component and the underlying data set. Data source options are:

  • To change the chart's data source, click the current data source name.

  • Click +BLEND DATA to see data from multiple data sources in the same chart. Learn more about data blending.

Dimension

Dimensions are data categories. Dimension values (the data contained by the dimension) are names, descriptions or other characteristics of a category.

Add dimensions to the chart by dragging fields from the Available Fields panel on the right. You can also click Add dimension in the Data tab.

A single valid geo dimension is required.

Drill down

This option appears on charts that support drill down.

Drilling down gives viewers a way to reveal additional levels of detail within a chart. When you turn on Drill down, each dimension you add becomes another level of detail you can drill into. Learn more about chart drill down.

Date range dimension

This option appears if your data source has a valid date dimension.

The Date Range Dimension is used as the basis for limiting the date range of the chart. For example, this is the dimension used if you set a date range property for the chart, or if a viewer of the report uses a date range control to limit the time frame.

Metric

Metrics measure the things contained in dimensions and provide the numeric scale and data series for the chart.

Add metrics to the chart by dragging fields from the Available Fields panel on the right. You can also click Add metric in the Data tab.

Any single available metric is required. Your data will be displayed on the map using a color progression to indicate relative value, with higher intensity color gradient representing higher values than lower intensity colors. You can change the color of the map using the STYLE tab.

Zoom area

This limits the map display to the selected area. The choices available depend on the scope of the geo field type used for a given chart. For example, when a City geo field is selected, options for Visible Area are limited to Country and Region. When a Sub Continent Code field is selected, options for Visible Area are limited to World and Continent.

World

Displays the entire world map.Available with the following geo field types:

  • Continent

  • Continent Code

  • Sub Continent

  • Sub Continent Code

  • Country

  • Country Code

  • Latitude, Longitude

  • City

  • City Code

Continent

Displays the selected continent.Available with the following geo dimensions:

  • Sub Continent

  • Sub Continent Code

  • Country

  • Country Code

  • Latitude, Longitude

  • City

  • City Code

Subcontinent

Displays the selected subcontinent.Available with the following geo dimensions:

  • Country

  • Country Code

  • Latitude, Longitude

  • City

  • City Code

Country

Displays the selected country.Available with the following geo dimensions:

  • City

  • City Code

  • Metro

  • Metro Code

  • Region

  • Region Code

  • Latitude, Longitude

Region

Displays the selected region.Available with the following geo dimensions:

  • City

  • Metro Code (US only)

Default date range

The default date range property lets you set a timeframe for an individual chart.

Default date range options

Auto

Use the default date range determined by the chart's data source.

Custom

Lets you use the calendar widget to select a custom date range for the chart.

Date compare type

Displays comparison data for the selected time period.

Filter

The filter property restricts the data displayed in the component by including or excluding the values you specify. Learn more about the filter property.

Filter options

Filter name

+Add a filter

Creates a new filter for the chart.

Interactions

When interactions are enabled on a chart, that charts acts like a filter controls. You can filter the report by clicking or "brushing" your mouse across the chart. Learn more about chart interaction filters.

Style properties

A chart's style properties control the overall presentation and appearance of the chart.

Geo chart

These properties control the appearance of the chart elements.

Max color value

Sets the color for the highest value in the data range. Typically, this should be the darkest shade in the chart.

Mid color value

Sets the color for the median value in the data range. Typically, this should be a medium shade.

Min color value

Sets the color for the lowest value in the data range. Typically, this should be the lightest shade in the chart.

Show Legend

Shows or hides the metric legend.

Background and border

These options control the appearance of the chart background container.

Background

Sets the chart background color.

Border Radius

Adds rounded borders to the chart background. When the radius is 0, the background shape has 90° corners. Border radius of 100° produces a circular shape.

Opacity

Sets the chart's opacity. 100% opacity completely hides objects behind the chart. 0% opacity makes the chart invisible.

Border Color

Sets the chart border color.

Border Weight

Sets the chart border line thickness.

Border Style

Sets the chart border line style.

Add border shadow

Adds a shadow to the chart lower and right borders.

Chart Header

The chart header lets viewers perform various actions on the chart, such as exporting the data, drilling up or down. Chart header options are:

Show on hover (default)

Three vertical dots appear when you mouse over the chart header. Click these to access the header options.

Always show

The header options always appear.

Do not show

The header options never appear. Note that report viewers can always access the options by right clicking the chart.

Color

Set the color of the chart header options.

Geo chart limits

Geo charts include the first 5000 rows of data, unless otherwise mentioned for a field type. Chart data is sorted in descending order based on the selected metric.

Geo functions

Insights provide a number of geo functions that can be used to work with and transform geographic information in your data sources.

  • Filter property

Last updated