Adding a map with points or shapes in Studio

Studio makes it easy to create maps with points or shapes, as well as choropleth maps.

Maps with points or shapes highlight specific locations or areas. They are well suited to showing localized information—such as shops, monuments, or hotels—or broader geographic zones like regions or states.

To create a map with points or shapes in Studio, create or edit a block, select the block type "Map" and "Points & shapes" as the map type.

Tip: Instead of using the Next button, you can double click on a card to select it and move on to the next step.

1. Select a basemap from those configured in the back office. To edit available basemaps, see Configuring data visualizations.

2. Select the desired dataset. A preview of the first 20 records opens in the preview pane.

   

Note that the map automatically adjusts its bounding box so that all elements are visible.

During this step, don't forget that you can refine the visible data on the map (See Refining data).

3. Depending on what is available in the dataset, you may need to specify which field to use. If only one valid geographical field is detected, that one will be selected automatically.

   

You can customize the label and color used for the points on your map, as well as choose an icon for their appearance. Similarly, you can customize shapes' label, color, and opacity.

1. Select the type of popup : Tooltip (above the marker) or Sidebar panel (top left of the map).

2. Pick the layout of information you want to display.

3. Then select the fields that should be used to fill this layout.

The popup is showed when a feature is clicked in the map.

1. Change the layout by clicking on Information layout and selecting a different one.

2. Fill required fields to complete the block configuration.

Click Finish when you're done configuring your map. Your map will be visible in the preview pane. Verify the configuration you've chosen and click Save.

We do not recommend using fields with more than one value to style your location makers. By default, Studio automatically uses the first value from a multi-value field to style the marker.

However, this not may be what you need. For example, imagine that you've defined the style for two location marker values: "fruits" and "vegetables." A point of interest with more than one value, such as "fruits, vegetables", will inherit its style from the "fruits" style definition. Conversely, a point of interest with the value "vegetables, fruits" will derive its style from the "vegetables" style maker definition.

So if the default behavior isn't what you need, you can create a new column using processors to extract the relevant value. This approach allows you to have more control over the styling process.