Map Charts

Map charts let you display a dataset containing geographic features on a world map.

The Map charts build visualizations based a required Geo column, whose values can be geographic points or geometries.

Chart Layouts


  • The Scatter Map layout plots a point at each individual geopoint. It allows you to add optional Color and Size columns that change the color and size of the points based upon the column values. The Size column must be numeric, but the Color column can be text or numeric.

  • The Geometry Map layout works best with geometries, but will work with geopoints, in which case it is like a Scatter Map with no Size column.



The Density Map layout displays the density of geopoints taking into accounts their spatial proximity and an optional quantitative metric.

The following parameters can be tuned:

  • Details: Optional quantitative column of the input dataset used as an additional point weight based on its value in the column.

  • Intensity (global for all points): A global parameter used as a multiplier for the weights of the points. Setting a high intensity will result in a less transparent chart.

  • Radius (global for all points): A global parameter setting the radius of each point, a higher radius will result in more overlapping between points and higher intensity in high density zones.



The Grid Map layout plots the geographic locations as rectangular grids on the map. It allows you to add an optional Color column that changes the color of the points based upon the column values. The Color column can be text or numeric.



Map charts cannot be downloaded as images. To share map charts, publish them to a dashboard or take a screenshot of the map to generate an image of the map chart.



Administrative maps are considered a BETA feature. You might encounter issues while using it and we do not guarantee that this feature will keep working the same way in future versions.

To create Administrative maps, you must first install the Reverse Geocoding plugin. See Installing plugins for details.

Administrative maps are aggregated charts: rows in your dataset are aggregated by administrative levels; for example:

  • By country

  • By region

  • By city

You can change the “level of aggregation” by opening the settings of the Geo column.


Two kinds of Administrative maps are available:

  • In the Bubbles layout, each administrative level is represented by a circle. You can assign measures to both color and size.

  • In the Filled layout, each administrative level is represented by its real polygon. You can assign a measure to the color


Geographic columns

A geographic column is either a point or another kind of geometry. Valid geographic columns are detected as “Geopoint” or “Geometry” in the exploration component.

Geographic columns can be obtained in DSS:

  • By reading a GeoJSON or Shapefile dataset

  • By reading any dataset containing a column in WKT format

  • By applying a geocoding processor in a preparation script

  • By applying a “Resolve GeoIP” processor in a preparation script

Map backgrounds

DSS comes pre-bundled with map backgrounds provided by Carto. More map backgrounds can be added using DSS plugins: