# Geo Heatmap

The Geo Heatmap displays aggregate values by geographic location.

| Features                                                              | Quantity | Notes                                                                                                                                         |
| --------------------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| Required [Dimensions](/immerse/measures-and-dimensions.md#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.md#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**.

<figure><img src="/files/36MLM3jGTIl6OCNTWKQf" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/cSSTA61DZ82refZDSiVZ" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/aHXc4XfKijCqXSuSqa9N" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/9p3vwRjLmIAoBsQecCBT" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/ZUo7E6gPW2YBtXEPn8Pp" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/eozYKCwm9Tftq7R0Se8p" alt=""><figcaption></figcaption></figure>

## 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.md).

## 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.heavy.ai/immerse/immerse-chart-types/geo-heatmap.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.