# Geo Map Charts

## 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- {% code overflow="wrap" %} ```json { "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 } } ] } ``` {% endcode %} 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.