Skip to content

eurostat/euronym

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Euronym

Place name labels for multi-scale web mapping applications, with a focus on Europe.

Euronym labels are produced using a label placement algorithm to adapt the density, selection and size of labels depending on the zoom level and label importance.

Example

Euronym is used by Gridviz library. See this example.

API

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

URL pattern: /<ENCODING>/<RESOLUTION>/<GEO>.csv

For example, https://raw.githubusercontent.com/eurostat/euronym/main/pub/v2/UTF/100/LU.csv returns UTF data for resolution 100m/pixel over Luxembourg.

The parameters are:

Parameter Supported values Description
ENCODING UTF_LATIN UTF ASCII The encoding. By default, you should use UTF_LATIN.
RESOLUTION 20 50 100 200 The most detailled resolution. The unit is the zoom level of your visualisation expressed in m/pixel. If small, more labels are necessary and the file gets larger.
GEO See for example here. EUR is for the entire dataset. The code of the geographic entity to cover.

For additional parameters, feel free to ask !

Format

A CSV file with the following columns:

Column Description
name The place name text, to be written on the map.
lon The longitude.
lat The latitude.
rs Above this resolution, the label should not be shown.
r1 Above this resolution, the label may be exagerated.
cc The country code. This is provided when GEO is set to EUR. This allows doing some filtering based on country.

The resolutions are expressed in m/pixel: This is the size of a screen pixel in ground meter. The smaller, the more detail.

rs and r1 values are computed so that:

  • For resolutions above rs, the label should not be shown,
  • For resolutions within [rs, r1], the label should be shown with a 1em size,
  • For resolutions above r1, the label should be shown with a 1.5em size (that is exagerated).

Longitude and latitude are expressed in ETRS89 (EPSG 4258), which can be considered as identical to WGS84.

Input data

Euronym relies on the following datasets:

The transformation process is available here, based on GeoTools library.

Own deployment

To deploy your own stable version of Euronym, 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.

About

contributors
version 3
status Since 2022
license EuroGeographics Open Data Licence, EUPL 1.2 for the code.

Support and contribution

Feel free to ask support, fork the project or simply star it (it's always a pleasure).

Copyright

The copyright of the input datasets apply:

  • EuroGeographics Open Data Licence. EuroRegionalMap dataset is protected by copyright and other applicable laws. It is provided under the terms of this licence, which you accept by using it and accepting the terms of the licence. Note that © EuroGeographics 2024 attribution must be added.

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.