Mapchart reference

To represent data related to cartography

Overview

📖 Learn More about the Mapchart here.

📖 Find examples on the Mapchart here.

Parameters

Required

You must fill these parameters to produce a Mapchart

parameters label type description (placeholder | tooltip)
markers   object | Pin information on a map
markers/size Makers size   | (Optional) Use a value to size markers
markers/color Markers color string (Column of dataset expected) Column containing value for markers color | (Optional) Use a value to color markers
markers/longitude   string (Column of dataset expected) Column containing longitude coordinates | Use coordinates to position your marker
markers/meta     | Will be displayed in the legend
markers/dataset   string Name of the dataset |
markers/opacity   integer Enter a value between 0 and 1 | (Optional) Custom markers opacity0 is completely transparent, 1 completely opaque (default)
markers/label   string (Column of dataset expected) Column containing markers’ labels | Add labels to your markers
markers/latitude   string (Column of dataset expected) Column containing latitude coordinates | Use coordinates to position your marker
zones   object | Show zones on a mapTo use this option make sure you have shapes available.Read this tutorial to learn more about it
zones/useLinearScale Use a linear scale boolean |
zones/unfilteredDomain Use scaling on unfiltered dataset boolean | By default, the scale is computed with the data after filtering.Set to true for the scale to be consistent across filtering
zones/dataset   string Name of the dataset |
zones/noDataZones Zones with missing data object | Manage the render of zones with no data
zones/noDataZones/color Color string Enter color name or any hexadecimal color | Customize the color of the empty zonesCan be a color name or any hexadecimal color like #000000
zones/noDataZones/disableClickEvent Deactivate user’s selection boolean | Prevent user to select empty zones
zones/color Zone’s color string (Column of dataset expected) Column containing value for zones’ color | (Optional) Use a value to color zones
zones/reverseScale Reverse scale boolean | Reverse scale to set high values as cold and low ones as hot
zones/label   string (Column of dataset expected) Column containing names for the zones |
zones/meta     | Will be displayed in the legend
zones/quantiles Number of scale’s buckets integer Enter a number of buckets for the scale |
zones/opacity   integer Enter a value between 0 and 1 | (Optional) Custom zone’s opacity0 is completely transparent, 1 completely opaque (default)
legend Display legend   |
tiles Background object | This will display a cartographic backgroundThis is mandatory if you only configure Markers You need to save your story and refresh your page to see the changes
tiles/provider   string |
tiles/params   object |

Optional

You can let these parameters unset if you do not need them

parameters label type description (placeholder | tooltip)
projection   string | This is for advanced configuration onlyCheckout this documentation for more info on projections
size Size number Enter a proportion of the total screen | Use on multiple charts onlyEnter a number from 0 to 1
markers/defaultSelected Select a specific marker initially string | first, last, report or the name of the label
markers/recycleColors Recycle groups colors boolean | When chart data changes (filters or requesters)
tutorial Tutorial object | Help your users understand how to use the chart!This will be displayed the first time your user uses the chart
tutorial/id   string Enter an ID | Change the ID to display the tutorial again. All tutorials with the same ID will be displayed only once.
tutorial/content Message string Enter your message | This will be displayed to your users
tutorial/alwaysShow Always show this tutorial boolean | By default the tutorial is shown once only
zones/defaultSelected Select a specific zone initially string | first, last, report or the code of the label
zones/thresholds Custom color thresholds array Enter a threshold value | (Optional) Override the default quantile scale. You can specify a maximum of 3 custom thresholds.
fixed Fixed map boolean | Activate this option to prevent users from zooming onto the map
crossfilter   object | Use it for masterslave configurationShould be configured on the Master chart
crossfilter/datasets Select the slave datasets array | Datasets that will be filtered on the ‘on’ column
crossfilter/on on column string (Column of dataset expected) Column existing in master and slave datasets |
mobileSize Mobile Size number Enter a proportion of the total mobile screen | Use on multiple charts onlyEnter a number from 0 to 1

Others

This parameters are either common to all charts, or hidden from studio. You can use them in code mode, but it’s not recommended !

parameters label type description (placeholder | tooltip)
markers/reverseScale   boolean |
zones/noDataZones/hidden Show zones boolean | Authorize user to see empty zones
zones/id   string (Column of dataset expected) |
style   string |