home User Guide Getting Started Help Center Documentation Community Training Certification
menu
close
settings
Looker keyboard_arrow_down
language keyboard_arrow_down
English
Français
Deutsch
日本語
search
print
Looker documentation will be moving to cloud.google.com in mid-2022!
All the information you rely on will be migrated and all docs.looker.com URLs will be redirected to the appropriate page.
Map chart options

Map charts let you visualize geographic data on responsive and interactive maps, and provide significant control over the way that map points are plotted.

Building an interactive map chart

To create a map chart, your query must include at least one of the following fields:

Limit the precision of latitude and longitude data coordinates to no more than five to six decimal places. If coordinates exceed seven decimal places, then the map will not display any data points.

To build an interactive map chart, select the Map visualization type in the Visualization bar. You can also edit your map visualization in the visualization menu. Click the gear in the upper right corner of the Visualization bar.

Options listed below may be grayed out or hidden if they conflict with other settings that you have chosen.

Plot menu options

The Plot tab lets you select the way that your location data is plotted. Each choice has slightly different formatting options, as appropriate for the plot type. Plot options also differ depending on whether a map layer is defined in the LookML for your dimension.

For dimensions that are not associated with a map layer, the following Plot options are supported: Zip code dimensions automatically have a US zip code map layer assigned. For other dimensions that have a defined map layer, you will see this set of Plot options displays:

Points

You can plot each row in an underlying data table as a discrete point on the map.

A location dimension by itself will place points of uniform size and color. Adding a measure to the underlying data table enables the points to be scaled by color or size.

Automagic Heatmap

You can display data in the underlying query as a heatmap grid. It works by dividing the visible map into equal squares, then calculating which values in your data fit into each square. The squares are colored according to a measure that you choose. Zooming this map in or out will prompt Looker to re-calculate the grid, so that the granularity is appropriate to the zoom level.

For this plot type to work properly, you must select both a location dimension and a measure.

The Automagic Heatmap will re-query your data to construct the heatmap grid. A location dimension will typically show distinct points with one latitude/longitude coordinate, but while using a heatmap, the dimension changes to the bounding boxes ("Heatmap region from ... to ..") of each square in the grid.

Connect with Lines

The Connect with Lines map visualization takes two fields of type:location from your query, then connects them together in the visualization. Adding a measure to the query lets you add a color scale to the lines.

Connect with Areas

The Connect with Areas map visualization takes one field of type:location and connects all the points in the order that you've sorted them, forming the boundaries of an area on the map. Adding a measure to the query lets you format the size and color of the individual location points bounding the area.

Heatmap Gridlines

For heatmap visualizations, you can add a border around each of the gridlines used for the heatmap.

Heatmap Opacity

For heatmap visualizations, you can specify the opacity of the colors used in the heatmap. Type a number between 0 and 1, where 0 means no color and 1 means totally opaque.

Gridlines on Empty Regions

If the Heatmap Gridlines option is turned on, and you are plotting a dimension that has a defined map_layer_name, you can toggle on Gridlines on Empty Regions to display an outline around the map regions that have no associated data. This example shows a heatmap visualization with Gridlines on Empty Regions turned off (left image) and with it turned on (right image).

Map menu options

Map Style


Map styles clockwise from top left: Light (No Labels), Dark, Traffic (Day), Satellite

Map Style lets users change the type of background map, and whether map labels (like cities and streets) should be displayed. This option features a drop-down menu with a list of choices:

Map Position

You can change the center point and zoom level of a visible map:

Not available with the Automagic Heatmap plot type

Map Scale Indicator

You can determine whether a map scale will show and the units to display:

Allow Panning

You can determine whether users can reposition the map by dragging it. This feature is allowed by default.

Allow Zooming

You can decide if a (+/-) button should display in the upper left of the map visualization, allowing users to zoom in and out. This feature is on by default.

Show Full Field Name

You can determine whether to show the view name along with the field name in map tooltips, which display when users click on map data points.

Show Legend

You can determine whether a map legend displays in the lower right of a visualization. The legend shows the color scale that you are using, if you've added a measure to your visualization.

The Show Legend option is available for the following Plot options:

Show Region Field in Tooltip

You can display the region information in the tooltip of the map. Click on a point in the map to see the name of the region:

If your Looker developer has defined drilling options for the dimension, you can click the region name to drill further into the data:

Tooltips on map charts look and function slightly differently when viewed on dashboards using the new dashboard experience. For more information, see the Viewing map charts in the new dashboard experience section on this page.

Draw Map Labels Above Data

You can display the map's labels above or below the heatmap. This is significant with higher heatmap opacity values. If your heatmap is opaque, the labels will not show unless they display above the data:

Points menu options

Not available with the Automagic Heatmap plot type

Type


Point types clockwise from top left: Circle, Icon, Both, None

For maps of plot type Points, Lines, and Area, Type specifies the type of point displayed on the map visualization:

Your point type selectionn impacts the formatting options that are available. The example above shows the options for a Type of Both, which includes all options.

Icon

You can choose an icon to display on all map markers (they cannot be dynamic according to your data).

Radius

If you used a Type of Circle, you can set the size of that circle:

Radius Units

You can set the units that are used in the Radius section to meters or pixels.

Marker Color Value

You can set the color of the map markers in an interactive map:

Value menu options

The Value menu disappears if the Marker Color Value for map points chart is set to “Custom”

Value Colors

You can set the color of map points or define the range of colors to be used if you are color coding according to a measure.

You can input a list of hex strings, such as #2ca6cd, or CSS color names, such as mediumblue. The colors you input first are associated with the lowest values.

Quantize Colors

When turned on, Quantize Colors changes the color scale from a smooth gradient to only the specific colors you've set.

The image on the left depicts the legend when Quantize Colors is off, and the image on the right depicts the legend when Quantize Colors is turned on:

Reverse Color Scale

When turned on, Reverse Color Scale switches the colors that indicate high and low values on the chart, reversing the color gradient.

The image on the left depicts a chart with low values indicated by green, and high values indicated by red. The image on the right depicts the same chart with Reverse Color Scale turned on:

Minimum Value/Maximum Value

You can set the minimum and maximum values of the color range. This lets you color code all points below a certain threshold with the lowest color and all points above a certain threshold with the highest color.

By default this field is left blank, and the minimum and maximum values applied on the legend are the minimum and maximum values from your query.

Viewing map charts in the new dashboard experience

When you view map charts in Looker’s new dashboard experience, tooltips function slightly differently than they do when you view map charts as Looks, as Explores, or in legacy dashboard tiles:

In the new dashboard experience, the tooltips appear on hover, rather than on click. Viewers of a dashboard can see content placed in a tooltip with the html parameter, but if any interactive content is included as part of the html parameter — such as links — viewers cannot click on it.

If you click Explore from Here on a map chart dashboard tile, or if you open the edit window for a map chart tile, you will see the Look and Explore version of the map chart.

Top