View Categories

Map data

< 1 min read

The map component provides an opportunity to visualize data with reference to geographic locations. Map data can be specified manually or passed from a data source. Let's take a closer look at these two methods.

 manual

 To enter the values manually, call Edit Map, go to the Data tab, and fill in the cells in the table below.
 

 To draw a map, simply add a map component to your report and specify its view. This is because the underlying Key column is filled by default. In this case, the map conveys only geographical information and is drawn in one color. Other columns need to be completed in order for the map to have information.

Name column.
This column contains the name of the element.
For example, the USA map contains the full state names as keys.
The Name column allows you to specify the text that will appear on hover in the rendered report.
This column does not need to be filled. If no text is specified, the key name will be displayed when hovering over the element in the report.
 
Value column.
This column contains values for specific map elements.
The value can be any number.
If Show Values is enabled, values are also displayed in the rendered report on hover.
 
Group column.
The values in this column are relevant when the map type is Map with Groups or Heatmap with Groups.
In this case a group key is specified.
If you want to group some objects, you have to make sure their keys match exactly.
In this case the map elements in the rendered report will be painted with one color.
There is also a total value for group elements.
Hover over any element in the group to see the results in the rendered report with total prefix.
 
The Color column specifies the color of map elements in the report.
Colors are defined in the #XXXXXX template.
If no value is specified for this column, the map elements will be colored with a colormap preset or custom style.
If a color is specified and the map is styled, the specified color will be applied to the map elements.
 
Once the table is full, the report can be rendered.
Also, entries can be saved in a JSON file for use in future reports.
To save the data, click [
You have to click the save button.

 
 A button to update the map in the preview panel.
The "Save" button calls a menu where you need to specify the path for saving the JSON file.
Clicking the Open button invokes a menu where you can select a previously saved JSON file containing map data.
Retrieving data from data sources
In addition to manual data entry, data maps can also be retrieved from data sources. To do this, click the Linked Data button on the Data tab of the map editor. In the Link Data menu, you can select a data source and specify columns for the map field from the data source.
The Key field indicates the data column containing entries identical to the specific type of map key.
The Name field specifies the column containing the names of map elements.
The Value field indicates the column containing the map element's value.
 The Group field indicates the data column that contains the group's key.
In this field, you must specify a data column if the map type is defined by group, or specify a heatmap by group. Grouped map elements in rendered reports are painted in a single color.
The Colors field specifies the data column that contains the set of colors for map elements.
If no data column is specified in this field, the map elements will be colored with a map style preset or custom color. If the column contains data (map style is set), the data column color is applied to the map element.