v.alkis.buildings.import.html

<h2>DESCRIPTION</h2>

<em>v.alkis.buildings.import</em> 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 (<b>file</b> option).
Or given directly as input, comma-separated for multiple federal_states (<b>federal_state</b> 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 <b>aoi_map</b> option, or by using the <b>-r</b> flag.
With <b>aoi_map</b>, the data are imported only for the given vector map (given in GRASS DB).
With the <b>-r</b> flag, the data are imported only for the current set region.
<p>
Implemented federal state options are:
<ul>
    <li>Baden-Würrtemberg: only local data</li>
    <li>Berlin</li>
    <li>Brandenburg</li>
    <li>Hessen</li>
    <li>Nordrhein-Westfalen</li>
    <li>Sachsen</li>
</ul>

For local data import the parameter <b>local_data_dir</b> has to be given and
the folder structure has to be as follows:
<div class="code"><pre>
/path/to/ALKIS_buildings/
├── BW/*.gpkg
└── NW/*.shp
└── ...
</pre></div>
If local data does not overlap with AOI, data will be downloaded from Open Data
portals if federal state supports Open Data.

<h2>REQUIREMENTS</h2>

<div class="code"><pre>py7zr</pre></div>,
<div class="code"><pre>grass-gis-helpers</pre></div> need to be installed.

<h2>EXAMPLE</h2>

<h3>Load all available ALKIS building data with federal state information given by <b>federal_state</b> option</h3>

<div class="code"><pre>
v.alkis.buildings.import output=alkis_buildings federal_state=Nordrhein-Westfalen
</pre></div>

<h3>Load all available ALKIS building data with federal state information given by <b>file</b> option</h3>

<div class="code"><pre>
v.check.bundesland input=polygon_aoi file=federal_state.txt
v.alkis.buildings.import output=alkis_buildings file=federal_state.txt
</pre></div>

With file content of <tt>federal_state.txt</tt>:

<div class="code"><pre>
Berlin,Brandenburg
</pre>

<h3>Load ALKIS building data for AOI given by <tt>aoi_map_example</tt></h3>

<div class="code"><pre>
v.alkis.buildings.import output=alkis_buildings federal_state=Nordrhein-Westfalen aoi_map=aoi_map_example
</pre></div>

<h3>Load ALKIS building data for current set region</h3>

<div class="code"><pre>
v.alkis.buildings.import output=alkis_buildings federal_state=Nordrhein-Westfalen -r
</pre></div>

<h3>Load ALKIS building data from local file</h3>

<div class="code"><pre>
v.alkis.buildings.import aoi_map=AOI_BW output=buildings_bw federal_state=Baden-Württemberg local_data_dir=/path/to/ALKIS_buildings/
</pre></div>


<h2>SEE ALSO</h2>

<em>
<a href="v.import.html">v.import</a>
</em>

<h2>AUTHORS</h2>

Lina Krisztian, <a href="https://www.mundialis.de/">mundialis</a>
Anika Weinmann, <a href="https://www.mundialis.de/">mundialis</a>
Julia Haas, <a href="https://www.mundialis.de/">mundialis</a>