{"id":20652346,"url":"https://github.com/openpolis/geojson-italy","last_synced_at":"2025-04-07T13:09:02.297Z","repository":{"id":50025020,"uuid":"199606334","full_name":"openpolis/geojson-italy","owner":"openpolis","description":"Geojson and topojson files for all municipalities, by regions and provinces","archived":false,"fork":false,"pushed_at":"2024-05-14T09:45:31.000Z","size":187813,"stargazers_count":218,"open_issues_count":8,"forks_count":55,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-03-31T11:06:39.769Z","etag":null,"topics":["administrative-divisions","geodata","geojson","italy","mapshaper","open-datasets","topojson"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/openpolis.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2019-07-30T08:11:50.000Z","updated_at":"2025-03-24T16:14:00.000Z","dependencies_parsed_at":"2023-01-18T09:00:59.798Z","dependency_job_id":"cf54f961-2683-4943-8f67-8cc136c62b70","html_url":"https://github.com/openpolis/geojson-italy","commit_stats":{"total_commits":85,"total_committers":5,"mean_commits":17.0,"dds":0.3647058823529412,"last_synced_commit":"d875e7c13a74727f584a5916bf83a2c4891756f5"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openpolis%2Fgeojson-italy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openpolis%2Fgeojson-italy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openpolis%2Fgeojson-italy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openpolis%2Fgeojson-italy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openpolis","download_url":"https://codeload.github.com/openpolis/geojson-italy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247657281,"owners_count":20974345,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["administrative-divisions","geodata","geojson","italy","mapshaper","open-datasets","topojson"],"created_at":"2024-11-16T17:34:05.469Z","updated_at":"2025-04-07T13:09:02.274Z","avatar_url":"https://github.com/openpolis.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Introduction\n\nThis repository contains geo-referenced limits for all municipalities in Italy,\nand their breakdown by regions and provinces.\n\nThe [geographic projection](https://github.com/d3/d3-geo) used is WGS84.\n\nThe limits are released both in [topojson](https://github.com/topojson/topojson) with a high simplification rate (20%),\nand the non-simplified [geojson](https://geojson.org/) format.\n\nAs administrative limits change continuously, the files are upgraded periodically, and refer to the **latest** administrative subdivisions, as published by [ISTAT](https://www.istat.it/) in [this permalink](https://www.istat.it/it/archivio/222527) (hoping it's actually a **permalink**).\n\nHistorical versions, year by year, are published as tags, currently only 2019 and 2021 are present.\n\nThe master branch currently contains limits as of June 2023.\n\n# Attribution\nThe original administrative limits data are copyrighted by ISTAT, that releases them under the CC-BY license.\nThe data generated and published here are released under the same CC-BY license.\n\n# Geojson files\nThese files are **not simplified**, contain a large number of vectors, and can only contain one layer.\nThey are compatible with almost all visualisers and applications, and can be used to integrate geographic information,\nalmost as ubiquitously as shp files.\n\nAs of June 2023 (tag 2023.1), the geojson files are produced using the `gj2008` flag of mapshaper, in order to make them compatile with the pre-RFC 7946 GeoJSON spec, and with the D3 javascript library, and other libraries using D3 underneath, as Plotly, for example.\nYou can find the original discussion in [this mapshaper's issue](https://github.com/mbloch/mapshaper/issues/432#issuecomment-675775465).\n\nThe following files are available:\n- [geojson/limits_IT_municipalities.geojson](https://github.com/openpolis/geojson-italy/blob/master/geojson/limits_IT_municipalities.geojson) - all Italian municipalities, ~40MB\n- [geojson/limits_IT_provinces.geojson](https://github.com/openpolis/geojson-italy/blob/master/geojson/limits_IT_provinces.geojson) - all Italian provinces\n- [geojson/limits_IT_regions.geojson](https://github.com/openpolis/geojson-italy/blob/master/geojson/limits_IT_regions.geojson) - all Italian regions\n- geojson/limits_R_{code}_municipalities.geojson - all municipalities in a region (R is the ISTAT numerical code of the region, ex: [geojson/limits_R_12_municipalities.geojson](https://github.com/openpolis/geojson-italy/blob/master/geojson/limits_R_12_municipalities.geojson) - Lazio region)\n- geojson/limits_P_{code}_municipalities.geojson - all munitipalities in a province (P is the ISTAT numerical code of the province, ex: [geojson/limits_P_58_municipalities.geojson](https://github.com/openpolis/geojson-italy/blob/master/geojson/limits_P_58_municipalities.geojson) - Rome province)\n\nPlease consider that maps preview for geojson data are only available for files of limited size in github.com; use [mapshaper](https://mapshaper.org) to see and explore larger files.\n\n\n# Topojson files\nThese files are **simplified**, **smaller**, but **less precise**, and contains **a lot less vectors** than the corresponding `geojson` files, can contain **many layers**, and can be used in compatible map visualisers ([leaflet](https://webkid.io/blog/maps-with-leaflet-and-topojson/), [d3](https://bl.ocks.org/almccon/410b4eb5cad61402c354afba67a878b8), mapshaper).\n\nThe following `topojson` files are available:\n- [topojson/limits_IT_all.topo.json](https://github.com/openpolis/geojson-italy/blob/master/topojson/limits_IT_all.topo.json) - all municipalities, provinces and regions (3 layers), ~4MB\n- [topojson/limits_IT_municipalities.topo.json](https://github.com/openpolis/geojson-italy/blob/master/topojson/limits_IT_municipalities.topo.json) - all Italian municipalities (1 layer), ~4MB\n- [topojson/limits_IT_provinces.topo.json](https://github.com/openpolis/geojson-italy/blob/master/topojson/limits_IT_provinces.topo.json) - all Italian provinces (1 layer)\n- [topojson/limits_IT_regions.topo.json](https://github.com/openpolis/geojson-italy/blob/master/topojson/limits_IT_regions.topo.json) - all Italian regions (1 layer)\n- topojson/limits_R_{code}_municipalities.topo.json - all municipalities in a region (R is the ISTAT numerical code of the region, for ex: [topojson/limits_R_12_municipalities.topo.json](https://github.com/openpolis/geojson-italy/blob/master/topojson/limits_R_12_municipalities.topo.json) - Lazio region)\n- topojson/limits_P_{code}_municipalities.topo.json - all munitipalities in a province (P is the ISTAT numerical code of the province, for ex: [topojson/limits_P_58_municipalities.topo.json](https://github.com/openpolis/geojson-italy/blob/master/topojson/limits_P_58_municipalities.topo.json) - Rome province)\n\nPlease consider that maps preview for topojson data are not available on github.com; use [mapshaper](https://mapshaper.org) to see the files.\n\n# Metadata\nEach geographic area has the following metadata:\n- `name` (M) - the name of the municipality\n- `com_catasto_code` (M) - the cadaster code (H501)\n- `com_istat_code` (M) - the ISTAT code, as text (zero-padded)\n- `com_istat_code_num` (M) - the ISTAT code, as integer\n- `op_id` (M) - the openpolis ID (for integration with legacy OP data)\n- `opdm_id` (M) - the opdm ID (for integration with OPDM data)\n- `minint_elettorale` (M) - interior minister ID\n- `prov_name` (M,P) - parent province name\n- `prov_istat_code` (M,P) - parent province ISTAT code, as text (zero-padded)\n- `prov_istat_code_num` (M,P) - parent province ISTAT code, as integer\n- `prov_acr` (M,P,R) - parent province acronym (ex: RM)\n- `reg_name` (M,P,R) - parent region full name\n- `reg_istat_code` (M,P,R) - parent region ISTAT code, as text (zero padded)\n- `reg_istat_code_num` (M,P,R) - parent region ISTAT code, as number\n\nIn parenthesis, the contexts where these properties can be found:\n- M: Municipalities,\n- P: Provinces,\n- R: Regions\n\n# Developers\nTo generate all files, starting from the `comuni.geojson` file:\n```\n  ./generate_geojson.sh\n  ./generate_topojson.sh\n```\nThe [mapshaper client](https://github.com/mbloch/mapshaper), based on [node js](https://nodejs.org/en/), is **required** by the scripts to work. These are currently based on mapshaper version `0.6.65`\n\nHow the `comuni.geojson` file is generated, and other scripts' internals are described in [this wiki page](https://github.com/openpolis/geojson-italy/wiki/How-to-generate-the-limits-files).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenpolis%2Fgeojson-italy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenpolis%2Fgeojson-italy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenpolis%2Fgeojson-italy/lists"}