Map

A Map Chart positions data in a geographical context, allowing users to visualize values, categories, or processes distributed across regions. It supports multiple layers of information (markers, lines, polygons, clusters, trails, and trips), making it a powerful tool for analyzing spatial data.

Users can also define an interactive layer—the only layer where items can be marked and interacted with directly.

Best Situations to Use

Use a map chart when:

• You want to display geographically distributed data.

• Understanding regional patterns or trends is important.

• You need to analyze movement paths, trails, or trips on a map.

Examples:

• Showing unemployment rates across states or regions.

• Mapping sales performance by territory.

• Displaying trip or delivery routes.

• Visualizing clusters of customer activity on a city map.

Variations

Map charts support different rendering types:

• SVG Map – Static, scalable vector-based representation.

• Leaflet Map – Interactive map with zoom, pan, trip/trail support, and custom markers.

Leaflet Enhancements:

• Auto Zoom: Automatically adjusts zoom level to show all markers.

• Trip/Trail Visualization: Straight, dashed, or dotted lines.

• Custom Marker Icons: Supports Glyph, Maki, and font-based icons.

• Circle Data Points: Ability to display circular regions or highlight areas with a configurable center point.

Properties

General

• Component Name – Auto-generated unique identifier.

• Position (Left, Top) – Placement coordinates on the canvas.

• Height / Width – Chart dimensions.

• Initial Visibility – Show/hide chart on load.

• Max Button – Enable maximize view.

• Map Type – Choose SVG or Leaflet.

• Select Map – Choose map region (e.g., Asia, Europe, custom).

• Geometry Type – Choose Marker, Line, Polygon, Clustered, Trail, or Trip.

• Line Type – Choose Curve, Segment, Step, Reverse Step, Horizontal, Vertical.

• Line Thickness – Define line width.

• Default Color – Set base color for elements.

• Roll Over Color – Define hover color.

• Outline Color – Set border/outlines.

• Color Ranges – Define color gradients for data ranges.

• Solid Color – Apply fixed fill color.

• Opacity – Adjust transparency.

• Random Color – Enable varied color assignment.

Tooltip

• Enable/disable tooltips.

• Supported types: None, Default, Custom.

• Configure background, border, opacity, font size, box width, and precision.

• Add custom descriptive text for map elements.

Background & Styling

• Gradient rotation, opacity, and color customization.

• Borders (color, width, radius).

• Shadows with configurable color and transparency.

Title & Subtitle

• Show/hide title and subtitle.

• Customize font (color, size, style, weight, family, alignment).

• Option to pull dynamic dataset descriptions.

Export Options

• Enable context menu for export.

• Supported formats: Excel, CSV.

• Customize export file name.

• Set global export type (Screenshot, Tabular).

Leaflet-Specific Features

• Trip/Trail Lines – Render as Straight, Dashed, or Dotted.

• Marker Icons – Supports Glyph, Maki, and custom font icons.

• Circle Data Points – Configure circles based on dataset or script.

• Script Example:

sdk.getWidget('map1').m_geometrytype = "circle";
sdk.getWidget('map1').m_showmarker = true;
sdk.getWidget('map1').m_circleindex = 21;

Series Indicator

• Supports conditional coloring for series.

• Options: Fixed Value Comparison or SVG-based coloring.

• Define conditions via dataset properties → Indicator tab.

Example Use Cases

• Business: Sales distribution by region.

• Economics: Visualizing unemployment rates across countries.

• Logistics: Delivery route visualization with trail/trip maps.

• Environment: Mapping climate or pollution indicators geographically.

Sample Data Setup:

• Category Field: Name (e.g., country, state, or region).

• Series Field: Unemployment rate (or other numeric measure).

13KB

Sample Data_Map chart.xlsx

Open

⚠️ Note:

• Category fields can be string, numeric, or date types.

• Series fields must be numeric.