# Point Map

Point maps are a visualization tool designed to effectively represent quantitative data associated with specific geographic locations. 

This visualization is particularly useful for datasets where data points are linked to precise coordinates.

## Building Your Point Map

To create a point map, you must provide the following information:

### <mark style="color:red;">**\***</mark>**&#x20;Location**

* Specify the geographic location of your data points (e.g., city, country, continent).&#x20;
* Once a field is dropped, select its appropriate geographic role from the dropdown menu.

OR

### <mark style="color:red;">**\***</mark>**&#x20;Latitude & Longitude**:&#x20;

Provide the exact coordinates for each location.&#x20;

Drag latitude (y) and longitude (x) fields to define map coordinates.&#x20;

These fields must be of decimal data type and classified as measures.

### **Color by** (Optional)&#x20;

* Use this field to categorize data points using color.&#x20;
* You can apply color based on numeric or categorical data.

### **Size** (Optional)&#x20;

Use this field to represent data points as bubbles of varying sizes. The field should be a measure, and you can use aggregations like COUNT or DISTINCT.

### **Tooltip** (Optional)&#x20;

Add additional fields to display detailed information when hovering over a data point. Multiple fields can be included.

## Formatting Your Point Map

#### **Title**&#x20;

This allows you to give a Title to the Line Chart. You just need to go to the Title section in the Format panel.

You can easily toggle it on or off.  In the "Customize title" modal, you can:

* Modify the title text, font size, and alignment, and even add a background color.&#x20;
* Include an optional description that will appear when hovering over the "i" icon that will be visible as a floating button on the tile.

Once done, click the **Apply** button.

**Map Display Settings**

* Map background style: Choose from Normal, Light, Dark, Street, Outdoors, or Satellite.
* Bubbles: Adjust the size of data points using a slider with values ranging from 1 to 100.

**Colors**

* Case 1: Default color: If no field is assigned to "Color by," you can change the default bubble color using the color picker or predefined color options.
* Case 2: Color by value: Assign the same field to both "Color by" and "Size" to create a color scale based on data values. Customize the color scale using the edit color scale modal.
* Case 3: Color by category: Assign a categorical field to "Color by" to apply distinct colors to different categories. Choose from predefined color palettes or create a custom gradient scale.

#### **Legend**

* This allows you to showcase the chart legend.
* By default it is disabled. But you can easily enable it by clicking on the Show Legend toggle button under the legends section under the format panel.
* Choose from a variety of positions, including top, bottom, left, and right, with options for stacking and centering.&#x20;
* For charts with many legends, you can easily scroll through them.
* Additionally, you can customize the font size, color, family, and style of legend text to match your chart's design.

### **Labels**&#x20;

It allows you to enable/disable the visibility, the appearance & the layout of data labels. By default, it will be disabled. You can turn on the labels using the toggle switch.

{% tabs %}
{% tab title="Global settings" %}

### Global Label Settings

Apply consistent formatting to all labels within a chart.&#x20;

You can customize:

* **Layout**: Position, alignment, overflow, and rotation etc.
* **Content**: Display values, series names, or categories.
* **Appearance**: Font, color, background, and number formatting etc.
  {% endtab %}

{% tab title="Specific Settings" %}

### Specific Label Settings

Tailor labels for individual data points or categories.&#x20;

Ideal for highlighting specific data or creating visual distinctions.

To add specific formatting:

* Add the specific label from the dropdown
* Click on the fields to make them editable and change the values according to your requirements.
* Apply the changes. These changes will override the global settings.

Example: Display percentages as labels for one series, while showing values for another.
{% endtab %}
{% endtabs %}

**Tooltip**

Here all the fields that are added in the build section will be shown.

You can use to checkboxes to choose which fields users want to keep in the tooltip.

<br>


---

# 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.sprinkledata.com/product/analysing-your-data/reports/build-using-tables/visualizations/point-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.