On this Page
Docs Menu

Go to Field Parameter List


The map_layer parameter lets you associate a dimension with a TopoJSON map layer. This lets users create map charts by charting the values in the dimension on the map layer. For example, to be able to chart data by US state, you could associate a dimension called “State” to the built-in map layer us_states. You could also chart data in a dimension called “Neighborhood” to a custom map of New York City neighborhoods.

If you are using a custom TopoJSON map, you must specify the map layer in the LookML model using the map_layers parameter.

Built-in Map Layers

Looker includes the following built-in map layers:

  • countries - Accepts full country names, alpha-3 three-letter country codes, and alpha-2 two-letter country codes.

  • uk_postcode_areas - Accepts UK postcode areas (e.g. L for Liverpool, RH for Redhill, or EH for Edinburgh).

  • us_states - Accepts full state names and two-letter state abbreviations.

  • us_counties_fips - Works on string fields that are a five-character FIPS county code for a U.S. county. This layer works only on the interactive map.

  • us_zipcode_tabulation_areas - This layer works on string fields that are a five-character U.S. zipcode. Dimensions of type: zipcode automatically use the us_zipcode_tabulation_areas map layer.

    Note: Zipcode regions are based on the 2010 zip code tabulation areas, so this map layer does not include many zipcodes like P.O. boxes that do not map directly to regions.


- dimension: state map_layer: us_states sql: ${TABLE}.state

Still have questions?
Go to Discourse - or - Email Support