mirror of
https://github.com/apache/superset.git
synced 2026-04-26 03:24:53 +00:00
63 lines
1.8 KiB
Plaintext
63 lines
1.8 KiB
Plaintext
---
|
|
title: Country Map Tools
|
|
hide_title: true
|
|
sidebar_position: 1
|
|
version: 1
|
|
---
|
|
|
|
## The Country Map Visualization
|
|
|
|
The Country Map visualization allows you to plot lightweight choropleth maps of
|
|
your countries by province, states, or other subdivision types. It does not rely
|
|
on any third-party map services but would require you to provide the
|
|
[ISO-3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) codes of your country's
|
|
top-level subdivisions. Comparing to a province or state's full names, the ISO
|
|
code is less ambiguous and is unique to all regions in the world.
|
|
|
|
## Included Maps
|
|
|
|
The Country Maps visualization already ships with the maps for the following countries:
|
|
|
|
- Belgium
|
|
- Brazil
|
|
- Bulgaria
|
|
- Canada
|
|
- China
|
|
- Egypt
|
|
- France
|
|
- Germany
|
|
- India
|
|
- Iran
|
|
- Italy
|
|
- Japan
|
|
- Korea
|
|
- Liechtenstein
|
|
- Morocco
|
|
- Myanmar
|
|
- Netherlands
|
|
- Portugal
|
|
- Russia
|
|
- Singapore
|
|
- Spain
|
|
- Switzerland
|
|
- Syria
|
|
- Thailand
|
|
- Timorleste
|
|
- Turkey
|
|
- UK
|
|
- Ukraine
|
|
- Uruguay
|
|
- USA
|
|
- Zambia
|
|
|
|
## Adding a New Country
|
|
|
|
To add a new country to the list, you'd have to edit files in
|
|
[@superset-ui/legacy-plugin-chart-country-map](https://github.com/apache-superset/superset-ui/tree/master/plugins/legacy-plugin-chart-country-map).
|
|
|
|
1. Generate a new GeoJSON file for your country following the guide in [this Jupyter notebook](https://github.com/apache/superset/blob/master/superset-frontend/plugins/legacy-plugin-chart-country-map/scripts/Country%20Map%20GeoJSON%20Generator.ipynb).
|
|
2. Edit the countries list in [legacy-plugin-chart-country-map/src/countries.ts](https://github.com/apache/superset/blob/master/superset-frontend/plugins/legacy-plugin-chart-country-map/src/countries.ts).
|
|
3. Install superset-frontend dependencies: `cd superset-frontend && npm install`
|
|
4. Verify your countries in Superset plugins storybook: `npm run plugins:storybook`.
|
|
5. Build and install Superset from source code.
|