Skip to content

Latest commit

 

History

History
177 lines (113 loc) · 13.6 KB

README.md

File metadata and controls

177 lines (113 loc) · 13.6 KB
Raw

Nuts2json

Nuts2json provides the Eurostat NUTS geometries 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 cartographic style.

Example Example

See some examples below.

For a faster creation of maps based on Nuts2json, check out eurostat-map.js.

For a faster creation of Dorling cartograms based on Nuts2json, check out NutsDorlingCartogram.

API

Base URL: https://raw.githubusercontent.com/eurostat/Nuts2json/master/pub/v2 (See here how to define your own base URL)

URL 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/master/pub/v2/2016/3035/20M/2.json returns a TopoJSON file of 2016 NUTS regions level 2 in European LAEA projection (EPSG 3035) for 1:20M scale.

The parameters are:

Parameter Supported values Description
YEAR 2024 2021 2016 2013 2010 The NUTS version.
PROJECTION 3035 3857 4326 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 WGS84 (EPSG 4326) are also provided.
SCALE 60M 20M 10M 03M 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 display, 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

The following 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 latin geographical name of the region.

  • NUTS boundaries (feature type nutsbn) with the following properties:

    • id: An identifier.
    • 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 at least one country which is not EU, EFTA,CC. F otherwise.
    • co: T if the boundary is coastal. F otherwise.

  • Countries (feature type cntrg) with the following properties:

    • id: The country identifier (2 letters ISO-code).
    • na: The latin country name.

  • Country boundaries (feature type cntbn) with the following properties:

    • id: An identifier.
    • 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 at least one country wich is not EU, EFTA,CC. F otherwise.
    • 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, which is the lat/lon of the parallel/meridian.

NUTS regions as points

NUTS regions are also provided as point geometries. These points can be used for label placement or simplified maps such as Dorling cartograms. Since this data does not depend on the <SCALE> parameter, it can be retrieved directly under the /<YEAR>/<PROJECTION>/nutspt_<NUTS_LEVEL>.json URL pattern, as GeoJSON format.

For example, https://raw.githubusercontent.com/eurostat/Nuts2json/master/pub/v2/2013/4326/nutspt_2.json returns a GeoJSON file of 2013 NUTS points level 2 in WGS84 (EPSG 4326) geographic coordinates.

The point features are provided with the following properties:

  • id: The NUTS identifier.
  • na: The latin geographical name of the region.
  • ar: The area of the region, in m².

Overseas territories - map insets

NUTS map insets overseas territories

To add map insets showing overseas territories or detail on small countries, dedicated files can be used. To access these files, the URL patterns are the same as the ones previously defined, except an additional GEO parameter has to be specified here: .../<YEAR>/<GEO>/<PROJECTION>/.... This parameter specifies the territory of interest. For example, https://raw.githubusercontent.com/eurostat/Nuts2json/master/pub/v2/2021/GF/32622/10M/1.json returns a TopoJSON file of 2021 NUTS regions level 1 on French Guiana overseas territory in UTM zone 22N projection at 1:10M scale.

The values supported for this additional GEO parameter are listed in the table below. For each of them, a specific projection is proposed, replacing the European LAEA projection when necessary. For all of them, an additional value for the SCALE parameter is available, 01M, corresponding to the 1:1M scale. The scale 60M, too coarse for these small territories, is not provided.

GEO Territory Specific projection
PT20 Azores 32626 - UTM zone 26N
PT30 Madeira 32628 - UTM zone 28N
IC Canary islands 32628 - UTM zone 28N
GF French Guiana 32622 - UTM zone 22N
GP Guadeloupe 32620 - UTM zone 20N
MQ Martinique 32620 - UTM zone 20N
CARIB Caribbean islands 32620 - UTM zone 20N
RE Réunion 32740 - UTM zone 40S
YT Mayotte 32738 - UTM zone 38S
MT Malta 3035 - European LAEA projection
LI Liechtenstein 3035 - European LAEA projection
IS Iceland 3035 - European LAEA projection
SJ_SV Svalbard 3035 - European LAEA projection
SJ_JM Jan Mayen 3035 - European LAEA projection

For additional territories, feel free to ask !

Some examples

These examples are based on d3js library.

Own deployment

To deploy your own stable version of Nuts2json, git clone the repository and simply publish the pub folder on your own web server folder accessible under the URL of your choice. Use the new base URL, for example https://www.mydomain.eu/path/to/pub/v2, to access the service. This offers the possibility to select only the necessary API elements of interest.

Technical details

These files are produced from the NUTS geodata provided on Eurostat-GISCO website. The entire process is automated in a Python script, which is available in the /src/py/ folder. This process has the following steps:

  1. download: Retrieve the input data from Eurostat GISCO API and stored it in a download folder.
  2. filterRenameDecomposeClean: Prepare input data: filter, rename attributes, decompose by NUTS level and clean some invalid geometries.
  3. coarseClipping: Apply a coarse data selection with clipping on the areas of interest.
  4. reprojectClipGeojson: Reproject, clip more precisely and convert as GeoJSON.
  5. topoGeojson: Make TopoJSON file from GeoJSON files, simplify them with TopoJSON Simplify program, and finally produce simplified GeoJSON from TopoJSON.
  6. points: Produce point representations.

Information on the NUTS versions to cover, the scales, projections, map insets and their extents, etc. is stored in the param.json file.

The software needed to run this process are the following:

About
contributors
version 1
status Since 2016
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.