{"id":16564733,"url":"https://github.com/hyperknot/country-levels","last_synced_at":"2025-03-21T11:32:52.923Z","repository":{"id":151175376,"uuid":"247505662","full_name":"hyperknot/country-levels","owner":"hyperknot","description":"Full planet GeoJSON extracts, based on ISO and FIPS codes.","archived":false,"fork":false,"pushed_at":"2020-05-07T17:49:46.000Z","size":6041,"stargazers_count":45,"open_issues_count":9,"forks_count":5,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-18T01:01:47.636Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hyperknot.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}},"created_at":"2020-03-15T16:30:00.000Z","updated_at":"2025-01-28T14:15:07.000Z","dependencies_parsed_at":null,"dependency_job_id":"839d1fe1-df84-4366-b74f-5fcc571c6bc3","html_url":"https://github.com/hyperknot/country-levels","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperknot%2Fcountry-levels","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperknot%2Fcountry-levels/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperknot%2Fcountry-levels/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperknot%2Fcountry-levels/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hyperknot","download_url":"https://codeload.github.com/hyperknot/country-levels/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244791587,"owners_count":20510972,"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":[],"created_at":"2024-10-11T20:44:53.127Z","updated_at":"2025-03-21T11:32:52.519Z","avatar_url":"https://github.com/hyperknot.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Country Levels\n\nCountry Levels project contains full planet GeoJSON extracts, based on ISO and FIPS codes.\n\nInternational data is based on OpenStreetMap and Wikidata. US data is from on US Census Bureau.\n\nBoth include up-to-date population numbers.\n\n#### [ISO country code list](https://github.com/hyperknot/country-levels-export/blob/master/docs/iso1_list.md)\n\nISO1 is referring to [ISO 3166-1](https://en.wikipedia.org/wiki/ISO_3166-1) country codes, for example `ES` for Spain.\n\n\u003cimg src=\"docs/assets/es_resize.jpg\" width=\"300\"\u003e\n\nISO2 is referring to [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) country codes, for example `ES-CL` for Castilla y León, Spain.\n\n\u003cimg src=\"docs/assets/cl_resize.jpg\" width=\"300\"\u003e\n\nGeoJSON files are served in different quality levels, *q5* refers to smallest, *q7* to medium and *q8* to higher quality extracts.\n\nYou can download the full planet dataset in ZIP in the [releases](https://github.com/hyperknot/country-levels/releases) tab.\n\nGeoJSON files and JSON catalogs are also browsable in the [export](https://github.com/hyperknot/country-levels-export) repo.\n\n\n#### [ISO country code list](https://github.com/hyperknot/country-levels-export/blob/master/docs/iso1_list.md)\n#### [US county list (FIPS codes)](https://github.com/hyperknot/country-levels-export/blob/master/docs/fips_list.md)\n\n\u003c!--[BR municipality list (IBGE codes)](https://github.com/hyperknot/country-levels-export/blob/master/docs/br_muni_list.md)--\u003e\n\n### Country Level IDs\n\nCountry level IDs are optional and are included with each GeoJSON. They simply concatenate the level + the ISO code with `:`\n\nFor example:\n\n- Spain is `iso1:ES`\n- Castilla y León is `iso2:ES-CL`\n- Santa Clara County, CA is `fips:06085`\n\n\n### License\n\nThe source code of this project is licensed under the MIT License.\n\nThe GeoJSON files are from OpenStreetMap, [© OpenStreetMap contributors](https://www.openstreetmap.org/copyright).\n\nPopulation information and corrections are from [Wikidata](https://www.wikidata.org/wiki/Wikidata:Main_Page), Public Domain [Creative Commons CC0 License](https://creativecommons.org/publicdomain/zero/1.0/).\n\nThe US County shapes and FIPS codes are from the [US Census Bureau](https://www.census.gov/geographies/mapping-files/time-series/geo/carto-boundary-file.html).\n\nBrazilian municipality data and IBGE codes are from [IBGE](http://www.ibge.gov.br/) - Brazilian Institute of Geography and Statistics.\n\n\n\nThe map screenshots in this readme [© Mapbox](https://www.mapbox.com/about/maps/) [© OpenStreetMap](https://openstreetmap.org/about/).\n\n\n\n#### Thanks\n\nThe land polygons are from Wambacher's [OSM Admin Boundaries Map](https://wambachers-osm.website/boundaries/).\n\n\n\n### Development\n\nIf you would like to develop or contribute, you'll need Python 3.7+ and Node with yarn.\n\nNote: this process will start a slow and delayed download from the OSM Admin map. It will take many hours, to make sure we are not overloading the server.\n\nSteps:\n\n1. Get a CLI key from [OSM Admin Boundaries Map](https://wambachers-osm.website/boundaries/) and replace `__CLI__KEY__` in `country_levels_lib/wam_download.py`.\n\n1. run `source prepare_virtualenv.sh`\n2. run `./process_all.sh`\n\nIf you have [direnv](https://direnv.net/) installed, the virtualenv will activate/deactivate automatically upon entering/exiting this project.\n\n\n\n### Lists\n\n#### [ISO country code list](https://github.com/hyperknot/country-levels-export/blob/master/docs/iso1_list.md)\n#### [US county list (FIPS codes)](https://github.com/hyperknot/country-levels-export/blob/master/docs/fips_list.md)\n\n\u003c!--[BR municipality list (IBGE codes)](https://github.com/hyperknot/country-levels-export/blob/master/docs/br_muni_list.md)--\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperknot%2Fcountry-levels","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhyperknot%2Fcountry-levels","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperknot%2Fcountry-levels/lists"}