> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/heavyai/llms.txt.
> For full documentation content, see https://docs.nvidia.com/heavyai/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/heavyai/_mcp/server.

# Geo Heatmap

The Geo Heatmap displays aggregate values by geographic location.

| Features                                                           | Quantity | Notes                                                                                                                                         |
| ------------------------------------------------------------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| Required [Dimensions](/immerse/measures-and-dimensions#dimensions) | 2        | Requires longitude and latitude, or POINT defined by longitude and latitude. OmniSci stores POINT data as longitude first, and then latitude. |
| Required [Measures](/immerse/measures-and-dimensions#measures)     | 1        | Color.                                                                                                                                        |

The Geo Heatmap lets you visually compare information by region.

## Geo Heatmap Examples

Create a new Geo Heatmap. This example uses the **UFO\_Sighted** as the **Data Source**. Set the dimensions to **lon** and **lat**. Set the measure to **COUNT # Records**.

![](https://files.buildwithfern.com/heavyai.docs.buildwithfern.com/heavyai/ebcd40391f5798ccb344d9d5736e21fd9df719b63f1fdde1f20e6910e1b269fd/docs/assets/SS_127.jpg)

**NOTE:** You can also use POINT data (generated from longitude/latitude) for **LON** and **LAT**; for example, **column\_9** contains point data:

![](https://files.buildwithfern.com/heavyai.docs.buildwithfern.com/heavyai/1ed9e07507067fb7365e6ce6c7f6b44bc7cf65938e3a76344dabb2378b26f9da/docs/assets/SS_128.jpg)

When you select data of type POINT, **Lon** and **Lat** are both populated with the values for the point data:

![](https://files.buildwithfern.com/heavyai.docs.buildwithfern.com/heavyai/39ac4c2087bf386b5a286fa9386069b2b4363056e6b377ceffda1a858ed9ed78/docs/assets/SS_129.jpg)

Changing the **Map Theme** from Dark *to Streets* improves the contrast for the street names.

![](https://files.buildwithfern.com/heavyai.docs.buildwithfern.com/heavyai/3e7ac547639e9f8e94836de0cb3ce770c8315206c9bfa9513aaca5b1407e08a8/docs/assets/SS_130.jpg)

The values displayed on the Geo Heatmap are binned aggregate values. You can choose to display the **Bin Shape** as *hexagons* or as *squares*. You can adjust the **Bin Pixel Size** of the markers to a smaller size to increase the granularity of the Geo Heatmap.

![](https://files.buildwithfern.com/heavyai.docs.buildwithfern.com/heavyai/51a3143861d8d1d86a8d49f1e98a14da232d42529e9c882643125b72f7e0d5d5/docs/assets/SS_131.jpg)

You can set the **Color Palette** to tell a more effective story with your data. In this example, setting the palette to gradations of red helps to distinguish between the trees in Wayne National Forest versus the # Records.

![](https://files.buildwithfern.com/heavyai.docs.buildwithfern.com/heavyai/a1d37eef20d9930d65124b6e59d1d4278a97de5778d151d75eded1a919b27a60/docs/assets/SS_132.jpg)

## Multi-layer Geospatial Maps

Pointmap and Geo Heatmap charts can be layered on top of one another to allow visual comparison of datasets. See [Creating Multi-layer Geospatial Charts](/immerse/multilayer-charts).

## Zoom

You can zoom in and out of a Geo Heatmap chart in the following ways:

* Using the mouse scrolling wheel.
* Selecting an area by holding down the Shift key and using the mouse to select the zoom area.
* Using the Zoom To box in the upper right of the map:
  * Type the name of a geographic location (address, city, state, or country) and optional zoom level. For example, **Denver, CO, !8** zooms to Denver, Colorado, with a zoom level of 8.
  * Enter latitude and longitude coordinates, and optional zoom level. For example, **39.26911, -76.54068, !9** takes you to Baltimore, MD, at zoom level 9.