eurostat-map
v4.0.8
Published
Reusable library to quickly create and customise web maps showing Eurostat data directly retrieved from Eurostat database.
Downloads
1,003
Readme
eurostat-map
Eurostat-map.js allows developers to quickly create and customise thematic web maps based on NUTS regions, showing Eurostat data directly retrieved from the Eurostat database, or custom data added manually.
Examples
You can build an interactive statistical map with just a few lines of code:
eurostatmap
.map('choropleth')
.title('Population density in Europe')
.stat({ eurostatDatasetCode: 'demo_r_d3dens', unitText: 'people/km²' })
.legend({ x: 500, y: 180, title: 'Density, people/km²' })
.build()
- Population density (see the code)
- Population density map with dot pattern (see the code)
- Population map with proportional circles (see the code)
- GDP map with custom proportional symbols (see the code)
- Causes of death with proportional pie charts (see the code)
- Population change (see the code)
- NUTS typology as a categorical map (see the code)
- Focus on Spain (see the code)
- 20 years of GDP change in Europe (see the code)
- Unemployment/population relation (see the code)
- Farm sizes composition (see the code)
- Livestock composition (see the code)
- Sparklines: Population in Europe since 2012 (see the code)
- World map (see the code)
Installation
Node.js
npm install eurostatmap
then
import eurostatmap from 'eurostatmap'
or
eurostatmap = require('eurostatmap')
Standalone
- For the latest version, use
<script src="https://unpkg.com/eurostat-map"></script>
as shown in the examples. - For a fixed version, use
<script src="https://unpkg.com/[email protected]"></script>
, where X.Y.Z is a version number.
Documentation
For a quick tutorial check out this notebook: https://observablehq.com/@joewdavies/eurostat-map-js
Or see the API reference:
- For a choropleth map,
- For a proportional symbol map,
- For a proportional pie chart map,
- For a categorical map.
- For a bivariate choropleth map.
- For a stripe composition map.
- For a sparkline map.
Anything unclear or missing? Feel free to ask !
Technical details
Maps based on NUTS regions rely on Nuts2json API and TopoJSON format. Statistical data are accessed using Eurostat STATISTICS API for JSON-stat data. The data are decoded and queried using JSON-stat library. Maps are rendered as SVG maps using D3.js library.
About
| | | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | contributors | | | version | See npm | | status | Since 2018 | | license | EUPL 1.2 |
Support and contribution
Feel free to ask support, fork the project or simply star it (it's always a pleasure).
Copyright
The Eurostat NUTS dataset is copyrighted. There are specific provisions for the usage of this dataset which must be respected. The usage of these data is subject to their acceptance. See the Eurostat-GISCO website for more information.
Disclaimer
The designations employed and the presentation of material on these maps do not imply the expression of any opinion whatsoever on the part of the European Union concerning the legal status of any country, territory, city or area or of its authorities, or concerning the delimitation of its frontiers or boundaries. Kosovo*: This designation is without prejudice to positions on status, and is in line with UNSCR 1244/1999 and the ICJ Opinion on the Kosovo declaration of independence. Palestine*: This designation shall not be construed as recognition of a State of Palestine and is without prejudice to the individual positions of the Member States on this issue.