{"id":17526239,"url":"https://github.com/eurostat/eurostat-map","last_synced_at":"2026-04-02T14:54:44.976Z","repository":{"id":42435616,"uuid":"307425374","full_name":"eurostat/eurostat-map","owner":"eurostat","description":"Thematic web maps based on D3 🗺️","archived":false,"fork":false,"pushed_at":"2026-03-19T17:52:09.000Z","size":404504,"stargazers_count":92,"open_issues_count":13,"forks_count":8,"subscribers_count":6,"default_branch":"master","last_synced_at":"2026-03-20T06:23:30.181Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"https://eurostat.github.io/eurostat-map/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"eupl-1.2","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eurostat.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-10-26T15:53:55.000Z","updated_at":"2026-03-19T17:52:13.000Z","dependencies_parsed_at":"2026-02-20T20:02:16.325Z","dependency_job_id":null,"html_url":"https://github.com/eurostat/eurostat-map","commit_stats":{"total_commits":1241,"total_committers":6,"mean_commits":"206.83333333333334","dds":0.4528605962933119,"last_synced_commit":"47cd13d1124ed04ee77c82230f4c9b88e7eb60b2"},"previous_names":["eurostat/eurostat-map","eurostat/eurostat-map.js"],"tags_count":90,"template":false,"template_full_name":null,"purl":"pkg:github/eurostat/eurostat-map","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eurostat%2Feurostat-map","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eurostat%2Feurostat-map/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eurostat%2Feurostat-map/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eurostat%2Feurostat-map/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eurostat","download_url":"https://codeload.github.com/eurostat/eurostat-map/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eurostat%2Feurostat-map/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31308448,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2024-10-20T15:01:28.957Z","updated_at":"2026-04-02T14:54:44.970Z","avatar_url":"https://github.com/eurostat.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/bundlephobia/min/eurostat-map\" alt=\"npm bundle size\"\u003e\n  \u003cimg src=\"https://img.shields.io/npm/v/eurostat-map\" alt=\"npm\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-EUPL-success\" alt=\"license\"\u003e\n  \u003ca href=\"http://www.awesomeofficialstatistics.org\"\u003e\u003cimg src=\"https://awesome.re/mentioned-badge.svg\" alt=\"Mentioned in Awesome Official Statistics\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n\u003cbr\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/eurostat/eurostat-map/master/docs/img/eurostat-map-logo-cropped.png\" alt=\"examples\" width=\"400\"/\u003e\n\u003c/div\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003cem\u003eCustomizable thematic maps. See \u003cstrong\u003e\u003ca href=\"docs/reference.md\"\u003edocumentation\u003c/a\u003e\u003c/strong\u003e.\u003c/em\u003e\n\u003c/div\u003e\n\n\u003chr\u003e\n\n\u003cdiv align=\"center\"\u003e\nBased on D3 and designed for Eurostat data but compatible with custom geometries and stats. \n\u003c/div\u003e\n\u003cdiv align=\"center\"\u003e\n    Check out \u003ca href=\"https://observablehq.com/collection/@eurostat-ws/eurostatmap-js\" target=\"_blank\"\u003ethis observable notebook\u003c/a\u003e for a quickstart guide.\n\u003c/div\u003e\n\u003cbr\u003e\n\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://eurostat.github.io/eurostat-map/examples/population-density.html\" target=\"_blank\"\u003e \u003cimg src=\"https://raw.githubusercontent.com/eurostat/eurostat-map/master/docs/img/examples.gif\" alt=\"examples\" width=\"600\"/\u003e \u003c/a\u003e\n\u003c/div\u003e\n\n---\n\n## Table of Contents\n\n- [Examples](#examples)\n- [Installation](#installation)\n- [Documentation](#documentation)\n- [Technical details](#technical-details)\n- [About](#about)\n- [Contribute](#contribute)\n- [Copyright](#copyright)\n- [Disclaimer](#disclaimer)\n\n---\n\n## Examples\n\nYou can build an interactive statistical map with just a few lines of code:\n\n```javascript\nconst map = eurostatmap\n    .map('choropleth') // Specify the map type\n    .title('Population density in Europe') // Add a title\n    .stat({ eurostatDatasetCode: 'demo_r_d3dens', unitText: 'people/km²' }) // Configure dataset\n    .legend({ x: 500, y: 180, title: 'Density, people/km²' }) // Add a legend\n    .build() // Build the map\n\n// Or you can use your own statistics like so:\nmap.statData().setData({ ES: 3, FR: 2, DE: 5 })\n```\n\nFor a quick tutorial check out this notebook:\nhttps://observablehq.com/@joewdavies/eurostat-map-js\n\n- [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))\n- [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))\n- [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))\n- [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))\n- [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))\n- [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))\n- [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))\n- [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))\n- [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))\n- [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))\n- [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))\n- [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))\n- [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))\n\n## Installation\n\n### Node.js\n\n```npm\nnpm install eurostat-map\n```\n\nthen\n\n```javascript\nimport eurostatmap from 'eurostatmap'\n```\n\nor\n\n```javascript\neurostatmap = require('eurostatmap')\n```\n\n### Standalone\n\nFor the latest version, use:\n\n```html\n\u003cscript src=\"https://unpkg.com/eurostat-map\"\u003e\u003c/script\u003e\n```\n\nFor a fixed version, use:\n\n```html\n\u003cscript src=\"https://unpkg.com/eurostat-map@X.Y.Z\"\u003e\u003c/script\u003e\n```\n\nwhere X.Y.Z is a [version number](https://www.npmjs.com/package/eurostat-map?activeTab=versions).\n\n## Documentation\n\nFor detailed documentation see the **[API reference page](docs/reference.md)**.\n\nCode examples:\n\n- [Choropleth map](docs/reference.md#choropleth-map).\n- [Proportional symbol map](docs/reference.md#proportional-symbol-map).\n- [Pie chart map](docs/reference.md#proportional-pie-chart-map).\n- [Categorical map](docs/reference.md#categorical-map).\n- [Bivariate choropleth map](docs/reference.md#bivariate-choropleth-map).\n- [Stripe composition map](docs/reference.md#stripe-composition-map).\n- [Sparkline map](docs/reference.md#sparkline-map).\n- [Flow map](docs/reference.md#flow-map).\n- [Ternary choropleth](docs/reference.md#trivariate-choropleth-map).\n- [Coxcomb map](docs/reference.md#coxcomb-map).\n- [Mushroom map](docs/reference.md#mushroom-map).\n- [Waffle map](docs/reference.md#waffle-map).\n- [Cartograms](docs/reference.md#cartograms).\n\nAnything unclear or missing? Feel free to [ask](https://github.com/eurostat/eurostat.js/issues/new)!\n\n## Technical details\n\nMaps 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/). Custom data can also be used with `map.statData().setData({ES:3,FR:2,DE:5})`. Maps are rendered as SVG maps using [D3.js library](https://d3js.org/).\n\n## About\n\n|                |                                                                                                                                                                                       |\n| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| _contributors_ | [\u003cimg src=\"https://github.com/jgaffuri.png\" height=\"40\" /\u003e](https://github.com/jgaffuri) [\u003cimg src=\"https://github.com/JoeWDavies.png\" height=\"40\" /\u003e](https://github.com/JoeWDavies) |\n| _version_      | See [npm](https://www.npmjs.com/package/eurostat-map?activeTab=versions)                                                                                                              |\n| _status_       | Since 2018                                                                                                                                                                            |\n| _license_      | [EUPL 1.2](https://github.com/eurostat/Nuts2json/blob/master/LICENSE)                                                                                                                 |\n\n## Contribute\n\nFeel 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).\n\n## Copyright\n\nThe [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.\n\n## Disclaimer\n\nThe 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feurostat%2Feurostat-map","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feurostat%2Feurostat-map","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feurostat%2Feurostat-map/lists"}