map-nl

map-nl is a Python package to help you quickly create PC4 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 to plot the map.

For an example map created with map-nl, see here.

Documentation - Contributing

Quickstart

Installation

To install map-nl, simply run:

pip install map-nl

or a similar command for your dependency manager.

Usage

To create a choropleth map of the average WOZ-value in the Netherlands, you could run the following:

import pandas as pd
from map_nl import ChoroplethMapNL

df = pd.read_csv("https://raw.githubusercontent.com/fpgmaas/map-nl/main/data/woz-pc4.csv")

m = ChoroplethMapNL(geojson_simplify_tolerance=0.0001).plot(
    df, pc4_column_name="pc4", value_column_name="WOZ", legend_name="Average WOZ Value"
)
m.save("map.html")

This 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.

For more details, see the documentation.

Attribution & License

By default, a geojson file with PC4 polygons is downloaded from Opendatasoft.com. The file is provided by Central Bureau voor de Statistiek & Basisregistratie Kadaster and usage of this file falls under the CC BY 4.0 license.

Repository initiated with fpgmaas/cookiecutter-poetry.

Icon created by Roundicons - Flaticon