# Map - Extension

## How to Use

### Open GeoJSON Map Extension Dialog

In Viz view, you can click ‘Setup’ button after selecting ‘Map — GeoJSON’ chart type.

![](https://2850417076-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M4HLCK3olgduYoe3RVS%2F-M4oMvCUDQwHTJ0eWi_f%2F-M4oNAulEtJe_0KBnG2K%2Fgeojson4.png?generation=1586795473380183\&alt=media)

### Find GeoJSON Map in Extensions Dialog inside Exploratory

Once you find the one you like, you can click ‘Install’ button, and now you are ready to start using it under Viz tab.

![](https://2850417076-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M4HLCK3olgduYoe3RVS%2F-M4oMvCUDQwHTJ0eWi_f%2F-M4oNAunIYLuagmVH12o%2Fgeojson.png?generation=1586795473540778\&alt=media)

Once you find the one you like, you can click ‘Install’ button, and now you are ready to start using it under Viz tab.

### Choosing a Key Property from GeoJSON

Each GeoJSON file provides a list of the properties that you can use to map with your data the way it works the best.

![](https://2850417076-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M4HLCK3olgduYoe3RVS%2F-M4oMvCUDQwHTJ0eWi_f%2F-M4oNAupvkESDE3X2L99%2Fgeojson2.png?generation=1586795473919818\&alt=media)

### Mapping between GeoJSON’s key property and your data

The example below, I’m using ISO standard country codes found in the data and map them with ‘ISO\_A2’ property of World Map GeoJSON.

![](https://2850417076-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M4HLCK3olgduYoe3RVS%2F-M4oMvCUDQwHTJ0eWi_f%2F-M4oNAurT5n7BD56w5CB%2Fgeojson3.png?generation=1586795473580951\&alt=media)

## How to Create My GeoJSON?

Here's how you can create your own GeoJSON files from existing ESRI Shapefile or other formats using R.

* [Creating GeoJSON out of Shapefile in R](https://blog.exploratory.io/creating-geojson-out-of-shapefile-in-r-40bc0005857d)

## Column Assignments

* Area Type - Select the area type you want to use.
* Key Property - Select the key property that you wan to use in the selected area type.
* Key Column - Assign a column that has the values to bind the key property values.
* Color By - Assign a column for color. If you assign a categorical column, it will be also used as a groupby column. Take a look at [Color](https://docs.exploratory.io/visualization/features/color) section for more details.
* Label - Assign a column you want to show in the balloon help that you see when you hover circles on the map.

## Highlight

You can change the color of the specific reigons that you pick to stand out from others. It is available only when you assgin a categorical column to color. See [Highlight](https://docs.exploratory.io/visualization/features/highlight-1) for the detail.

## Category

You can categorize numeric values inside the chart. See [Category(Binning)](https://docs.exploratory.io/visualization/features/category) for the detail.

## Limit Values

You can use Limit Values to filter the categories by the aggregated values. See [Limit Values](https://docs.exploratory.io/visualization/features/limit) for the detail.

## Custom Function

You can use the Custom Function feature to define your own aggregation function. See [Custom Function](https://github.com/exploratory-io/book/blob/master/viz/custom-function.md) for the detail.

## Show Detail

You can show the detailed data underlying the chart by clicking the chart figure. See [Show Detail](https://docs.exploratory.io/visualization/features/show-detail) for the detail.

## Save as an Image

You can save the chart as an image file. See [Save as PNG/SVG](https://docs.exploratory.io/visualization/features/save) for more details.


---

# 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.exploratory.io/visualization/types/geojson.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.
