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.

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 toolbar, click Add chart icon.Add a chart.
  4. Select one of the preset Google Maps:
    1. Bubble maps show your data as colored circles.
    2. Filled maps show your data as shaded areas.
  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 in Data Studio consist of two layers. The background layer is the familiar Google Map interface. The data layer plots your data on top of the background layer.

You can customize the background layer in many ways. For example, you can change the default map view to satellite view, apply different themes, and adjust the degree of detail of roads, landmarks, and labels shown.

The data layer displays your data as bubbles or as filled areas. You provide a geographic dimension that determines where the data appears. For example, using Country as the location dimension displays a bubble or a filled area for each country in your data. For bubble maps, you can use bubble size, bubble color, or both to communicate metric value. For filled area maps, metric value is communicated using color.


Here's a bubble map showing airline arrivals in California. Number of flights is shown using bubble size. Average arrival delay is shown using bubble color.

Bubble map showing airline arrivals in California. Number of flights is shown using bubble size. Average arrival delay is shown using bubble color.

Here's a filled area map showing median house prices by U.S. ZIP codes in the San Francisco Bay Area.

Filled map showing U.S. ZIP codes in the San Francisco Bay Area.

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


The dimension used to determine the granularity of the data on the map.

Geospatial field

(Optional) The dimension that defines the polygons displayed on a filled map. This option is only available when you connect to a BigQuery data source that contains GEOGRAPHY data.

Click here for a tutorial.

GEOGRAPHY limits and tips
  • A Google Map in Data Studio can plot up to 1 million points (polygon vertices).
    • If your query returns more, the map will show as many polygons as it can within the limit, and you may notice missing polygons.
  • To reduce the number of points:
    • Apply a filter.
      • Filters on a GEOGRAPHY field can select up to 1 GB of data. If your filters return more, you’ll get an error.
    • Simplify the polygons in BigQuery using the ST_SIMPLIFY function.
  • Blended and extracted data sources don’t support GEOGRAPHY fields.
    • To join a table containing your GEOGRAPHY field with another table, perform the join in BigQuery using SQL.


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

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

Can't show Google Maps

The Tooltip dimension has multiple values for the same location. Choose a Tooltip dimension that has a unique value for each location.

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


(Optional) The dimension used to determine the color of the bubbles or filled areas. 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.

Example bubble map.

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

You can instead apply color based on a metric. If you do, you can't use the Dimension section's Color 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.


(Available for bubble maps.) Use the size of the bubbles to convey relative metric values.


Use the color of the bubbles or filled areas to convey relative metric values. If you choose this option, you can't use the Dimension section's Color 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 Universal 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 chart acts like a control. You can filter the report by clicking a bubble or filled area 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.

Layer Type

Shows the location of data on the map, using either bubbles or filled areas.

Bubble Layer / Filled Area Layer

Number of bubbles / Number of filled areas

Sets the maximum number of bubbles or filled areas appearing on the map.

Size slider (Available for bubble maps)

Sets the relative size of the bubbles.


Sets the opacity of the bubbles or filled areas.

Border weight

Sets the thickness of the bubble or filled area borders.


Sets the bubble or filled area colors:

  • If you use the Dimension section's Color option, the colors are managed in the dimension value color map.
  • If you use the Metric sections's Color option, you can create a color scale by picking maximum, middle, minimum, and dataless 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 Add icon. and Remove icon. 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.


Help your viewers understand the map by adding a data legend to your map.

Size legends explain the Size metric in a bubble map. Color legends explain the Color dimension or Color metric in bubble and filled area maps. If your map uses a Color dimension, the Color legend uses distinct colors for each value. If your map uses a Color metric, the legend uses a color gradient.


Sports venue capacity of NCAA team conferences.

Example of a bubble map showing the venue capacity metric using bubble size, and the sports team conference name dimension using bubble color.


Average time on page by region.

Example of a filled area map showing the Average time on page metric using color scale.

  1. Size legend based on the venue capacity metric.
  2. Color legend based on the conference name dimension. Additional conference legends can be viewed by clicking Keyboard arrow right.
  3. Color legend based on the Avg. Time on Page metric.

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

  • Filled area maps don't support Latitude, Longitude or Address geographic field types.
  • For bubble maps, Postal Code can be a U.S. ZIP code (for example, 94043) or an international postal code (example: L4L 9H8). For filled area maps Postal Code can be a U.S. ZIP code.
  • Maximum data limit:
    • 1 million bubbles for Latitude, Longitude fields.
    • 1 million points (polygon vertices) for Geospatial fields (BigQuery GEOGRAPHY).
    • 3,500 bubbles or filled areas for other geographic field types.
      Increasing a map's data limit can make it load more slowly.
  • You can't enable drill down in Google Maps.
  • Google Maps doesn't support using optional metrics.

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?
Clear search
Close search
Google apps
Main menu
Search Help Center