Geo map reference

How to use and configure geo maps.

A geo map provides an easy way to visualize how a measurement varies across a geographic area. The Data Studio geo map is based on Google's GeoChart visualization.

In this article:

Geo maps in Data Studio

A Data Studio geo map 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

Geographic dimension types

The type of geographic dimension selected for a chart determines how your data will be organized on the map. For example, to group your data by city, select a dimension containing city names or valid city codes. To see your data grouped by country, select a dimension containing country names or codes. The actual values used to encode the geographic information must conform to the relevant standard used for that dimension. Some geographic types can only be used in specific data source types.

See Supported geographic field types below for more details.

Zoom area

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

If there isn't 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.

Supported geographic field types

Data Studio supports the following geographic field types. Each of the entries below includes the relevant encoding standard for that field type, the data sources in which that type can be used, and the available zoom areas for that type of field.

City

  • Encoding: n/a (Specify the city by name, e.g., "Paris")
  • Data sources supported: All*
  • Zoom areas supported: World, Continent, Sub Continent, Country, Region
Geo maps plot the City field types with map markers, rather than shaded regions, with larger markers representing greater metric values than smaller markers as shown in the image below.
Geo map example showing city markers.

*For non-Google Analytics data sources, only the top 50 rows of data are plotted. This helps minimize the chance of erroneous data due to city name duplication.

Google Analytics data sources automatically provide the latitude and longitude for the city dimension. This lets Data Studio accurately map city locations, which in turn allows it to plot the top 500 rows of data.

Because city names are not unique, you should use the zoom area to narrow down the map area and avoid duplication. See the examples below.

City Code

City ID field type is only available in Google Analytics data source.

Only the top 500 rows of data can be plotted for this field type.

Geo maps plot the City ID field types with map markers, rather than shaded regions, with larger markers representing greater metric values than smaller markers.

Continent

  • Encoding: n/a
  • Data sources supported: Google Analytics
  • Zoom areas supported: World
Continent is only available in Google Analytics data sources. Setting a field to type Geo > Continent in other data source types will cause charts using that field to display the error message, "Specified data cannot be rendered."

Continent Code

Country

  • Encoding: n/a (Specify the country by name, e.g., "France")
  • Data sources supported: All
  • Zoom areas supported: World, Continent, Sub Continent

Country Code

  • Encoding: ISO 3166-1 alpha-2 code (e.g., "AU" for Australia)
  • Data sources supported: All
  • Zoom areas supported: World, Continent, Sub Continent

Latitude Longitude

  • Encoding: Comma separated latitude and longitude decimal values (e.g., "51.5074,-0.1278" specifies to London, England)
  • Data sources supported: All
  • Zoom areas supported: World, Continent, Sub Continent, Country, Region

Metro Code

Metro and Metro codes are used to plot media markets (also known as DMA Regions). These geo field types are only available for the United States. Metro codes for the US start with 200.

Metro

  • Encoding: n/a
  • Data sources supported: Google Analytics
  • Zoom areas supported: Country, Region

Metro and Metro codes are used to plot media markets. These geo field types are only available for the United States.

Metro is only available in Google Analytics data sources. Setting a field to type Geo > Metro in other data source types will cause charts using that field to display the error message, "Specified data cannot be rendered."

Region

  • Encoding: n/a (Specify the region by name, e.g., "California")
  • Data sources supported: All
  • Zoom areas supported: Country

Region is not available for the following countries:

Region excluded countries

  • AC
  • AI
  • AQ
  • AS
  • AW
  • AX
  • BL
  • BM
  • BV
  • CC
  • CK
  • CP
  • CW
  • CX
  • DG
  • EA
  • EH
  • FK
  • FO
  • GF
  • GG
  • GI
  • GP
  • GS
  • GU
  • HK
  • HM
  • IC
  • IM
  • IO
  • JE
  • KE
  • KY
  • MC
  • MF
  • MO
  • MP
  • MQ
  • MS
  • MT
  • NC
  • NF
  • NU
  • PF
  • PM
  • PN
  • PR
  • PS
  • RE
  • SG
  • SJ
  • SX
  • TA
  • TC
  • TF
  • TK
  • TW
  • UM
  • VA
  • VG
  • VI
  • WF
  • WS
  • XK
  • YT

Region Code

Regions correspond to province or state.

  • Encoding: ISO 3166-2 code (e.g., "US-AL" for Alabama)
  • Data sources supported: All
  • Zoom areas supported: Country

Region Code is not available for the following countries:

Region Code excluded countries

  • AC
  • AI
  • AQ
  • AS
  • AW
  • AX
  • BL
  • BM
  • BV
  • CC
  • CK
  • CP
  • CW
  • CX
  • DG
  • EA
  • EH
  • FK
  • FO
  • GF
  • GG
  • GI
  • GP
  • GS
  • GU
  • HK
  • HM
  • IC
  • IM
  • IO
  • JE
  • KE
  • KY
  • MC
  • MF
  • MO
  • MP
  • MQ
  • MS
  • MT
  • NC
  • NF
  • NU
  • PF
  • PM
  • PN
  • PR
  • PS
  • RE
  • SG
  • SJ
  • SX
  • TA
  • TC
  • TF
  • TK
  • TW
  • UM
  • VA
  • VG
  • VI
  • WF
  • WS
  • XK
  • YT

Sub Continent

  • Encoding: n/a
  • Data sources supported: Google Analytics
  • Zoom areas supported: World, Continent

Sub Continent is only available in Google Analytics data sources. Setting a field to type Geo > Sub Continent in other data source types will cause charts using that field to display the error message, "Specified data cannot be rendered."

Sub Continent Code

Geo map examples

These examples are based on using a Google Analytics data source.

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

Geo map example: sessions per user for 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

Geo map example: sessions per user for US 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.
  • To view or edit the data source, click Edit. (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. 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. See the geographic dimension details above.

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. For Ads and Analytics data sources, this option is automatically set to the 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.

Learn more about working with dates and time. 

Google Analytics segment

This option appears for charts based on a Google Analytics data source.

A segment is a subset of your Analytics data. You can apply segments to your Data Studio charts to help ensure that your Data Studio and Google Analytics reports show the same data. Learn more about Analytics segments in Data Studio.

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 Click an existing filter to edit it. Mouse over the filter name and click X to delete it.
+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 map 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, and viewing the chart in the Explorer tool. 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

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

To learn more about these functions, view the Data Studio function list and filter the functions by Geo type.

Was this helpful?
How can we improve it?