{"id":18037454,"url":"https://github.com/fpgmaas/map-nl","last_synced_at":"2026-03-16T20:04:34.722Z","repository":{"id":210258115,"uuid":"719524495","full_name":"fpgmaas/map-nl","owner":"fpgmaas","description":"A Python package to help you quickly create PC4 maps of the Netherlands.","archived":false,"fork":false,"pushed_at":"2023-12-04T08:40:37.000Z","size":4862,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-05T20:16:15.456Z","etag":null,"topics":["geojson","geospatial","map","plot","postal-code","python","visualization"],"latest_commit_sha":null,"homepage":"https://fpgmaas.github.io/map-nl/","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/fpgmaas.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","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":"2023-11-16T10:58:53.000Z","updated_at":"2024-03-21T13:51:36.000Z","dependencies_parsed_at":"2023-12-10T20:40:05.089Z","dependency_job_id":"b089f4f0-7a37-4751-af78-a5f055f3564e","html_url":"https://github.com/fpgmaas/map-nl","commit_stats":{"total_commits":35,"total_committers":1,"mean_commits":35.0,"dds":0.0,"last_synced_commit":"8498322fd4746a01a945f52f2038b3637044b433"},"previous_names":["fpgmaas/map-nl"],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fpgmaas%2Fmap-nl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fpgmaas%2Fmap-nl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fpgmaas%2Fmap-nl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fpgmaas%2Fmap-nl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fpgmaas","download_url":"https://codeload.github.com/fpgmaas/map-nl/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222226132,"owners_count":16951818,"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":["geojson","geospatial","map","plot","postal-code","python","visualization"],"created_at":"2024-10-30T13:10:28.654Z","updated_at":"2026-03-16T20:04:34.673Z","avatar_url":"https://github.com/fpgmaas.png","language":"Python","readme":"\u003cp align=\"center\" style=\"margin: 30px 30px 40px 30px;\"\u003e\n  \u003cimg alt=\"map nl\" height=\"150\" src=\"https://github.com/fpgmaas/map-nl/blob/main/docs/static/nl.png?raw=true\"\u003e\n\u003c/p\u003e\n\n# map-nl\n\n[![Release](https://img.shields.io/github/v/release/fpgmaas/map-nl)](https://img.shields.io/github/v/release/fpgmaas/map-nl)\n[![Build status](https://img.shields.io/github/actions/workflow/status/fpgmaas/map-nl/main.yml?branch=main)](https://github.com/fpgmaas/map-nl/actions/workflows/main.yml?query=branch%3Amain)\n[![codecov](https://codecov.io/gh/fpgmaas/map-nl/branch/main/graph/badge.svg)](https://codecov.io/gh/fpgmaas/map-nl)\n[![Commit activity](https://img.shields.io/github/commit-activity/m/fpgmaas/map-nl)](https://img.shields.io/github/commit-activity/m/fpgmaas/map-nl)\n[![License](https://img.shields.io/github/license/fpgmaas/map-nl)](https://img.shields.io/github/license/fpgmaas/map-nl)\n\n_map-nl_ is a Python package to help you quickly create [PC4](https://www.cbs.nl/nl-nl/dossier/nederland-regionaal/geografische-data/gegevens-per-postcode) maps of the Netherlands, i.e. maps based on the numerical part of Dutch postal codes. While that is already possible without _map-nl_, this package aims to make the process a lot easier. It automatically downloads the geojson files, so all you need to provide is a dataset with two columns: One containing PC4 codes and one with a related value to plot on the map. _map-nl_ then uses [folium](https://github.com/python-visualization/folium) to plot the map.\n\nFor an example map created with _map-nl_, see [here](https://fpgmaas.github.io/map-nl/static/choropleth.html).\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://fpgmaas.github.io/map-nl\"\u003eDocumentation\u003c/a\u003e - \u003ca href=\"https://fpgmaas.github.io/map-nl/contributing/\"\u003eContributing\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## Quickstart\n\n### Installation\n\nTo install _map-nl_, simply run:\n\n```shell\npip install map-nl\n```\n\nor a similar command for your dependency manager.\n\n### Usage\n\nTo create a choropleth map of the average WOZ-value in the Netherlands, you could run the following:\n\n```py\nimport pandas as pd\nfrom map_nl import ChoroplethMapNL\n\ndf = pd.read_csv(\"https://raw.githubusercontent.com/fpgmaas/map-nl/main/data/woz-pc4.csv\")\n\nm = ChoroplethMapNL(geojson_simplify_tolerance=0.0001).plot(\n    df, pc4_column_name=\"pc4\", value_column_name=\"WOZ\", legend_name=\"Average WOZ Value\"\n)\nm.save(\"map.html\")\n```\n\nThis will download the geojson file to the `.map_nl` directory, simplify the geojson file to reduce the disk size of the plot, plot the map and save it to disk.\n\nFor more details, see [the documentation](https://fpgmaas.github.io/map-nl).\n\n### Attribution \u0026 License\n\nBy default, a geojson file with PC4 polygons is downloaded from [Opendatasoft.com](https://public.opendatasoft.com/explore/dataset/georef-netherlands-postcode-pc4/information/). The file is provided by Central Bureau voor de Statistiek \u0026 Basisregistratie Kadaster and usage of this file falls under the [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) license.\n\n---\n\nRepository initiated with [fpgmaas/cookiecutter-poetry](https://github.com/fpgmaas/cookiecutter-poetry).\n\nIcon created by \u003ca href=\"https://www.flaticon.com/free-icons/holland\" title=\"holland icons\"\u003eRoundicons - Flaticon\u003c/a\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffpgmaas%2Fmap-nl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffpgmaas%2Fmap-nl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffpgmaas%2Fmap-nl/lists"}