Geo Mapping

This section displays how to map the Polygone Geometry type (and Line) with the Leaflet Map charting component in the Designer.

Pre-requisite: Please configure the Geo Shape settings for Polygone and Line Geometry type before using them inside the Map chart component of the Designer.

The integration guide for the Leaflet Map charting component explains how to visualize complex geographic features—specifically Polygons and Lines—using data fields that represent geographical coordinates.

This process involves more than just basic point plotting; it requires you to correctly map a geometry field (often in JSON or a similar structured format like WKT) from your dataset to the Leaflet component. The designer allows you to select the data field containing the geometric definition for a Line (a sequence of connected points, great for showing routes or paths) or a Polygon (a closed loop of connected points, ideal for defining boundaries like regions, territories, or zones).

Set up the Map chart (Leaflet)

  1. Drag and drop the Map Chart component onto the canvas.

  2. Create a connection for associating with the chart.

  3. Open General properties and set Map Type = Leaflet.

  4. Under Leaflet, the available Geometry Type options are:

    • Line

    • Polygone

Line Type

  1. Navigate to Geometry Type and select Line.

  2. Associate Category and Series fields to the chart (Dataset tab).

  3. In the dashboard script pane, fetch the Line shape file JSON configured in Admin Module:

    sdk.getWidget('map1').m_shapedetails.filename = "Line shape file";

    1. Replace map1 with your Map chart widget ID and "Line shape file" with the exact name configured in the Admin Module.

  4. Preview the dashboard to view line-type geometry.

Polygon Type

  1. Navigate to Geometry Type and select Polygon.

  2. Associate Category and Series fields with the chart.

  3. In the dashboard script pane, fetch the Polygon shape file JSON configured in the Admin Module:

    sdk.getWidget('map1').m_shapedetails.filename = "Polygon shape file";

    1. Replace map1 with your widget ID and "Polygon shape file" with the configured shape file name.

  4. Preview the dashboard to view the polygon-type geometry.

Tips:

  • Ensure the Geo Shape entries (Line/Polygon) are correctly uploaded and named in the Admin Module; the filename must match exactly.

  • Category typically maps to the feature key (e.g., region/area code) and Series to the measure to visualize.

  • Keep the Map widget ID (e.g., map1) consistent when scripting.

  • If your map includes multiple layers, repeat the m_shapedetails.filename assignment for the intended widget(s).

Troubleshooting

  • No shapes displayed:

    • Verify Map Type = Leaflet and the correct Geometry Type (Line/Polygon).

    • Confirm the shape file name matches the one in the Admin Module.

    • Check that your dataset’s Category key aligns with the shape file’s feature properties.

  • Geometry renders, but values don’t color/fill:

    • Ensure Series is bound to a valid numeric measure.

    • Verify any join key/lookup logic used by the component (Category vs. shape feature attribute).

  • Script has no effect:

    • Confirm the code is in the dashboard script context and references the correct widget ID.

    • Reopen Preview to reload the script.

PreviousData LabelNextLanguage Mapping