Search results

Configuring and Formatting a Map

Choropleth map

Choropleth maps allow you to showcase quantitative values encoded using color scale.

Choropleth Map

Bubble map

Bubble maps allow you to showcase quantitative values encoded using bubble size.

Bubble map

How to change map type as choropleth or bubble?

You can change map type as choropleth or bubble by Map Type property.

Map Type

How to configure the table data into a map?

To plot a map, a minimum requirement of 1 value and 1 shape are needed. Dropping a dimension will display each region split by each of its item.

The following steps explain the data configuration of a map:

  1. Click the Data Source in the configuration panel.

Data button

  1. Click the CREATE NEW to launch a new connection from the connection-type panel.

Data source button

  1. In the connection-type panel, click any one (Here, the Microsoft Excel Connection type is selected for demonstration) of the listed connection type buttons shown.

Data source list

  1. In the NEW DATA SOURCE configuration panel, fill the connection type and related details. Click the Connect.

Connect button

  1. Drag your preferred table or view from the left pane in the data design view and click Save.

Virtual table

  1. Drag the Map control icon from the toolbox into the design panel. You can find control by searching in the toolbox.

Adding Bubblemap

  1. Click Properties in the configuration panel to open the property pane. Switch to the ASSIGN DATA tab.

Designer properties button

The property panel renders as follows.

Data tab

click on the Assign Data.

Choropleth map data tab

The data tab will be opened with available measures and dimensions from the connected data source.

Assign data

Bind columns by dragging the element from the Measures section to Location Value.

Bind columns for Bubblemap

Drag the elements from the Dimension section to the Location Name.

Add location name field

You can use the aggregation function to change the Location Value of the column.

Value

You can use the Filter to filter the data. For more details, refer to this filter.

Filter for Bubblemap

You can format the values by selecting the Format option. For more details, refer to the measure format.

Format for Bubblemap

You can use the Filter(s) option to filter the data. For more details, refer to this filter.

Configuring widget filters

You can clear the filters by selecting the Clear options.

You can add more than one value to the Location Name field. The alert message will be shown to enable the drill-down option. Click Yes to enable the option.

NOTE: If you click No, a single value will be added to the Location Name field.

Here is an illustration,

Choropleth map

Choropleth map demo

Bubble map

Bubble map

There is a section Location Tooltip, which is used to show the values of bound columns while rendering tooltips in a map widget.

Bubble map Tooltip data

Here, this value comes with a tooltip.

Choropleth map

Choropleth map Tooltip data

Bubble map

Bubble map Tooltip data

You can render markers with Marker Latitude and Marker Longitude data.

Bind columns by dragging the element from the Measures or Dimension sections to Marker Latitude and Marker Longitude. This section allows both Measures and Dimensions. To render markers, both Marker Latitude and Marker Longitude sections should have data.

Bubble map Latitude data

Bubble map Longitude data

The map renders as follows.

Choropleth map

Choropleth map Marker data

Bubble map

Bubble map Marker data

Marker has an individual tooltip. Bind data to a Marker Tooltip from the Measures or Dimensions sections.

Marker Size

If you wish to modify the size of the marker according to the data, then you can configure that data in the Marker Size section. You can only configure the measured field for Marker Size.

Map Marker Size Container

After configuring the marker size field, the map renders as follows.

Map with Marker Size

Note: After configuring the marker size, the width and height of marker settings under the property panel will be disabled automatically.

Bubble map Marker tooltip

Bubble map Marker tooltip

You can use the aggregation function to change the Marker Tooltip Which column bounds from the Measures section.

Bubble map Marker tooltip Data

You can filter the data using the Filter option for both Measure and Dimensions field data. For more details, refer to this filter.

Bubble map Marker tooltip filter

Bubble map Marker tooltip filter

You can format the values by selecting the Format option for Measure field data. For more details, refer to the measure format.

Bubble map Marker tooltip format

Here, the marker tooltip shows data while the cursor hovers over the marker.

Choropleth map

Choropleth map Marker tooltip data

Bubble map

Bubble map Marker tooltip data

Hidden Column

Hidden columns are useful in cases where we don’t want the fields to take part in the visualization, but only to be used for linking, filtering and view data.

Hidden column

We can configure both measure and dimension fields into the hidden column. For measure we will be having all the settings we have for the measure fields expect formatting and filtering.

Measure

In the case of dimension fields we will having the following options only.

Dimension

Linking

The primary use case of the hidden columns is linking. On configuring hidden columns, we can see below that the fields configured in hidden columns are listed in the linking section. On configuring the column in linking we can pass the corresponding column value in linking parameter.

Measure Based Example: If we wish to pass the number of UnitsInStock as an URL parameter but do not want it to influence the visualization, we can configure the UnitsInStock in the hidden columns and incorporate them into the link.

Linking

Dimension Based Example: If we wish to pass the region an URL parameter but do not want it to influence the visualization, we can configure the region in the hidden columns and incorporate them into the link.

linking

Filtering

You can use hidden columns to filter data in the visualizations. Configure hidden columns and click the below filter icon.

Filtering

Click the Custom button highlighted in the filter configuration dialog image below. It will list all the fields configured in the widget. Keep the field configured in the hidden column and remove the other fields, then click the Update button.

Filtering

Now, we can see in the below image, the data is filtered based on the hidden column field instead of the actual column that we bound in the widget. 

Filtering

For more details about filtering the widget data, refer to the Filter Configuration documentation

View Data

You can view the data in the hidden columns in the underlying data view. This is useful for checking the data in more detail and can help you to identify any issues with the data.

View date

NOTE: We don’t recommend to configure lower hierarchy data in hidden columns as we can see in the info icon in Hidden Column section denotes the same.

Hidden Column

The below map displays the unit price by ship country without hidden columns.

Before

If we configure lower hierarchy data (Ship City) in hidden columns, the data configured in the widgets gets duplicated, and incorrect data is displayed in the tooltip, as we can see in the image below.

After

How to format a map?

You can format the map for a better illustration of the view that you require using the settings available in the Properties tab.

General Settings

General settings

Name

This allows you to set a title for the map widget.

General settings

Subtitle

This allow you to set a subtitle for the map widget.

General settings

Description

This allows you to set a brief explanation about the map widget.

General settings

Basic settings

Basic Settings

Show Tooltip

This option allows you to toggle the visibility of tooltip in a map.

General settings

Map type

You can choose the map type as choropleth or bubble map.

Map

By setting the map type as Bubble, the show value label property will be hidden.

Map

Show legend

A Legend is a text used to describe the plotted data. It allows you to toggle the visibility of legend in the map.

Map

Enable Zooming

This allows you to toggle the visibility of zooming buttons.

Map

Show Label

This allows you to enable the visibility of Data Labels.

Show Labels

Label Color

This allows you to customize the data labels color.

Value Labels Color

Value Labels Color

Enable Multi Selection

This option will be enabled only after you enable the Act as Master Widget option and this allows you to filter the multiple data by enabling the Enable Multi Selection option.

Enable multi selection

Shape kind

You can select any type of shape (country or continent or state) from the shape kind drop-down.

Choropleth color

Shape data

You can choose a shape for the selected country or continent or state. The combo box data shows based on the selected values in the shape Kind.

Choropleth map field

How to add new shape files

If you want to load new map shape files into the map, for example, if you wish to load the India shape file with district split-ups instead of states, follow these steps:

  1. Download the India map shape file with district split-ups from any open-source website.

  2. Convert the downloaded shape files to GeoJSON format using any open-source tool.

  3. Extract the downloaded shape file folder and rename to customindia.js. Ensure that the file name is in lowercase and spaces are replaced with underscores (e.g., south_africa.js).

    Rename shapefile

  4. Open the customindia.js file and add the following text at the beginning: ejdashboard.Customindia = and then save the file.

    shapefile Text

  5. Copy this customindia.js file and paste it into the app_data/bi/shapefiles path.

    new shape file added

  6. Next, add the customized shape name to the shapefile.json file. The text is only for display purposes, and the value should be similar to the shape file text (e.g., the value should be Customindia if we use the ejdashboard.Customindia as the starting text).

  7. The shape file name should be added based on the shape kind. For example, since India is a country, the shape name should be added to the country collections in the JSON file.

    Json shape file name

  8. Reload the dashboard page and go to the property panel. Now, you should see the customized shape name that we added in the shapefile.json in the shape data dropdown. If you don’t add the shape name to the shapefile.json file, the shape name will not be listed in the shape data dropdown.

    Rename shape file

  9. Click on the shape name, the customized shape will be rendered in the map widget based on the data configuration.

    Json shape file name

Drill down configuration

By default, the state shapes in India are divided into districts. However, if you prefer to drill the state shapes with city divisions instead of districts(e.g., If you want to drill the shape of Tamil Nadu with city divisions instead of districts), follow these steps.

  1. Download the Tamil Nadu shape file with the city division from any open-source website.

  2. Convert the downloaded shape files to the GeoJSON format using any open-source tool.

  3. Extract it and rename the file to customindia_tamil_nadu.js. Ensure that the file name is in lowercase and spaces are replaced with underscores (e.g., south_africa.js).

    Json shape file name

  4. Open this file and add the following text at the beginning: ejdashboard.Customindia_Tamil_Nadu = and then save the file.

    Json shape file name

  5. Include this file name into India.js for drill down. Open that file and search for Tamil Nadu. Then, go to the end of that line and change this text: "shapeName":"Customindia_Tamil_Nadu" instead of "shapeName":"India_Tamil_Nadu".

    Json shape file name

  6. Save this file. Then copy this file and paste it into the app_data/bi/shapefiles path.

    Json shape file name

  7. Please reload the dashboard page and drill the India shape in the world map, Then drill the Tamil Nadu shape in India, The Tamil Nadu shape will be displayed with city divisions instead of districts.

    drilldown shape file

  8. To load only the Tamil Nadu state with city divisions, you need to include the shape file name in the shapefile.json file. Add the shape file name to the state collections in the JSON file, as Tamil Nadu is a state.

    Json shape file name

  9. After adding the shape file name, reload the dashboard page and go to the property panel. Change the shape kind based on the shape name you added in the shapefile.json file. Now, the customized shape name should be visible in the shape data dropdown. If the shape name is not added to the shapefile.json file, it will not appear in the shape data dropdown.

    Rename shape file

  10. Once you see the customized shape name in the dropdown, click on it, and the customized shape will be rendered on the map widget based on the data configuration.

    drilldown shape file

How to add customized shape in world map country

If you want to view the customized India shape while drilling India on the world map, follow these steps:

  1. You should have customized the India shape files.

  2. Open the world_map_country.js file and search for India.

  3. Change the shape name to Customindia.

    worldmap shape file

  4. Save it and refresh the dashboard. Configure the drill down with any data. Click the India shape on the world map, and the customized shape will be rendered.

    worldmap file

Legend Settings

This section allows you to customize the legend in the map.

Choropleth color

Show legend

This allows you to toggle the visibility of legend in a map. By default, it will be enabled.

Type

It defines the legend type whether layers or marker.

  • If Location Value and Location Name alone are configured without Marker Latitude and Longitude, the legend type will be Layers by default. In this case, the Type option will not be shown.

Layers Legend

  • If Marker Latitude and Longitude alone bounded with advanced customization in the map without Location Name and Value configuration, the type will be Markers by default. In this case, the Type option will not be shown.

Markers Legend

  • If both Location Value and Location Name and Marker Latitude and Longitude with advanced customization configured, the Type option will be shown in Legend Settings section.In this case, Legend will be shown based on legend type. In below image, the legend will be shown for Layers by default.

Legend Type

For type Markers, legend will be shown as below.

Legend Type Marker

Show Title

This option allows you to toggle the visibility of legend title in a map.

Show Legend Title

Show Legend Title in Map

Title

This allows you to edit the legend title of a map.

Map Legend Title

Legend Title

Position

This provides the option to select the legend placement in a map.

Legend position

Legend position

Marker Settings

If you bind the Marker latitude and Marker Longitude fields, the Marker settings category will be visible.

Marker Settings

Marker Based Zoom

If you enable this option, the map will be automatically zoomed in to the marker area. Here in the following map widget, the map has a single marker. It will be useful for the filtering process.

Map Zoom

By enabling this option, the map will be zoomed in on the area where the marker is placed.

Map Zoom In

Marker Shape

This option allows you to customize the marker shape on the map.

Map Shape Dropdown

Map Shape

Color

This option allows you to customize the marker color.

Width

This option allows you to customize the marker width. When configuring data into Marker size, this property will be disabled.

Height

This option allows you to customize the marker height. When configuring data into Marker size, this property will be disabled.

Advanced

Rule

This option allows you to customize the map marker.

If you enable the Advanced option, the color customization window will render as follows:

Advance Marker settings

You can change based on the field and summary type.

You can choose a series of colors with the Color color picker using multiple condition sets for measure value: greater than, less than, equal to, not equal to, between, not between, greater than or equal to, less than or equal to. For Dimension values: starts with, ends with, contains, not contains, equals, not equals. You can customize the width and height of the marker.

You can customize the shape of the marker with the Marker Shape option or you can customize the shape as an image with the Marker Image option. You can also customize the legend name by providing the necessary values inside the condition name and you can also add multiple conditions.

Rule Color changes for marker

If you click save, the map widget will render like this:

Rule Color changes for marker in map

Individual

This option allows you to customize the map marker color individually based on the selected column values.

For example, if you have three types of signal strength options in your data and you want to display marker colors based on the three types. You can select the Signal Strength column in the based selection and then assign a color for each type of signal strength option.

Individual Marker settings

Now, the map marker color renders with these changes.

Individual Marker Color

You can enable linking and configure to navigate to a general URL with or without parameters. For more details, refer to the Linking.

Link

Formatting

This section shows up when the Location Value and Location Name fields have values.

Default Color settings

Monochromatic

You can configure a single color palette whose saturation differs based on the value density.

Monochromatic

Default Color settings

Advanced Settings

This allows you to customize the map color with three different types: gradient, rule, or individual. By default, the window renders with gradient type.

If you enable the option Advanced, the color customization window will render as follows.

Advance Color settings

Advance Color Dialog

Gradient

You can select based on which field to apply gradient color by the Based On dropdown. You can change the summary type. You can edit the Low and the High value and their colors. By default, the low value takes the minimum value of the map and the high value takes the maximum value of the map. Mid can be enabled and can change its value and color can be changed. By default, mid-color is disabled.

If you click save, the map will render as follows.

Choropleth map

Choropleth map Gradient Color settings

Bubble map

Bubble map Gradient Color settings

Default color

Default Color settings

The default color will apply for the conditions that are not satisfied by the advance color customization.

Rule

You can select the rule settings by clicking the Rule radio button. The color customization window renders as follows.

Rule Color settings

You can change based on field and summary type as gradient type. The Value Type can be change with value or percentage.

You can choose a series of colors with the Fill color picker using multiple condition sets: greater than, less than, equal to, not equal to, between, Not between, greater than or equal to, less than or equal to. You can customize the legend name by providing necessary values inside condition name. You can also add multiple conditions.

Rule Color changes

If you click save the map widget will render like this.

Choropleth map

Choropleth map Rule Color Setting changes

Bubble map

Bubble map Rule Color Setting changes

Individual

You can select the rule settings by clicking the Individual radio button. The color customization window renders like this.

Individual settings

This type renders with the individual default color for each value of the map. You can change its color with individual color pickers. If you want to reset your changes return to the default color with Reset.

You can save your changes by clicking Save. Now, the map renders with changes.

Choropleth map

Choropleth map Individual settings changes

Bubble map

Bubble map Individual settings changes

Filter

Filter

Act as Master Widget

This allows you to define the map widget as a master widget such that its filter action can be made to listen by other widgets in the dashboard.

Select a shape to filter interaction, the menu will be shown as follows.

Context Menu

Filter interaction

If you enable Act as Mater Widget option, Enable Multi Selection will be shown.

Multi Selection Option

This option allows using multiple filter interactions.

Consider if you clicked one shape in the map widget already, then click another shape and select the Filtering option on the menu. Now, the slave widget will respond like this.

Slave for Multi Selection

Ignore filter actions

It defines the map widget to ignore the filter actions applied to other widgets in the dashboard.

Enable Hierarchical Filter

Through this option, you can enable or disable hierarchical the Top N filtering. While applying the Top N filter with multiple dimension columns, the data returned can be customized based on whether the filtering needs to be done as flat or based on the hierarchy of added dimension columns.

When the Hierarchical Filter option is enabled, the Top N will be applied for each individual column separately based on the number set for each column.

Container Appearance

Container Appearance

Title Alignment

This allows you to handle the alignment of widget title to either left, center, or right.

Title Color

This allows you to apply the text color to the widget title.

Title Auto Font Size

On enabling Auto Font Size, the font size of the title will be adjusted automatically if the resolution of the screen varies.

Font Size

This allows you to apply the specified size of the font to the widget title if the Title Auto Font Size is disabled. Value can be between 10 and 44.

Subtitle Auto Font Size

On enabling Auto Font Size, the font size of the subtitle will be adjusted automatically if the resolution of the screen varies.

Font Size

This allows you to apply the specified size of the font to the widget title if the Subtitle Auto Font Size is disabled. Value can be between 10 and 32.

Auto Padding

On enabling Auto Padding, the padding of the widget container will be adjusted automatically if the size of the widget varies.

Padding

This allows you to customize the padding of the widget container if the Auto Padding is disabled. Value can be between 0 and 25.

Show Border

This allows you to toggle the visibility of the border surrounding the widget.

Corner Radius

This allows you to apply the specified radius to the widget corners if the Show Border is enabled. Value can be between 0 and 10.

Show Background Image

This allow you to set the background image for the map widget.

Background Color

This allows you to set the background color to the map widget.

Transparency

This property allows you to change the transparency from 0.0 to 1.0.

Show Shadow

This allows you to toggle the visibility of the shadow surrounding the widget.

Container actions

Container Actions

Show Header

This allows you to enable or disable the widget title of the map.

Allow Maximize View

This allows you to enable or disable the maximized mode of the map widget. The visibility of the maximize icon in the widget header will be defined based on the setting in the viewer.

Allow CSV Export

This allows you to enable or disable the CSV export option for the map widget. Enabling this allows you to export the summarized data of the widget view to CSV format in the viewer.

Allow Excel Export

This allows you to enable or disable the Excel export option for the map widget. Enabling this allows you to export the summarized data of the widget view to (.xlsx or .xls) format in the viewer.

Allow Image Export

This allows you to enable or disable the Image export option for the map widget. Enabling this allows you to export the view of the widget to image format (.jpg), (.png), or (.bmp) in the viewer.

Allow PDF Export

This allows you to enable or disable the PDF export option for the map widget. Enabling this allows you to export the view of the widget to pdf format in the viewer.

Enable Comments

This allows you to enable or disable comment for the dashboard widget. For more details, refer to this link.

Allow View Underlying Data

This allows you to visualize the raw data associated with a widget at runtime.

To learn more about viewing the underlying widget data, refer to the view data documentation.

Pin Widget

This allows you to pin the widget.

Responsive Behavior

We hide the widget elements based on the size of the widget for better readability.

When the map has been placed with less than 7 rows map legend will be hidden.

Widget Element