Skip to content

eurostat/eurostat-map

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

npm bundle size npm license
Customizable thematic maps for global and regional data.
Based on D3 and designed for Eurostat data but compatible with custom geometries and stats.


Table of Contents


Examples

You can build an interactive statistical map with just a few lines of code:

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

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>
  • For a fixed version, use

    <script src="https://unpkg.com/eurostat-map@X.Y.Z"></script>

    where X.Y.Z is a version number.

Documentation

For detailed documentation see the API reference page.

For a quick tutorial check out this notebook: https://observablehq.com/@joewdavies/eurostat-map-js

Code examples:

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

Contribute

Feel free to ask for assistance, 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.