Crate gv100ad

This software is experimental and might change a lot in future

This is a Rust implementation of a parser for GV100AD data sets. These data sets contain information about the structure, population, area of german municipalities.

The data sets can be obtained at: https://www.destatis.de/DE/Themen/Laender-Regionen/Regionales/Gemeindeverzeichnis/_inhalt.html

The parser was tested with this data set: https://www.destatis.de/DE/Themen/Laender-Regionen/Regionales/Gemeindeverzeichnis/Administrativ/Archiv/GV100ADQ/GV100AD3004.html

The ZIP files contain a text file GV100AD_DDMMYY.txt that contains the data set, and a PDF file describing the format.

Example

This example lists all municipalities of the state Saarland with population:

use gv100ad::{Ags, Database};

fn main() {
    let db = Database::from_path("GV100AD_300421.txt").unwrap();

    let ags_land = Ags::new_land(10);

    let land = db.get_land(&ags_land).unwrap();
    println!("{}:", land.name);

    for kreis in db.iter_kreise_in(&ags_land) {
        println!("  {}:", kreis.name);

        for gemeinde in db.iter_gemeinden_in(&kreis.ags) {
            println!("    {}: {} residents", gemeinde.name, gemeinde.population_total);
        }
    }
}

TODO

• Implement Textkennzeichen correctly.

Structs

Ags	Amtlicher Gemeindeschluessel
Database	A (in-memory) database that stores GV100AD data for querying.
FieldReader	Reader to read fields from a single data record (i.e. line). Specifically this makes sure that data is read correctly as UTF-8.
Gemeinde
Gemeindeverband
Gerichtbarkeit	Information regarding juristical districts
Kreis	A Kreis record
Land	A Land (i.e. Bundesland, state) record.
Parser	Parser for GV100AD files.
Regierungsbezirk	A Regierunsbezirk record (government district)
Region	A Region record (only Baden-Wuerttemberg)

Enums

Error	Error type returned by parser.
Record	A GV100AD record (Datensatz).
Textkennzeichen	FIXME: Different numbers can have the same meaning, but it depends in which kind of record it is used.

Functions

parse_date

Parses date from a field. This is just year, month, day without any seperators. German timezones apply.