v.alkis.buildings.import

NAME

v.alkis.buildings.import - Downloads and imports ALKIS building data (currently for Berlin, Brandenburg, Hessen, NRW, Sachsen) into GRASS DB

KEYWORDS

vector, import, ALKIS

SYNOPSIS

v.alkis.buildings.import

v.alkis.buildings.import --help

v.alkis.buildings.import [-dr] output=name [aoi_map=name] [local_data_dir=name] [file=name] [federal_state=string[,string,...]] [dldir=string[,string,...]] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-d: keep downloads
-r: Restrict ALKIS building data import to current region
--overwrite: Allow output files to overwrite existing files
--help: Print usage summary
--verbose: Verbose module output
--quiet: Quiet module output
--ui: Force launching GUI dialog

Parameters:

output=name [required]: Name for output vector map
aoi_map=name: Name of input vector map; Vector map to restrict ALKIS building import to
local_data_dir=name: Directory with vector map of ALKIS buildings to import
file=name: Text file containing comma separated federal states to load ALKIS building data for
federal_state=string[,string,...]: Federal state to load ALKIS building data for; Options: Brandenburg, Berlin, Baden-Württemberg, Bayern, Bremen, Hessen, Hamburg, Mecklenburg-Vorpommern, Niedersachsen, Nordrhein-Westfalen, Rheinland-Pfalz, Schleswig-Holstein, Saarland, Sachsen, Sachsen-Anhalt, Thüringen
dldir=string[,string,...]: Path of output folder; Path of folder for Download outputdata e.g./home/usr/alkis/output

DESCRIPTION
REQUIREMENTS
EXAMPLE
SEE ALSO
AUTHORS

DESCRIPTION

v.alkis.buildings.import downloads ALKIS building data and imports them into GRASS. Alternatively, local data can be imported. To download the data, the federal_state(s) of the area of interest has to be given. Either given in a text file, comma-separated for multiple federal_states (file option). Or given directly as input, comma-separated for multiple federal_states (federal_state option). Note: Importing all data for a complete federal state could fail, due to too small RAM. To avoid this, the data can be loaded for a smaller region, either by using the aoi_map option, or by using the -r flag. With aoi_map, the data are imported only for the given vector map (given in GRASS DB). With the -r flag, the data are imported only for the current set region.

Implemented federal state options are:

Baden-Würrtemberg: only local data
Berlin
Brandenburg
Hessen
Nordrhein-Westfalen
Sachsen

For local data import the parameter local_data_dir has to be given and the folder structure has to be as follows:

/path/to/ALKIS_buildings/
├── BW/*.gpkg
└── NW/*.shp
└── ...

If local data does not overlap with AOI, data will be downloaded from Open Data portals if federal state supports Open Data.

REQUIREMENTS

py7zr

grass-gis-helpers

need to be installed.

EXAMPLE

Load all available ALKIS building data with federal state information given by federal_state option

v.alkis.buildings.import output=alkis_buildings federal_state=Nordrhein-Westfalen

Load all available ALKIS building data with federal state information given by file option

v.check.bundesland input=polygon_aoi file=federal_state.txt
v.alkis.buildings.import output=alkis_buildings file=federal_state.txt

With file content of federal_state.txt:

Berlin,Brandenburg

Load ALKIS building data for AOI given by `aoi_map_example`

v.alkis.buildings.import output=alkis_buildings federal_state=Nordrhein-Westfalen aoi_map=aoi_map_example

Load ALKIS building data for current set region

v.alkis.buildings.import output=alkis_buildings federal_state=Nordrhein-Westfalen -r

Load ALKIS building data from local file

v.alkis.buildings.import aoi_map=AOI_BW output=buildings_bw federal_state=Baden-Württemberg local_data_dir=/path/to/ALKIS_buildings/

AUTHORS

Lina Krisztian, mundialis Anika Weinmann, mundialis Julia Haas, mundialis

SOURCE CODE

Available at: v.alkis.buildings.import source code (history)

Accessed: Monday Jul 27 12:30:38 2026