Shell
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
2010 new version with generalised datasets Aug 9, 2018
2013
2016 fix error in 1:20M-2016 Aug 9, 2018
archives
examples a Aug 10, 2018
img a Aug 1, 2018
json
shp fix error in 1:20M-2016 Aug 9, 2018
.gitignore gitignore update Aug 10, 2016
0_all.sh a Aug 7, 2018
1_filter_project_clip.sh a Aug 9, 2018
2_extract_shp_by_level.sh a Aug 9, 2018
3_shp_to_geojson.sh a Aug 9, 2018
4_geojson_to_topojson.sh new version with generalised datasets Aug 9, 2018
5_simplify_topojson.sh new version with generalised datasets Aug 9, 2018
6_topojson_to_geojson.sh
LICENSE license text update Aug 11, 2016
README.md a Aug 9, 2018

README.md

Nuts2json

Nuts2json provides various reusable versions of Eurostat NUTS dataset as web formats such as TopoJSON and GeoJSON. It is provided to support the development of statistical web maps of Eurostat data based on NUTS regions. In a way, it provides a blank map of geometries ready for use with your own data and colors.

Examples: For an example of such blank map, see this map. For an example of statistical map, see this map showing population in Europe.

Example

API

The files can be retrieved on-the-fly from the base URL https://raw.githubusercontent.com/eurostat/Nuts2json/gh-pages/ according to one of these file patterns:

  • For TopoJSON format: /<YEAR>/<PROJECTION>/<SCALE>/<NUTS_LEVEL>.json
  • For GeoJSON format: /<YEAR>/<PROJECTION>/<SCALE>/<TYPE>[_<NUTS_LEVEL>].json

For example, https://raw.githubusercontent.com/eurostat/Nuts2json/gh-pages/2016/3035/20M/2.json returns a TopoJSON file of 2016 NUTS regions level 2 in European LAEA projection (EPSG 3035) at 1:20M scale.

The parameters are:

Parameter Supported values Description
YEAR 2016 2013 2010 The NUTS version.
PROJECTION 3035 3857 4258 The coordinate reference system EPSG code. Two projections are provided: European LAEA projection (EPSG 3035) and web mercator (EPSG 3857). For statistical maps, it is strongly adviced to use an equal-area projection such as 3035. Geographic coordinates ETRS89 (EPSG 4258) are provided.
SCALE 60M 20M 10M The intended map scale factor. The larger the value, the stronger the simplification. For example, for a map width of 1000 pixels the scale 1:20M is the most suitable.
NUTS_LEVEL 0 1 2 3 The NUTS level to be displayed on the map, from national (NUTS_LEVEL=0) to local level (NUTS_LEVEL=3).
TYPE nutsrg nutsbn cntrg cntbn gra For GeoJSON format, the feature type has to be specified. The available feature types are described below. For NUTS feature types (nutsrg and nutsbn), the NUTS_LEVEL to be displayed on the map has to be specified.

For additional projections, formats, scales, etc., feel free to ask !

Feature types

Five feature types are provided:

  • NUTS regions (feature type nutsrg) with the following properties:

    • id: The NUTS identifier to be used to join Eurostat statistical figures and then assign colors to the regions.
    • na: The geographical name of the region.
  • NUTS boundaries (feature type nutsbn) with the following properties:

    • lvl: The NUTS level of the boundary, from 0 (national level) to 3 (provincial level).
    • eu: T if the boundary separate two EU member states, F otherwise.
    • efta: T if the boundary touches at least one EFTA country, F otherwise.
    • cc: T if the boundary touches at least one Candidate Country, F otherwise.
    • oth: T if the boundary touches a country wich is not EU, EFTA,CC. F otherwise.
    • co: T if the boundary is coastal. F otherwise.
  • Non-european countries (feature type cntrg) with the following properties:

    • id: The country identifier (2 letters code).
    • na: The country name.
  • Non-european boundaries (feature type cntbn) with a single property:

    • co: T if the boundary is coastal. F otherwise.
  • The map graticule (meridian and parrallel lines) is provided as feature type gra with a single id property:

Usage example

A map showing the TopoJSON geometries with d3js:

(See it online here).

<!DOCTYPE html>
<svg></svg>
<script src="https://d3js.org/d3.v4.min.js"></script>
<script src="https://d3js.org/topojson.v1.min.js"></script>
<script>
d3.json("https://raw.githubusercontent.com/eurostat/Nuts2json/gh-pages/2016/3035/20M/3.json",
		function(error, nuts) {
	if (error) throw error;

	//prepare SVG element
	var width = 1000, height = width*(nuts.bbox[3]-nuts.bbox[1])/(nuts.bbox[2]-nuts.bbox[0]),
		svg = d3.select("svg").attr("width", width).attr("height", height)
		path = d3.geoPath().projection(d3.geoIdentity()
			.reflectY(true).fitSize([width,height], topojson.feature(nuts, nuts.objects.gra)));

	//draw graticule
	svg.append("g").selectAll("path").data(topojson.feature(nuts, nuts.objects.gra).features).enter()
		.append("path").attr("d", path)
		.style("fill","none").style("stroke-width","2px").style("stroke","lightgray");

	//draw country regions
	svg.append("g").selectAll("path").data(topojson.feature(nuts, nuts.objects.cntrg).features).enter()
		.append("path").attr("d", path)
		.style("fill","lightgray")
		.on("mouseover", function() { d3.select(this).style("fill", "darkgray");  })
		.on("mouseout",  function() { d3.select(this).style("fill", "lightgray"); });

	//draw nuts regions
	svg.append("g").selectAll("path").data(topojson.feature(nuts, nuts.objects.nutsrg).features).enter()
		.append("path").attr("d", path)
		.style("fill","#fdbf6f")
		.on("mouseover", function() { d3.select(this).style("fill", "#ff7f00"); })
		.on("mouseout",  function() { d3.select(this).style("fill", "#fdbf6f"); });

	console.log(nuts.objects.cntbn);

	//draw country boundaries
	svg.append("g").selectAll("path").data(topojson.feature(nuts, nuts.objects.cntbn).features).enter()
		.append("path").attr("d", path)
		.style("fill","none").style("stroke-width","1px")
		.style("stroke",function(bn){ if(bn.properties.co==="T") return "#1f78b4"; return "white"; });

	//draw nuts boundaries
	svg.append("g").selectAll("path").data(topojson.feature(nuts, nuts.objects.nutsbn).features).enter()
		.append("path").attr("d", path)
		.style("fill","none")
		.style("stroke",function(bn){
			if(bn.properties.co==="T") return "#1f78b4";
			if(bn.properties.oth==="T" || bn.properties.lvl==0) return "white"; return "#333"; })
		.style("stroke-width",function(bn){ if(bn.properties.lvl==3) return "0.5px"; return "1px"; });
});
</script>

For a map showing a choropleth map based on Eurostat statistical data API, see this map on EurostatVisu repo.

Technical details

These files are produced from the NUTS SHP files provided on Eurostat-GISCO website. The input SHP files are in the shp folder. These input files are transformed using GDAL and TopoJSON. The processes are automated in bash files, which are also shared in this repository.

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. See the Eurostat-GISCO website for more information.