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.
- 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.
- Layer style: click on Layer style to apply custom styling to your layer.
- Rename layer: click on Rename to edit the name of the layer.
- Duplicate layer: click on Duplicate layer to create a copy of your layer and to add it to the map.
- Show/hide layer: to show/hide the layer in the map.
- Remove layer: click on Delete layer to remove a layer from the map.
- 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.
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:
Click on New widget button to start interacting with your data. When you add a widget, it´s always the Formula widget by default:
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.
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.
Click on the top-right icon to show or hide the list of your widgets from the map:
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.
Click on the “three dots” icon to configure your widgets. There are 3 options available: Widgets options, Rename and Delete widget.
To add a new widget to the map, click on Add widget button and select the data source:
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.
From Data, choose the operation from the list (
SUM) and select a field from your source dataset that you want to analyze.
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
From Data, choose the operation from the list and select a field from your dataset that you want to analyze.
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
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.
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.
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.
You can Unlock to view the default categories again.
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.
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.
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.
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:
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.
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.
To change the speed of the animation, click on the clock icon and select the speed: 0.5x, 1x, 2x or 3x.
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.
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.
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.
From the widget, you can select the number of rows per page and use pagination to visualize the rest of the results.
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.
This guide describes how to add interactions to your map in CARTO Builder.
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.
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.
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.
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.
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.
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:
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.
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.
You can always revert to the default name by clicking on Revert overrides.
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.
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.
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
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.
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.
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.
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.
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.
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.