📔
(EN) Insights Report User Guide
  • INSIGHTS
    • Release Noted
    • Quick start guide
    • Reports
      • Create reports
        • About reports
        • Build, stylize, and add data to reports
          • Set report date ranges
          • Add and configure components
          • Chart references
            • Area chart reference
            • Bar chart reference
            • Bullet chart reference
            • Geo chart reference
            • Line chart reference
            • Pie chart reference
            • Pivot table reference
            • Scatter and bubble chart reference
            • Scorecard reference
            • Table reference
            • Time series reference
            • Treemap reference
          • Add reference lines to charts
          • Add and edit data
          • Add pages and report navigation
          • Report layout options
          • Work with color
          • Add text, images, lines, and shapes
          • Arrange and distribute components
          • Use the Insights Report Editor
        • Copy a report
        • Delete a report
        • Tutorial: Create a new report
      • Filter your data
        • About filters
        • Create, edit, and manage filters
        • Configure filter conditions
        • Filter examples
      • Make reports interactive
        • Let your viewers control the date range
        • About controls
        • Use controls across data sources
        • Add chart interaction filters
        • Let viewers drill down into your data
        • Link to a page
        • Export data from a chart
        • Embed external content in reports
        • Let viewers select the fields in charts
      • Blend multiple data sources in a chart
        • About data blending
        • Blend data in charts
        • Filter blended data
        • Change the date range for blended data
        • Use blending to reaggregate data
    • Glossary
      • Aggregation
      • Blended data
      • Chart
      • Component
      • Component, report-level
      • Connector
      • Data set
      • Data source
      • Dimension
      • Edit mode
      • Field
      • Join key
      • Metric
      • Owner
      • Page
      • Properties panel
      • Report
      • View mode
      • Viewer (user type)
Powered by GitBook
On this page

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.

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.

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.

Default date range

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

Default date range options

Filter

Filter options

Interactions

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.

Background and border

These options control the appearance of the chart background container.

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:

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

Last updated 3 years ago

To view or edit the data source, click . (You must have at least view permission to see this icon.)

Click +BLEND DATA to see data from multiple data sources in the same chart. .

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. .

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

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. .

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)

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.

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

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.

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 charts in Insights
  • Geo chart examples
  • Configure the chart
  • Data properties
  • Style properties
  • Geo chart limits
  • Geo functions
  • Related resources
Learn more about data blending
Learn more about chart drill down
Learn more about the filter property.
Learn more about chart interaction filters
Filter property
PreviousBullet chart referenceNextLine chart reference
  1. INSIGHTS
  2. Reports
  3. Create reports
  4. Build, stylize, and add data to reports
  5. Chart references

Geo chart reference

How to use and configure Geo charts.

Filter name

+Add a filter

Creates a new filter for the chart.

Geo map example: sessions per user for France
Geo map example: sessions per user for US states

Click an existing filter to edit it. Mouse over the filter name and click to delete it.