.. _vector.nas:

NAS - ALKIS
===========

.. shortname:: NAS

.. build_dependencies:: Xerces

The NAS driver reads the NAS/ALKIS format used for cadastral data in
Germany. The format is a GML profile with fairly complex GML3 objects
not easily read with the general OGR GML driver.

This driver depends on GDAL/OGR being built with the Xerces XML parsing
library.

The driver looks for "opengis.net/gml" and one of the strings semicolon
separated strings listed in the configuration option **NAS_INDICATOR** (which defaults
to "NAS-Operationen;AAA-Fachschema;aaa.xsd;aaa-suite") to determine if a
input is a NAS file and ignores all files without any matches.

The configuration option **NAS_GFS_TEMPLATE** makes it possible to cleanly map
element paths to feature attributes using a GFS file like in the GML
driver. Multiple geometries per layer are also possible (eg.
ax_flurstueck.objektkoordinaten next to the regular wkb_geometry).
Starting with GDAL 3.7, defining the NAS_GFS_TEMPLATE configuration option is
required for the NAS driver to open a file. It may be set to the empty string
to mean that the driver should try to establish the schema of the file from its
content, but using the below mentioned template is recommended.

A `GFS
template <https://github.com/norBIT/alkisimport/blob/master/alkis-schema.gfs>`__
and a corresponding `PostgreSQL
schema <https://github.com/norBIT/alkisimport/blob/master/alkis-schema.sql>`__
of the full NAS schema are part of `norGIS
ALKIS-Import <http://www.norbit.de/68/>`__ (also featuring a shell
script and PyQt frontend which ease the import). The two files were
generated using `xmi2db <https://github.com/norBIT/xmi2db/>`__ (fork of
`xmi2db <https://github.com/pkorduan/xmi2db>`__) from the official
application schema.

The configuration option **NAS_NO_RELATION_LAYER** allows
disabling populating the table *alkis_beziehungen*. The information found
there is redundant to the relation fields also contained in original
elements/tables. Enabling the option also makes progress reporting
available.

This driver was implemented within the context of the `PostNAS
project <http://trac.wheregroup.com/PostNAS>`__, which has more
information on its use and other related projects.

Driver capabilities
-------------------

.. supports_georeferencing::

.. supports_virtualio::
