Geo Map Charts

This chart widget allows users to create detailed maps by providing a set of metrics that define the geo locations to be displayed on the map.

Map Configuration

API Key

The API key is a unique identifier that authenticates requests associated with your project for usage and billing purposes. You must have at least one API key associated with your project.

Zoom Level

This property establishes the particular level of magnification for the geographic map. By adjusting this setting, users can control the extent to which they can view and focus on specific areas within the map, providing them with a more detailed and precise understanding of the geographic information displayed

Center Position

Determines the central point on the geographic map. This is where the map is centered, providing a focal point for reference.

Longitude

Set the longitude coordinate for the central location on the geographical map. This is where the map will be centered and focused on.

Latitude

Specify the latitude coordinate for the central location on the geographical map. This is where the map will be centered and focused on.

Show Charts

Use this toggle feature to show/hide the geo-nodes of the map.

Map Data

Option

Supply the JSON data that is needed in order to display the geographical map. This JSON content will be used for rendering the map and visualizing the geographic information. Sample data below-

{
  "tooltip": {
    "trigger": "item"
  },
  "animation": true,
  "series": [
    {
      "name": "Population",
      "type": "scatter",
      "coordinateSystem": "gmap",
      "itemStyle": {
        "color": "#00c1de"
      },
      "data": [
        {
          "name": "Azerbaijan",
          "value": [
            47.395,
            40.43,
            8352021
          ]
        },
        {
          "name": "Albania",
          "value": [
            20.068,
            41.143,
            3153731
          ]
        },
        {
          "name": "Armenia",
          "value": [
            44.563,
            40.534,
            3017661
          ]
        },
        {
          "name": "Bosnia and Herzegovina",
          "value": [
            17.786,
            44.169,
            3915238
          ]
        },
        {
          "name": "Bulgaria",
          "value": [
            25.231,
            42.761,
            7744591
          ]
        },
        {
          "name": "Cyprus",
          "value": [
            33.219,
            35.043,
            836321
          ]
        },
        {
          "name": "Denmark",
          "value": [
            9.264,
            56.058,
            5416945
          ]
        },
        {
          "name": "Ireland",
          "value": [
            -8.152,
            53.177,
            4143294
          ]
        },
        {
          "name": "Estonia",
          "value": [
            25.793,
            58.674,
            1344312
          ]
        },
        {
          "name": "Austria",
          "value": [
            14.912,
            47.683,
            8291979
          ]
        },
        {
          "name": "Czech Republic",
          "value": [
            15.338,
            49.743,
            10191762
          ]
        },
        {
          "name": "Finland",
          "value": [
            26.272,
            64.504,
            5246004
          ]
        },
        {
          "name": "France",
          "value": [
            2.55,
            46.565,
            60990544
          ]
        },
        {
          "name": "Georgia",
          "value": [
            43.518,
            42.176,
            4473409
          ]
        },
        {
          "name": "Germany",
          "value": [
            9.851,
            51.11,
            82652369
          ]
        },
        {
          "name": "Greece",
          "value": [
            21.766,
            39.666,
            11099737
          ]
        },
        {
          "name": "Croatia",
          "value": [
            16.693,
            45.723,
            455149
          ]
        },
        {
          "name": "Hungary",
          "value": [
            19.134,
            47.07,
            10086387
          ]
        },
        {
          "name": "Iceland",
          "value": [
            -18.48,
            64.764,
            295732
          ]
        },
        {
          "name": "Israel",
          "value": [
            34.851,
            31.026,
            6692037
          ]
        },
        {
          "name": "Italy",
          "value": [
            12.8,
            42.7,
            5864636
          ]
        },
        {
          "name": "Latvia",
          "value": [
            25.641,
            56.858,
            2301793
          ]
        },
        {
          "name": "Belarus",
          "value": [
            28.047,
            53.54,
            9795287
          ]
        },
        {
          "name": "Lithuania",
          "value": [
            23.897,
            55.336,
            3425077
          ]
        },
        {
          "name": "Slovakia",
          "value": [
            19.491,
            48.707,
            5386995
          ]
        },
        {
          "name": "Liechtenstein",
          "value": [
            9.555,
            47.153,
            34598
          ]
        },
        {
          "name": "The former Yugoslav Republic of Macedonia",
          "value": [
            21.698,
            41.6,
            2033655
          ]
        },
        {
          "name": "Malta",
          "value": [
            14.442,
            35.89,
            402617
          ]
        },
        {
          "name": "Belgium",
          "value": [
            4.664,
            50.643,
            10398049
          ]
        },
        {
          "name": "Faroe Islands",
          "value": [
            -6.864,
            62.05,
            48205
          ]
        },
        {
          "name": "Andorra",
          "value": [
            1.576,
            42.549,
            73483
          ]
        },
        {
          "name": "Luxembourg",
          "value": [
            6.088,
            49.771,
            456613
          ]
        },
        {
          "name": "Monaco",
          "value": [
            7.412,
            43.75,
            325
          ]
        },
        {
          "name": "Montenegro",
          "value": [
            19.254,
            42.792,
            607969
          ]
        },
        {
          "name": "Netherlands",
          "value": [
            5.389,
            52.077,
            1632769
          ]
        },
        {
          "name": "Norway",
          "value": [
            8.74,
            61.152,
            4638836
          ]
        },
        {
          "name": "Poland",
          "value": [
            19.401,
            52.125,
            38195558
          ]
        },
        {
          "name": "Portugal",
          "value": [
            -8.058,
            40.309,
            10528226
          ]
        },
        {
          "name": "Romania",
          "value": [
            24.969,
            45.844,
            21627557
          ]
        },
        {
          "name": "Republic of Moldova",
          "value": [
            28.599,
            47.193,
            3876661
          ]
        },
        {
          "name": "Slovenia",
          "value": [
            14.827,
            46.124,
            1999425
          ]
        },
        {
          "name": "Spain",
          "value": [
            -3.649,
            40.227,
            43397491
          ]
        },
        {
          "name": "Sweden",
          "value": [
            15.27,
            62.011,
            9038049
          ]
        },
        {
          "name": "Switzerland",
          "value": [
            7.908,
            46.861,
            7424389
          ]
        },
        {
          "name": "Turkey",
          "value": [
            35.179,
            39.061,
            72969723
          ]
        },
        {
          "name": "United Kingdom",
          "value": [
            -1.6,
            53,
            60244834
          ]
        },
        {
          "name": "Ukraine",
          "value": [
            31.388,
            49.016,
            46917544
          ]
        },
        {
          "name": "San Marino",
          "value": [
            12.46,
            43.942,
            30214
          ]
        },
        {
          "name": "Serbia",
          "value": [
            20.806,
            44.032,
            9863026
          ]
        },
        {
          "name": "Holy See (Vatican City)",
          "value": [
            12.451,
            41.904,
            783
          ]
        },
        {
          "name": "Russia",
          "value": [
            96.689,
            61.988,
            143953092
          ]
        }
      ],
      "encode": {
        "value": 2,
        "lng": 0,
        "lat": 1
      }
    }
  ]
}

Below are the properties and their corresponding values within the JSON data.

Property	Description/Value
tooltip -> trigger	This string indicates that when the user hovers the mouse over a location, the details will be shown as tooltip. Value - "item"
series -> name	Specify the title for the points to show when the mouse hovers on it.
series -> type	It is a type of data visualization that plots markers on a map using geographic coordinates. The distribution of markers can reveal patterns and density. Value - "scatter"
series -> coordinateSystem	Value - "gmap"
series -> itemStyle -> color	Set the hex color code for the geo nodes.
data -> name	Provide the string value(s) to label the geo nodes.
data -> value	Provide the latitude and longitude arrays for the nodes to be displayed on the map.

Interaction

Chart Event Handlers

Event	Description
Map Ready	This event is triggered when the map is loaded and ready for the view.
Zoom Level Change	This event is fired when the user increase or decreases the zoom level value.
Center Position Change	This event is fired when the user moves the center position of the map.

Event Handlers

Event	Description
Click	The 'Click' event is fired when user clicks on the map.

Layout

Hide

This sets whether the widget has to be displayed on the screen when the program is loaded. This shows/hides the widget both on desktop and mobile devices.

Set the visibility