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.
Related resources
Filter property
Last updated
Was this helpful?
