Notification

This Help Center is moving to Cloud. Learn more about the migration.

Visualize BigQuery GEOGRAPHY polygons with Looker Studio

This tutorial is intended for people who want to visualize GEOGRAPHY data from BigQuery using Looker Studio. To complete this tutorial, you'll need a BigQuery billing project. You don't need to know how to write SQL, and you can use the public dataset.

Goal

In this tutorial, you'll create a report that shows the affordability of rental properties in Washington state. You'll use a Google Map to visualize GEOGRAPHY data coming from a public BigQuery dataset.

A Google map displays red BigQuery geography polygons that represent rent affordability by county in Washington state.

Before you begin

If you don't already have a BigQuery billing project set up, you can sign up for free here.

1 Create a new blank report

  1. Sign in to Looker Studio.
  2. Click The Create icon.  Create and then select Report.
  3. In the Add data to report panel, choose BigQuery.

  1. In the left navigation, choose CUSTOM QUERY.
  2. Select or enter your billing project ID.
  3. Under Enter Custom Query, paste the following SQL query:
select
    ct.state_fips_code,
    ct.county_fips_code,
    c.county_name,
    ct.tract_ce,
    ct.geo_id,
    ct.tract_name,
    ct.lsad_name,
    ct.internal_point_lat,
    ct.internal_point_lon,
    ct.internal_point_geo,
    ct.tract_geom,
    acs.total_pop,
    acs.households,
    acs.male_pop,
    acs.female_pop,
    acs.median_age,
    acs.median_income,
    acs.income_per_capita,
    acs.gini_index,
    acs.owner_occupied_housing_units_median_value,
    acs.median_rent,
    acs.percent_income_spent_on_rent,
from `bigquery-public-data.geo_census_tracts.census_tracts_washington` ct
left join `bigquery-public-data.geo_us_boundaries.counties` c
    on (ct.state_fips_code || ct.county_fips_code) = c.geo_id
left join `bigquery-public-data.census_bureau_acs.censustract_2018_5yr` acs
    on ct.geo_id = acs.geo_id
This query retrieves data from BigQuery Public Datasets about US census tracts in Washington state. A census tract is a relatively small subdivision of a county. The query joins the geospatial data about the census tract boundaries with census statistics, such as population, age, income, and housing costs.

Click Add to add this data to the report.

2Add a Google Map to the report

  1. Delete the table on the report page.
  2. Click Add a chart.
  3. In the Google Maps section, click Filled map.

3Configure the map

A user selects geo_id for the Location field and tract_geom for the Geospatial field in the Data tab of a Google Maps chart Properties panel.
 
The map won't appear yet. You'll need to add the field that uniquely identifies each location first.
 
  1. In the Location section, click Invalid dimension, and then choose geo_id.
    1. This field uniquely identifies each census tract.
  2. In the Geospatial field section, click Add metric, and then choose tract_geom.
    1. This field contains the BigQuery GEOGRAPHY data that defines the polygons that you want to display.

The map should look like this:

A Google map with blue geography polygons representing rent affordability in Washington state by county displays polygons only for a few counties.

Why is the map missing polygons?
 
A Google Map in Looker Studio plots 100 K points (polygon vertices) by default, but the tract_geom column contains 911,364 points. You can increase the number of points (up to a maximum of 1 million) or, to reduce the number of points, you can add a filter to focus on a specific area.
 
In the STYLE tab of the chart properties panel, in the Filled Area Layer section, set the Max number of polygon vertices to 1,000,000.

Add a county filter 

  1. In the toolbar, click Add a control.
  2. Select Drop-down list.
  3. Set the Control field to county_name, and, for Default selection, enter King.
A user selects Drop-down list from the Add a control menu and selects county_name as the Control field with King as the default selection in the Setup tab of the Properties panel.

Now you should see all polygons for King County, which contains Seattle:

A Google Maps chart with blue geography polygons representing rent affordability in Washington state by county filtered to display King County data.

4Style the map

The map's default color metric is Record Count. You can also choose a different metric.

In the Color metric section, choose percent_income_spent_on_rent.

5Interact with the map

Depending on the options that you turned on, you can zoom and pan around and notice census tracts where people spend nearly half their income on rent, such as the University District in Seattle:

6Change the tooltip

As you mouse over the map, you'll notice that the tooltip shows the geo_id, which isn’t particularly meaningful in this context:

A tooltip on the Washington state rent Google Maps chart with a geo_id tooltip dimension displays the data point details 53033005301 percent_income_spent_on_rent: 51.

You can provide viewers with a more useful tooltip by changing the Tooltip dimension.

  1. In the top right, click Edit.
  2. Select the map.
  3. In the Tooltip section, choose lsad_name.
    1. This field contains the human-readable census tract name:
The Setup tab on the Properties panel displays geo_id as the Location field, tract_geom as the Geospatial field, lsad_name as the Tooltip field, and percent_income_spent_on_rent as the Color metric.

7Add more style to the map

You can customize the appearance of the map in the STYLE tab. For example, you could increase the fill opacity to 80% and change the color gradient from blue to red.

Filled Area Layer section options and Colors section options on the Filled Map Style tab.

The final Google map with red gradient geography polygons representing rent affordability in Washington state with the tooltip text Census Tract 295.02 percent_income_spent_on_rent: 47.5 displayed for a data point.

Congratulations!

You've created a Google Map in Looker Studio that visualizes BigQuery GEOGRAPHY data.

Was this helpful?

How can we improve it?
Search
Clear search
Close search
Google apps
Main menu