How to use maps that are not provided by QueryViewer

Official Content
This documentation is valid for:

The QueryViewer control provides and supports the following maps:

  • World
  • All the continents
  • The following countries: 
    • Argentina
    • Brazil
    • Chile
    • China
    • Japan
    • Mexico
    • Paraguay
    • Spain
    • United States of America
    • Uruguay

These are the countries that are most used by the GeneXus community. With every map included in the QueryViewer the size of the deploy package increases. In order to keep it as small as possible no further maps will be, by default, included in QueryViewer. 

But you can still use any country you need. You simply have to follow the steps below: 

1) Access the following Github repository:

2) Choose the country map that you need and download it.

3) If you want to use ISO 3166-2 codes as the geographical dimension you will need to make some editions to the map as explained below.

4) Copy the downloaded map in the following GeneXus directories:

  • UserControls\QueryViewer\Echarts\countries
  • Packages\Reporting\QueryViewer\Echarts\countries

5) Restart GeneXus

How to add the iso code to a map?

To use a map from the Github repository above and use ISO 3166-2 codes as the geographical dimension you must edit and add the ISO 3166-2 codes for all the first level subdivisions of that country. 

To do so, open the js file of the required map (i.e. if you want to add the ISO 3166-2 codes of France, the map name will be fr-all.js).

In the fr-all.js file, inside the properties of each subdivision, add the "iso-code" property as shown in the following example:


You can find the iso code of each country and subdivision in ISO - International Organization for Standardization.


  • In the Github repository, you can find the map of a country named according to the ISO Code 3166. The structure of the name of any map is the following: (iso code 3166)-all.js. For example, if you need the map of France you have to look for the file with the name fr-all.js.
  • Please, don't change the name of the map that you downloaded from the Github repository.
  • In the same way you can define the property "center" to the different regions as shown in the following example:


This is useful when you use bubble maps (with ISO 3166 codes) and want the bubble to be centered in specific coordinates.
By default the position of the bubbles is calculated as the center of the region's polygon but for some areas that doesn't represent very well the main geographic area, or it's located outside the polygon for very irregular areas.

  • For download a map from github, there are some tips:

1. If you need all the country map collection you can download this in a zip folder:


2. If you need only some maps and you want to download individually, you can follow the next steps:

-Select the map of the country that you want 
-Select "Raw"
-Press "Ctrl+S" and you can save it with the original name.


See also

Maps in QueryViewer