Google Maps reference

Visualize your data in Google Maps.

Adding Google Maps to your reports gives your viewers a familiar interactive environment in which to explore geographic data. Google Maps in Data Studio are highly customizable and integrate with any data source that contains valid geo fields.

New feature icon.New Feature

We're excited about this new feature and hope you are, too. Please share your feedback in the Data Studio Help Forum.

Send feedback


To see your data plotted on Google Maps:

  1. Edit your report.
  2. Navigate to the page that will contain the chart.
  3. In the tool bar, click Add a chart.
  4. Select Google Maps.
  5. Click the canvas to add the chart to the report.
  6. On the right, configure the chart using the DATA and STYLE tabs.

Watch an overview video

Visualize your data using Google Maps and Data Studio

What you need to use Google Maps in Data Studio

To add Google Maps to Data Studio, you'll need a data source with one or more geographic dimensions. Data sources based on Google Analytics and Google Ads automatically include fields you can use, such as Country, City, Region, Metro area, Store location, and so on.

For other data source types, such as Google Sheets or BigQuery, make sure that any geographic fields have the right data type:

  1. Edit the data source.
  2. Locate the geographic dimension(s) you want to use in Google Maps.
  3. Use the Type menu to select the appropriate Geo field type (Country, City, Region, etc.)

Learn more about geographic dimensions.

How Google Maps in Data Studio work

Google Maps plot your data as bubbles overlaid on the familiar Google Map interface.

The geographic dimension you choose determines the granularity of the data plotted on Google Maps. For example, selecting Country plots the data by country, while using the City dimension visualizes the data for each city in the data set.

Example of a Google Maps grouped by 1) Country and 2) City.

You can add up to 2 metrics to the Google Map. One metric can use bubble size to indicate scale, while the other can use color. For example, the report below shows the effect of applying color and size to maps with 2 metrics.

Google Maps examples showing 1) Sessions by bubble size, and 2) Sessions by bubble size and Revenue per user by bubble color.

Example of bubble color and size:

1) Bubble Size metric = Sessions. Note the USA has the highest number of Sessions.

2) Bubble Size metric = Sessions, Bubble Color metric = Revenue Per User. Note that Thailand has the highest Revenue per User.

Google Maps controls

Report viewers can use map controls to interact with the map. You can show or hide these map controls by editing the map Style properties.

  1. Viewers can pan by clicking and dragging the map to show different regions, or zoom using their mouse or keyboard, or by clicking the zoom icons: Add icon. and Remove icon..
  2. To open Street View, drag Pegman onto the map .
  3. To toggle fullscreen mode, click Fullscreen icon..
  4. To switch views, click Map or Satellite.
  5. The map scale appears at the bottom of the map and changes as you zoom in or out.

Google Maps satellite view

Example Google Maps chart with interactive controls, map scale, and map type set to satellite view.

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.


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.

Bubble location

The dimension used to determine where the bubbles appear on the map.


(Optional) The dimension used to provide a label for each bubble (displayed when the viewer mouses over the bubble). Providing a tooltip lets you override the default label provided by the bubble location dimension. For example, you can locate bubbles based on a store address but use the store name in the tooltip.

The Tooltip and Bubble color dimensions must have a unique value for each value of the Bubble location dimension. If the values are duplicated, you'll see an error message:

Error Displaying Google Map

Multiple values of the color dimension or tooltip dimension were assigned to the same bubble. Please change one of the dimensions.

Be sure to use a dimension that has a 1:1 relationship with your location dimension.

Bubble color

(Optional) The dimension used to determine the color of the bubbles. For example, the map below uses Country as the location dimension, but uses Sub Continent to provide the bubble colors. Each country is shown using a color representing the sub-continent in which it's found.

As with the Tooltip dimension, be sure to use a Bubble color dimension that has a 1:1 relationship with your Bubble location dimension. The example above works because a country can only be in one sub-continent.

You can instead color bubbles based on a metric. If you do, you can't use the Bubble color dimension option.

Date range dimension

This option appears if your data source has a valid date dimension. For Google 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.


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.

Bubble size

Use the size of the bubbles to convey relative metric values.

Bubble color

Use the color of the bubbles to convey relative metric values. If you choose this option, you can't use the Bubble color dimension option.


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.

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.


When interactions are enabled on a chart, that charts acts like a filter controls. You can filter the report by clicking a bubble on the map. Learn more about chart interaction filters.

Style properties

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

Background Layer

Controls the appearance of the base map.

Map | Satellite Sets the default map background.

Sets the color theme for the map. Use the report's current theme, select one of the preset map style, or edit the map's JSON code to create a custom map style.

Roads, Landmarks, Labels Use the sliders to select the level of background details to display in the map background.

Bubble Layer

Sets the number and size of bubbles displayed on the map.


Sets the bubble colors:

  • If you use the Bubble color dimension option, the colors are managed in the dimension value color map.
  • If you use the Bubble color metric option, you can create a color scale by picking maximum, middle, and minimum color values.

Map Controls

Show or hide the interactive map view controls.

Allow pan and zoom Lets viewers adjust the map display with their mouse and keyboard.
Show zoom control Shows the + and — buttons on the map.
Show Street View control Lets users display Street View images for supported locations.
Show fullscreen control Lets users display the map in fullscreen view.
Show map type control Lets users switch between map view and satellite view.
Show scale control Lets users display the map scale in kilometers or miles.

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.

Limits of Google Maps

  • Data can only be shown as bubbles. Google Maps in Data Studio doesn't support displaying data in shaded regions.
  • You can’t interact with Google Maps in Edit mode. You need to switch to View mode.
  • Maximum data limit:
    • 10,000 bubbles for Latitude, Longitude fields.
    • 1,000 bubbles for other geographic field types.
  • The Tooltip and Bubble color dimensions must have a unique value for each value of the Bubble location dimension.
  • You can't enable drill down in Google Maps.
  • Google Maps doesn't support using optional metrics.
  • Google Maps doesn't support complex geospatial data (for example, BigQuery GEOGRAPHY, GeoJSON).
  • Google Maps won't appear in embedded reports.

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?

Need more help?

Sign in for additional support options to quickly solve your issue