CARTO User Manual

CARTO User Manual

Map settings

Layers

Once your data sources are connected to your map, as explained in this guide, you can use Builder to analyse and discover key insights from your location data. This guide describes how to work with map layers in CARTO Builder.

When opening a map, all added layers for the selected map appear in the left side panel. The layers list appears by default, displaying the basemap and map data layer(s) that are the backbone for your visualization.

The following features are available in the list of layers of your map in Builder:

  • Layers label: layers are provided with a label that is created alphabetically (A, B, C, D). Also each layer is labeled with a unique color to help you distinguish them. Each layer icon displays the geometry type behind the data as either a point, line, polygon, or empty.

Map layers settings

  • Layers order: layers are rendered from bottom to top, with basemaps being the bottom layer. Move the mouse to the left of the layer card and click on the dots that appear to drag a layer and rearrange the hierarchal order of how layers are rendered on your map.

Map layers settings

  • Layer style: click on Layer style to apply custom styling to your layer.

Map layers settings

  • Rename layer: click on Rename to edit the name of the layer.

Map layers settings

Map layers rename

  • Duplicate layer: click on Duplicate layer to create a copy of your layer and to add it to the map.

Map layers settings

  • Show/hide layer: to show/hide the layer in the map.

Map layers show or hide

  • Remove layer: click on Delete layer to remove a layer from the map.

Map layers settings

  • Blend layers: by selecting an option from the dropdown at the bottom of the Layers panel. There are three different ways to blend layers: Normal, Additive, and Subtractive.

Map layers blending

Widgets

This guide describes how to add interactive widgets to your map in CARTO Builder. Widgets are embedded within your visualization and do not modify your original data, they simply allow you to explore your data and get insights by drilling-down different types of filters that are conected to each other and the map’s viewport.

In the Widgets tab of Builder, you will see the list of your current widgets. If you haven’t created a widget yet, you will see the following page:

Map widgets new widget

Click on New widget button to start interacting with your data. When you add a widget, it´s always the Formula widget by default:

Map widgets

Map widgets

You can access the quick actions menu to manage your widgets by clicking on the “three dots” icon in the top-right corner. There are two options available: Rename and Delete widget.

Map widgets

You can also manage your widgets by clicking on the “three dots” icon in the top-right corner of the widget. There are two options available: Widget options and Delete widget.

Map widgets

Click on the top-right icon to show or hide the list of your widgets from the map:

Map widgets

If you click on the Back arrow, you will exist the widget options and you will be redirected to the Widget tab of Builer from where you will see the list of your current widgets.

Map widgets

Click on the “three dots” icon to configure your widgets. There are 3 options available: Widgets options, Rename and Delete widget.

Map widgets

To add a new widget to the map, click on Add widget button and select the data source:

Map widgets

Map widgets

At this moment, there are four types of widgets available to customize your visualization and enable a richer interaction with your data:

  • Formula: Shows aggregated numerical data from the features in the map’s viewport.
  • Category: Breaks down the data into categories and shows aggregated values.
  • Histogram: Shows the frequency distribution across equal bins in the data range.
  • Time-Series: Shows the frequency distribution aggregated by a fixed temporal period (Days, Weeks, Months or Years). It also allows to create animated maps.
  • Table Widget: It shows tabular information of the features in the viewport.

Formula Widget

From Data, choose the operation from the list (COUNT, AVG, MAX, MIN, or SUM) and select a field from your source dataset that you want to analyze.

Map widgets

From Display options, you can also change the format as the values are displayed and add some notes to your widget. In this example, we aggregate the data by the average total of revenue based on the revenue column.

Map widgets

Category Widget

From Data, choose the operation from the list and select a field from your dataset that you want to analyze.

Map widgets

From Display options, you can also change the format as the values are displayed and add some notes to your histagram. In this example, we aggregate the average revenue on each category from the storetype column.

Map widgets

You can select one or more values from a category widget to highlight particular columns of interest. If you select an element from the list, only the selected filters appear styled on your map, and the rest of the categories are temporarily removed from your visualization.

Map widgets

Click on the same filters again to deselect them, or click on Clear to show all relevant categories from the widget again. You can also Lock and Unlock to enable or disable the interactivity with the map.

Map widgets

The Category widgets display the top five categories of data, based on the Map View of your visualization. The Other category groups together the less relevant values that may not be visible from your Map View.

You can manually search for values from the Othercategory by clicking on Search in “X” elements, or you can modify the order of how values appear in the category widget. As you zoom or pan the map, the category widget filters change. By doing this, it can help you re-evaluate how your Map View should appear.

Click on Search in “X” elements and then click the box next to the other value(s) to be included. You can type a value, or search through the list of available values.Then click Apply to filter the category widget by the selected values, or Cancel if you don’t want the filters to be applied.

Map widgets

You can Unlock to view the default categories again.

Map widgets

Histogram Widget

From Data, select a field from your source dataset that you want to analyze. In this example, we divide the data range of the size_m2 column in 9 buckets. The histogram widget displays the number of records in each bucket, allowing you to select and visualize a specific range of data.

Map widgets

When hovering over a Histogram widget, the number of records in each bucket appears. This is a good indicator of where you might want to filter data.

Map widgets

Click once on the Histogram to display the range selector. Only the selected filters appear on your map, and any analyses are rerun and recalculated.

Map widgets

For advanced analysis, you can all widgets in a single map so you can combine your filters and get a better visualisation of your data:

Map widgets

Map widgets

Time-Series Widget

From Data, choose the operation from the list and select a field from your source dataset that you want to analyze. The selected column for the widget must be of type date, and you can define how the date is aggregated (by Years, Months, Weeks, Days) to visualize a selected range of time.

In this example, we aggregate the data range of the time column by months. The histogram widget displays the number of earthquakes in each month over time, allowing you to select and visualize a specific range of data.

Map widgets time-series

From the widget, you can play, pause or stop the animation and filter by a selected range of values. To activate the animation, toggle on Animation controls.

Map widgets time-series animation control

Map widgets time-series animation controls activated

To change the speed of the animation, click on the clock icon and select the speed: 0.5x, 1x, 2x or 3x.

Map widgets time-series clock icon

You can also filter your data within a given range. The selected range is distributed across your map to display groups of data aggregated by the selected date type.

Map widgets time-series filter

This enables you to click and drag the start and end range of selected data. In this example, we add a second widget to display the number of earthquakes filtered in each range.

Map widgets time-series filter

Table Widget

From Data, select the columns from your source dataset for which you want to display the tabular information. In this example, we select all columns.

Map widgets table

From the widget, you can select the number of rows per page and use pagination to visualize the rest of the results.

Map widgets table rows and pagination

You can also sort the data in ascending or descending order. To activate the sorting option, hover the mouse over the columns and select the ascending (up arrow) or descending (down arrow) option.

Map widgets table ascending order

Map widgets table descending order

Interactions

This guide describes how to add interactions to your map in CARTO Builder.

Map interactions

Tooltip

The tooltip is an info window that appears when you hover your mouse over a map feature. You can customize the content of the tooltip by defining the source columns and the formatting. By default the tooltip is activated.

Map interactions

The comparison mode helps you to compare numeric values between two different features on the map through the tooltips. The results can be compared in absolute or relative values. You can change it from the comparison type option.

Map interactions

Activate the comparison mode and then click on a map feature. The tooltip will stays fixed. Then, hover the mouse over another feature without clicking it.

Map interactions

In this example, the tooltip on the right (Primary) remains fixed (until you click on another area of the map).The tooltip on the left is the feature you want to compare with. The number in green is the difference between both parameters. In this case, the column cartodb_id in absolute values.

Coordinates

It shows the coordinates where you click with the mouse. The coordinates will appear in the tooltip, so you need to activate the tooltip first.

Map interactions coordinates

Legend

Legends help you to describe your data on the map and they are a essential for understanding geospatial data visualizations. This guide describes how to add and configure a legend to your map in CARTO Builder.

In the Legend tab of Builder, you will see the list of your current legends. If you haven’t added any layer yet, you will see the following page:

Map widgets new widget

Once your data is added as a layer to the map, as explained in this guide, the legend is automatically generated and it is displayed in a fixed position at the bottom left of the map.

When choosing a style based on a property on your data (check this section for more information about it), a legend will be automatically generated based on the type of visualization:

  • Discrete color bins for categories and quantile data classifications.
  • Continuous color ramps for quantize classifications.
  • Proportional symbols for point radius.

By default, the legend is collapsed so you need to click on the layers icon to expand it.

Map legend

Map legend

From the Legend tab, you can manage the visibility of the legends and change the text of the labels. Click on Remove from legend to not show the legend of a specific layer or click on the default layer name to change the text label.

Map legend

Map legend

You can always revert to the default name by clicking on Revert overrides.

Map legend

From “More legend options” you can manage the visibility of each layer and how the layers panel is displayed on the map. By activating “Layer selector”, you will be able to control the visibility of layers from the layer panel, and by activating “Open when loading the map”, you will be able to display the layer panel expanded by default when loading the map.

Map legend

You can also select different style options from the Layer style panel to enable different types of legends that can be managed through the Legend tab.

In this example, we style the layer based on the column store_type. The legend shows a symbol and a label per category that we can edit from the Legend Tab.

Map legend

You can also add other properties to the legend, such as the radius of the point based on a column. In this example, we show the radius of the stores based on the column revenue.

Map legend

Basemaps

Basemaps are image tiles that are used to render the graphical representation of your map background. Basemaps include the natural and cultural features of the world; such as water bodies, topography, park areas, terrains, roads, streets, and sometimes buildings.

The CARTO Builder provides a set of CARTO and Google Maps basemaps styles as background maps. By default, basemaps are projected using the Webmercator projection. To setup your map’s base map, open the Base Map panel to select from a list of default map styles.

CARTO

Select CARTO in the menu to see different basemap options. They include:

  • Voyager: basemap with colors to clearly differentiate natural and cultural features. This basemap is showed by default when creating a new map.
  • Positron: light basemap with dark-colored text.
  • Dark: dark basemap with light-colored text.

Map basemap carto

You can manage the CARTO basemaps layers to hide and show water, buildings, roads, and more. Options include:

  • Labels: shows labels for cities, neighborhoods, and so on.
  • Roads: displays a translucent layer of road lines.
  • Borders: shows state and continent borders.
  • Buildings: shows building footprints.
  • Water: displays bodies of water.
  • Land: Shows parks, mountains, and other landscape features.

Basemap layers

Google Maps

Select Google Maps in the menu to see different basemap options. They include:

  • Roadmap: displays the default road map view.
  • Satellite: displays Google Earth satellite images.
  • Hybrid: displays a mixture of normal and satellite views.
  • Terrain: displays a physical map based on terrain information.
  • Positron, Voyager and Dark Matter: new versions that has been developed for Google Maps.

Map basemap google

Amazon Location

Select Amazon Location in the menu to see the options to use a base map from the Amazon Location Service.

To use an Amazon Location maps, you will need to introduce some credentials from your Amazon Location Service account. Lear more about it in this guide:

  • Cognito Pool ID: Amazon Cognito provides authentication, authorization, and user management for web and mobile apps. You can use Amazon Cognito unauthenticated identity pools with Amazon Location as a way for applications to retrieve temporary, scoped-down AWS credentials. Learn more about how to get a Cognito Pool ID here.

  • Map name: The name of the map style from your Maps home page in your AWS console.

Map basemap amazon

Once you have set the credentials, click on Apply. The current configuration will be saved in this map.

To use another base map from Amazon Location, specify the new credentials and click Apply again. The map will be updated and saved.