> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omni.co/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.omni.co/feedback

```json
{
  "path": "/visualize-present/visualizations/types/map",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# Maps

> Omni currently supports point and region map types.

## Point maps

Data with latitude-longitude pairs can be visualized as a point map. Points can be sized and colored by additional properties in the dataset.

**Map with Color Pins**

<img src="https://mintcdn.com/omni-e7402367/K4oAdi8TCvG1dpiF/images/docs/visualization-and-dashboards/visualization-types/assets/images/color-map-45a4d9aa4558d893ed060dced4455b9f.png?fit=max&auto=format&n=K4oAdi8TCvG1dpiF&q=85&s=91b4f51bbfc9c2e3a1cc364592740c86" alt="" width="1405" height="805" data-path="images/docs/visualization-and-dashboards/visualization-types/assets/images/color-map-45a4d9aa4558d893ed060dced4455b9f.png" />

**Map with Sized Pins:**

<img src="https://mintcdn.com/omni-e7402367/aZ84MHc8H0bDix_i/images/docs/visualization-and-dashboards/visualization-types/assets/images/size-map-d4751c2fa30bb6857092e4938c4d8c0b.png?fit=max&auto=format&n=aZ84MHc8H0bDix_i&q=85&s=2c17418edb8443f126f5643d6af85fe6" alt="" width="1406" height="705" data-path="images/docs/visualization-and-dashboards/visualization-types/assets/images/size-map-d4751c2fa30bb6857092e4938c4d8c0b.png" />

## Region maps

Data with region-based location information can be visualized as a region map. Omni offers region-based mappings for countries and US states out of the box, and offers a custom region option for greater flexibility.

### Built-in countries

Country region data can be mapped against your dataset by either country name, 2-digit country code or 3-digit country code.

| Dataset                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Map                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <img src="https://mintcdn.com/omni-e7402367/K4oAdi8TCvG1dpiF/images/docs/visualization-and-dashboards/visualization-types/assets/images/country-dataset-a835db36529143dca59ba6fabdc27522.png?fit=max&auto=format&n=K4oAdi8TCvG1dpiF&q=85&s=4080ebeedcbee48b370ab985096ef5be" alt="" width="349" height="411" data-path="images/docs/visualization-and-dashboards/visualization-types/assets/images/country-dataset-a835db36529143dca59ba6fabdc27522.png" /> | <img src="https://mintcdn.com/omni-e7402367/K4oAdi8TCvG1dpiF/images/docs/visualization-and-dashboards/visualization-types/assets/images/country-map-be93402bf8276a54b629604a7a7be621.png?fit=max&auto=format&n=K4oAdi8TCvG1dpiF&q=85&s=f2f2b73d8aa231db11779d184360a6f7" alt="" width="1409" height="821" data-path="images/docs/visualization-and-dashboards/visualization-types/assets/images/country-map-be93402bf8276a54b629604a7a7be621.png" /> |

### Built-in US States

US state region data can be mapped against your dataset by either name or 2-digit code.

| Dataset                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Map                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <img src="https://mintcdn.com/omni-e7402367/aZ84MHc8H0bDix_i/images/docs/visualization-and-dashboards/visualization-types/assets/images/state-dataset-054d35fd1dfa3866c4c26b085b286bcb.png?fit=max&auto=format&n=aZ84MHc8H0bDix_i&q=85&s=d7e457b87ac272bc2858aad28d6423df" alt="" width="349" height="435" data-path="images/docs/visualization-and-dashboards/visualization-types/assets/images/state-dataset-054d35fd1dfa3866c4c26b085b286bcb.png" /> | <img src="https://mintcdn.com/omni-e7402367/aZ84MHc8H0bDix_i/images/docs/visualization-and-dashboards/visualization-types/assets/images/state-map-bc1a20d6eedde0965ab2933d328fb172.png?fit=max&auto=format&n=aZ84MHc8H0bDix_i&q=85&s=78c134261ec094b0b52c81a6af0f0c1f" alt="" width="1406" height="820" data-path="images/docs/visualization-and-dashboards/visualization-types/assets/images/state-map-bc1a20d6eedde0965ab2933d328fb172.png" /> |

### Custom Regions

Omni allows you to specify your own region data via URL. You can specify an endpoint that returns region data complying to either the [GeoJSON](https://datatracker.ietf.org/doc/html/rfc7946) or [TileJSON](https://github.com/mapbox/tilejson-spec/blob/84008d750e54f37739e24785276596f40ccafeab/3.0.0/README.md) specifications.

In order to use custom regions, you'll need to set your region type to "Custom" and then fill out the following fields:

* **Source type** - specify whether your region source is GeoJSON or TileJSON
* **Source URL** - the URL from which to load your GeoJSON or TileJSON data
* **Source layer** (TileJSON only) - the layer within the TileJSON specification you want to map against
* **Region property** - the property in the GeoJSON or TileJSON data that you want to map against

| Dataset                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Map                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <img src="https://mintcdn.com/omni-e7402367/K4oAdi8TCvG1dpiF/images/docs/visualization-and-dashboards/visualization-types/assets/images/custom-dataset-ff2ea8e3e4b0830c9405a2b6cb408843.png?fit=max&auto=format&n=K4oAdi8TCvG1dpiF&q=85&s=25e426c4bb5da987ea9fea3d42cf02a2" alt="" width="348" height="435" data-path="images/docs/visualization-and-dashboards/visualization-types/assets/images/custom-dataset-ff2ea8e3e4b0830c9405a2b6cb408843.png" /> | <img src="https://mintcdn.com/omni-e7402367/K4oAdi8TCvG1dpiF/images/docs/visualization-and-dashboards/visualization-types/assets/images/custom-map-8d428c0a6949f3d38ed922af5ec5345b.png?fit=max&auto=format&n=K4oAdi8TCvG1dpiF&q=85&s=f96ee44353916eb66b47fbea0f76cf3b" alt="" width="1409" height="807" data-path="images/docs/visualization-and-dashboards/visualization-types/assets/images/custom-map-8d428c0a6949f3d38ed922af5ec5345b.png" /> |

## Projection types

Point and region maps support 2D (mercator) and 3D (globe) projections.

| 2D (Mercator)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 3D (Globe)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <img src="https://mintcdn.com/omni-e7402367/K4oAdi8TCvG1dpiF/images/docs/visualization-and-dashboards/visualization-types/assets/images/map-projection-2d-78be3e83bfedeb716da9829c6a10ef96.png?fit=max&auto=format&n=K4oAdi8TCvG1dpiF&q=85&s=f20b1f51d06e73982ad295be2d3a62dc" alt="" width="1400" height="791" data-path="images/docs/visualization-and-dashboards/visualization-types/assets/images/map-projection-2d-78be3e83bfedeb716da9829c6a10ef96.png" /> | <img src="https://mintcdn.com/omni-e7402367/K4oAdi8TCvG1dpiF/images/docs/visualization-and-dashboards/visualization-types/assets/images/map-projection-3d-3567c222135fc928c7a572abdae3efdb.png?fit=max&auto=format&n=K4oAdi8TCvG1dpiF&q=85&s=25bf19e8b792a6762065f00c6bf26ecc" alt="" width="1400" height="790" data-path="images/docs/visualization-and-dashboards/visualization-types/assets/images/map-projection-3d-3567c222135fc928c7a572abdae3efdb.png" /> |

Point maps also support heatmap projections:

<img src="https://mintcdn.com/omni-e7402367/K4oAdi8TCvG1dpiF/images/docs/visualization-and-dashboards/visualization-types/assets/images/map-heatmap-c474bdaac0448d5c25777dd6453e17ed.png?fit=max&auto=format&n=K4oAdi8TCvG1dpiF&q=85&s=04181a4594bd9ff4f43273cd33cf56fc" alt="" width="802" height="606" data-path="images/docs/visualization-and-dashboards/visualization-types/assets/images/map-heatmap-c474bdaac0448d5c25777dd6453e17ed.png" />

## Custom visualizations

More complex map visualizations can be unlocked using [advanced visualization](/visualize-present/visualizations/types/custom).
