https://github.com/eurostat/eurostat-map
Thematic web maps based on D3 🗺️
https://github.com/eurostat/eurostat-map
cartography choropleth choropleth-map choropleth-maps eurostat eurostat-map eurostat-map-js eurostatmap eurostatmap-js gis map mapping maps nuts proportional-symbol-maps statistics svg thematic-maps topojson web-mapping
Last synced: 7 months ago
JSON representation
Thematic web maps based on D3 🗺️
- Host: GitHub
- URL: https://github.com/eurostat/eurostat-map
- Owner: eurostat
- License: eupl-1.2
- Created: 2020-10-26T15:53:55.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2025-02-24T15:27:04.000Z (7 months ago)
- Last Synced: 2025-02-24T19:05:07.078Z (7 months ago)
- Topics: cartography, choropleth, choropleth-map, choropleth-maps, eurostat, eurostat-map, eurostat-map-js, eurostatmap, eurostatmap-js, gis, map, mapping, maps, nuts, proportional-symbol-maps, statistics, svg, thematic-maps, topojson, web-mapping
- Language: JavaScript
- Homepage: https://github.com/eurostat/eurostat-map.js
- Size: 196 MB
- Stars: 66
- Watchers: 5
- Forks: 5
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# [eurostat-map](https://github.com/eurostat/eurostat-map)
Based on D3 and designed for Eurostat data but compatible with custom geometries and stats.
---
## Table of Contents
- [eurostat-map](#eurostat-map)
- [Table of Contents](#table-of-contents)
- [Examples](#examples)
- [Installation](#installation)
- [Node.js](#nodejs)
- [Standalone](#standalone)
- [Documentation](#documentation)
- [Technical details](#technical-details)
- [About](#about)
- [Contribute](#contribute)
- [Copyright](#copyright)
- [Disclaimer](#disclaimer)
---
## Examples
You can build an interactive statistical map with just a few lines of code:
```javascript
eurostatmap
.map('choropleth') // Specify the map type
.title('Population density in Europe') // Add a title
.stat({ eurostatDatasetCode: 'demo_r_d3dens', unitText: 'people/km²' }) // Configure dataset
.legend({ x: 500, y: 180, title: 'Density, people/km²' }) // Add a legend
.build() // Build the map
```
For a quick tutorial check out this notebook:
https://observablehq.com/@joewdavies/eurostat-map-js
- [Population density](https://eurostat.github.io/eurostat-map/examples/population-density.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/population-density.html))
- [Population map with proportional circles](https://eurostat.github.io/eurostat-map/examples/prop-circles.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/prop-circles.html))
- [GDP map with custom proportional symbols](https://eurostat.github.io/eurostat-map/examples/prop-symbols.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/prop-symbols.html))
- [Causes of death with proportional pie charts](https://eurostat.github.io/eurostat-map/examples/prop-piecharts.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/prop-piecharts.html))
- [Population change ](https://eurostat.github.io/eurostat-map/examples/population-change.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/population-change.html))
- [NUTS typology as a categorical map](https://eurostat.github.io/eurostat-map/examples/categorical.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/categorical.html))
- [Focus on Spain](https://eurostat.github.io/eurostat-map/examples/spain.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/spain.html))
- [20 years of GDP change in Europe](https://eurostat.github.io/eurostat-map/examples/small_multiple.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/small_multiple.html))
- [Unemployment/population relation](https://eurostat.github.io/eurostat-map/examples/pop-unemploy-bivariate.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/pop-unemploy-bivariate.html))
- [Farm sizes composition](https://eurostat.github.io/eurostat-map/examples/farm_size.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/farm_size.html))
- [Livestock composition](https://eurostat.github.io/eurostat-map/examples/livestock_composition.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/livestock_composition.html))
- [Sparklines: Population in Europe since 2012](https://eurostat.github.io/eurostat-map/examples/sparklines.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/sparklines.html))
- [World map](https://eurostat.github.io/eurostat-map/examples/world.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/world.html))
- [Flow map](https://eurostat.github.io/eurostat-map/examples/flowmap.html) (see [the code](https://github.com/eurostat/eurostat-map/blob/master/examples/flowmap.html))
## Installation
### Node.js
```npm
npm install eurostatmap
```
then
```javascript
import eurostatmap from 'eurostatmap'
```
or
```javascript
eurostatmap = require('eurostatmap')
```
### Standalone
For the latest version, use:
```html
```
For a fixed version, use:
```html
```
where X.Y.Z is a [version number](https://www.npmjs.com/package/eurostat-map?activeTab=versions).
## Documentation
For detailed documentation see the **[API reference page](docs/reference.md)**.
Code examples:
- For a [choropleth map](docs/reference.md#choropleth-map),
- For a [proportional symbol map](docs/reference.md#proportional-symbol-map),
- For a [proportional pie chart map](docs/reference.md#proportional-pie-chart-map),
- For a [categorical map](docs/reference.md#categorical-map).
- For a [bivariate choropleth map](docs/reference.md#bivariate-choropleth-map).
- For a [stripe composition map](docs/reference.md#stripe-composition-map).
- For a [sparkline map](docs/reference.md#sparkline-map).
- For a [flow map](docs/reference.md#flow-map).
Anything unclear or missing? Feel free to [ask](https://github.com/eurostat/eurostat.js/issues/new) !
## Technical details
Maps based on [NUTS regions](http://ec.europa.eu/eurostat/web/nuts/overview) rely on [Nuts2json API](https://github.com/eurostat/Nuts2json) and [TopoJSON](https://github.com/mbostock/topojson/wiki) format. Statistical data are accessed using [Eurostat STATISTICS API](https://wikis.ec.europa.eu/display/EUROSTATHELP/API+-+Getting+started+with+statistics+API) for [JSON-stat](https://json-stat.org/) data. The data are decoded and queried using [JSON-stat library](https://json-stat.com/). Maps are rendered as SVG maps using [D3.js library](https://d3js.org/).
## About
| | |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| _contributors_ | [
](https://github.com/jgaffuri) [
](https://github.com/JoeWDavies) |
| _version_ | See [npm](https://www.npmjs.com/package/eurostat-map?activeTab=versions) |
| _status_ | Since 2018 |
| _license_ | [EUPL 1.2](https://github.com/eurostat/Nuts2json/blob/master/LICENSE) |
## Contribute
Feel free to [ask for assistance](https://github.com/eurostat/eurostat.js/issues/new), fork the project or simply star it (it's always a pleasure).
## Copyright
The [Eurostat NUTS dataset](http://ec.europa.eu/eurostat/web/nuts/overview) is copyrighted. There are [specific provisions](https://ec.europa.eu/eurostat/web/gisco/geodata/statistical-units) 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](https://ec.europa.eu/eurostat/web/gisco/geodata/statistical-units) 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.