Coloring Based on Data Range

Replace the map definition files (of v3.12.2 or older) with the latest files available in download package while upgrading to v3.13.0.

You have to use color ranges to define entity colors based on values, in order to set up a simple data driven map. Since the process of defining colors for individual data buckets is not scalable, you need to group data values under defined data range buckets.

Note that you need to denote entities within these buckets with the same color. Also, you need to define colors for each data range. This can become tedious if you have to deal with a large number of buckets. In that case, you can use a gradient scale to simplify this process.

Using a gradient scale, you can specify colors associated with specific data points. This defines an automatic gradient scale across the data range. Entities appear in unique colors as per the data value position on the gradient scale.

Build a map with a gradient scale

Here's how you can build a map with a gradient scale:

  • Set the caption of the map and apply the fusion theme (FusionCharts Internal Theme) to control the cosmetic properties of the map. Use the formatNumberScale and showLabels attributes to specify the formatting of labels.

  • Use the colorrange object to define different numeric ranges of the gradient legend. Also, use the following attributes to define specific properties:

    • Use the startLabel and endLabel attributes to define the labels on the starting and ending points of the gradient scale.

    • Use the minValue attribute to specify the starting point of the scale.

    • Use the color attribute to specify the starting color of the legend.

  • Use the colorrange object, which has an array of color objects, to indicate progressive thresholds. Specify the upper limit of the band with maxValue as key.

  • Specify the color code for the upper limit of each band in the gradient with code as key.

  • Lastly, specify the tabular data within the data array, with name of the new ID with key as id, and population with key as value.

Refer to the code given below:

{
    "chart": {
        "caption": "Global Population Density",
        "theme": "fusion",
        "showLabels": "1",
        "formatNumberScale": "0"
    },
    "colorrange": {
        "minvalue": "0",
        "startlabel": "Low",
        "endlabel": "High",
        "code": "#FF4411",
        "gradient": "1",
        "color": [{
            "maxvalue": "25",
            "code": "#FFDD44",
            "displayValue": "Median"
        }, {
            "maxvalue": "100",
            "code": "#6baa01"
        }]
    },
    "data": [{
        "id": "NA",
        "value": "22.1",
        "showLabel": "1",
        "displayValue": "Moderate"
    },
    {
        "id": "SA",
        "value": "22.0",
        "showLabel": "1",
        "displayValue": "Moderate"
    },
    {
        "id": "AS",
        "value": "95.0",
        "showLabel": "1",
        "displayValue": "Dense"
    },
    {
        "id": "EU",
        "value": "72.5",
        "showLabel": "1",
        "displayValue": "Dense"
    },
    {
        "id": "AF",
        "value": "33.7",
        "showLabel": "1",
        "displayValue": "Moderate"
    },
    {
        "id": "AU",
        "value": "3.2",
        "showLabel": "1",
        "displayValue": "Sparse"
    }]
}

The map will look as shown below:

FusionCharts will load here..

Click here to edit the above map.

You can use only one color to draw the gradient scale. Here, the scale will appear starting from the darkest shade of the color (lower limit) to the brightest shade of the color (upper limit). The map will automatically decide the numeric range taking the lowest data value present as the lower limit and the highest data value as the upper limit. In this case, however, you cannot set the upper limit using the maxValue attribute.