Text of docs.cloud.google.com › data-studio › google-maps-reference as Styx crawled it on Nov 19, 2026. The page may have changed since. Only its words are kept, without pictures or layout, and only the first part of a long page.

Open the live page

Google Maps reference | Data Studio | Google Cloud Documentation

Skip to main content Console English Deutsch Español Español – América Latina Français Indonesia Italiano Português Português – Brasil עברית 中文 – 简体 中文 – 繁體 日本語 한국어 Sign in Data Studio Start free Looker Studio is now called Data Studio. Learn more about this change . Home Documentation Data analytics Data Studio Guides Google Maps reference Stay organized with collections Save and categorize content based on your preferences.

Adding Google Maps to your reports gives your viewers a familiar interactive environment where they can explore geographic data. Google Maps in Data Studio are highly customizable and integrate with any data source that contains valid geo fields. Before you begin To add Google Maps to Data Studio, you'll need a data source with one or more geographic dimensions. Data sources that are based on Google Analytics and Google Ads automatically include fields that you can use, such as Country , City , Region , Metro area , and Store location .

For other data source types, such as Google Sheets or BigQuery, make sure that any geographic fields have the correctly assigned data type. To edit the geographic dimensions in your data source, follow these steps: Edit the data source . Locate the geographic dimension(s) that you want to use in Google Maps. Use the Type menu to select the appropriate Geo field type — for example, Country , City , or Region . To learn more about geo dimensions, see the Geo dimension reference .

Tips and limits for working with BigQuery GEOGRAPHY data Each Google Maps style in Data Studio can plot up to 1 million points (polygon vertices). If your query returns more data, 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, follow these steps: 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 by using the ST_SIMPLIFY function. Blended and extracted data sources don't support GEOGRAPHY fields. To join a table that contains your GEOGRAPHY field with another table, use SQL to perform the join in BigQuery. Geo functions Data Studio provides a number of geographic functions that you use 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.

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 US ZIP code (for example, 94043) or an international postal code (example: L4L 9H8). For filled area maps, Postal Code can be a US ZIP code. Connection maps require points that have compatible geographic field types. Maximum data limits are as follows: 1 million bubbles for Latitude or Longitude fields 1 million points (polygon vertices) for Geospatial fields (BigQuery GEOGRAPHY ) 3,500 bubbles or filled areas for other geographic field types You can't enable drill down in Google Maps.

Google Maps doesn't support using optional metrics. Location names longer than 500 characters won't be geocoded. Plot your data with Google Maps To visualize your data on a Google Map, follow these steps: Edit your report . Navigate to the page that will contain the chart. In the toolbar, click Add a chart . Select one of the preset Google Maps : Bubble maps show your data as colored circles. Filled maps show your data as shaded areas.

Heatmaps show your data using a color gradient. Line maps show your data as lines or paths over a geographic area. Connection maps show your data as pairs of points that are connected by a line or an arc. Combo maps show your data as a combination of a filled map and a bubble map. Click the canvas to add the chart to the report. Use the settings in the Properties panel to add or change the Location or Geospatial field so that your map displays the intended locations.

Refer to the following sections for information on configuring the rest of your map. Configure a bubble map Bubble maps depict your data as colored circles, or bubbles. Here's a bubble map that shows airline arrivals in California, where the quantity of flights (the Flights dimension) is represented by bubble size and the average arrival delay (the Avg. Arrival Delay metric) is represented by bubble color: Setup properties The following setup properties are available for bubble maps.

Data source A data source provides the connection between the component and the underlying dataset. To change the chart's data source, click the current data source name. To view or edit the data source, click the Edit data source icon. (You must have at least Viewer permission to see this icon.) Click Blend data to see data from multiple data sources in the same chart. Learn more about data blending . Fields Configure the options in the Fields section to set up the map chart data.

Location The Location field requires a dimension that determines where the data appears on the map. Note that this field can be of any data type, as long as Google Maps can geocode the values appropriately. Tooltip (Optional) The Tooltip field requires a dimension that provides tooltips (labels) for the data. Providing a tooltip lets you override the default label that is provided by the Location dimension. For example, you can base the map location on a store's address but use the store's name in the tooltip.

The Tooltip option requires unique values for each Location value. If the Tooltip values are duplicated, you'll see an error message: Warning: 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. To fix this error, use a dimension that has a 1:1 relationship with your Location dimension. Color dimension (Optional) A dimension that provides the categories that are used for the color of the geo data.

If you choose this option, you can't use the Color metric option. The Color dimension option requires unique values for each Location value. If the Color dimension values are duplicated, you'll see an error message: Warning: Can't show Google Maps The Color dimension has multiple values for the same location. Choose a Color dimension that has a unique value for each location. To fix this error, use a dimension that has a 1:1 relationship with your Location dimension.

Size Use the size of the bubbles to convey relative metric values. Color metric (Optional) The Color metric field requires a metric that provides the values that are used as a color scale for the geo data. If you choose this option, you can't use the Color dimension option. Filter Filters restrict the data that is displayed in the component by including or excluding the values that you specify. Learn more about the filter property .

Filter options include the following: Filter name: Click an existing filter to edit it. Mouse over the filter name and click X to delete it. Add filter: Click this option to create a new filter for the chart. 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 that is 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 timeframe.

Default date range filter The default date range filter lets you set a timeframe for an individual chart. Default date range filter options include the following: Auto: Uses the default date range, which is determined by the chart's data source. Custom: Lets you use the calendar widget to select a custom date range for the chart. Chart interactions When the Cross-filtering option is enabled on a chart, that chart acts like a filter control.

You can filter the report by clicking or brushing your mouse

The rest of this page is on the live site.