# Map

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

A prerequisite for placing a map on a dashboard is that [the map is already available ](/tools/map-editor.md)in Gaio, whether it is an imported map (GeoJson) or a manually created map.

Another fundamental point, is that the table containing the data to be printed on the map, needs to have a geography column in the format that the map expects. For example, the map is by State and expects the name of the State in two letters (SP, RJ, MG). So, the table that we are going to deliver to the map must have a column in this format.

{% hint style="warning" %}
This task can only be used when a **table is selected** in the flow.️
{% endhint %}

***

## **How to Use**

***

### **1. Add the Map to the Flow**

* In the **Studio**, go to the **Tasks** panel.
* Under the **Delivery** section, select **Maps**.

***

### 2. Choose the Base Map

* In the left panel, select the **Maps** option with the desired geographic area.
  * Example: `Brazil`

***

### 3. GeoJSON Options

* Set the geographic reference field used in your GeoJSON.
  * Example: `UF` (state code)

***

### 4. Link Your Data (Link table fields)

* Select the field from your dataset that matches the GeoJSON key.
  * Example: if the GeoJSON uses UF codes, select `CODESUF` from your table.

***

### 5. Choose the Data Field (Fields)

* This will be the numerical field displayed on the map.
  * Example: MARGEM\_BRUTA2

***

### 6. Select the Visualization Mode (Mode type)

* Available options:
  * Distribution: colors regions based on numerical value ranges.
  * Range: in this option the analyst defines criteria and color if the criterion is met.

***

### 7. Adjust Opacity

* Define how transparent or solid the fill colors will be on the map.

***

### 8. Set the Color Palette

* Choose up to **five colors** to represent value ranges:
  * `First color`: for lowest values (e.g., dark green)
  * `Fifth color`: for highest values (e.g., red)

***

### &#x20;Pro tips

* Use cool colors (green/blue) to indicate **positive performance** or **low risk**.
* Use warm colors (yellow/red) to show **warnings**, **high risk**, or **critical zones**.
* Combine with filters to make the map respond to selections from dashboards or forms.

{% hint style="warning" %}
It is on this screen that the map zoom is defined. Adjust here and it will be reflected on the dashboard.
{% endhint %}


---

# 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.gaiodataos.com/tools/tasks/delivery/map.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.