Glossar

Begriffe und Felder des Regionalatlas, so wie die CLI sie ausgibt.

Begriff In der CLI Bedeutung
Regionalatlas Deutschland – Die Sammlung regionalstatistischer Karten und Indikatoren der Statistischen Ämter des Bundes und der Länder.
Regionaldatenbank Deutschland Datenquelle Die zugrunde liegende regionalstatistische Datenbank (GENESIS, regionalstatistik.de), aus der die Indikatoren stammen.
Themenbereich themes Ein Sachgebiet, z. B. Bevölkerung, Wahlen, Umwelt. Es gibt 21.
Indikator indicators, query <code> Eine einzelne messbare Größe, identifiziert durch einen Code (z. B. AI002-1-5). Es gibt 71 (Stand 2026-09-26; der Katalog ändert sich).
code AI002-1-5 Die Katalogkennung eines Indikators (unabhängig von Groß-/Kleinschreibung, mit Bindestrich oder Unterstrich).
Tabellencode ai002_1_5 Der aus dem Code abgeleitete SQL-Tabellenname: code.toLowerCase().replace(/-/g,"_"). Wird auch von query akzeptiert.
typ / Gebietsebene --level Die räumliche Aggregationsebene. land=1 (Bundesländer, 16), regierungsbezirk/rb=2 (38 Zeilen in den letzten Jahren), kreis/landkreis=3 (400 Zeilen in den letzten Jahren), gemeinde=5 (ca. 11 000 Zeilen). Die Zeilenzahl folgt dem Gebietsstand des Berichtsjahrs: Für 2000 hat rb 40 Zeilen und kreis 440, darunter zwei Kreise namens Hannover (03201, 03253) aus der Zeit vor der Region Hannover. Jede Ebene deckt ganz Deutschland ab – siehe Auffüllen der Ebene. Nicht jeder Indikator wird auf jeder Ebene veröffentlicht (AIGG-01 nur je Land, AI005 nicht je Gemeinde): Die geom_levels des Katalogs sagen, auf welchen Ebenen ein Jahr Werte hat, und query lehnt eine andere Ebene ab (Exit 2, mit den veröffentlichten Ebenen), statt je Region eine Zeile nur mit null-Werten zu liefern.
Auffüllen der Ebene Länge von ags Wo eine feinere Einheit nicht existiert, füllt eine Ebene mit der nächstgröberen auf. Dadurch ist jede Ebene eine vollständige, überschneidungsfreie Abdeckung Deutschlands, und die Länge von ags variiert innerhalb einer Ebene. regierungsbezirk liefert in den letzten Jahren 38 Zeilen: die 29 tatsächlichen Regierungsbezirke (3-stelliger AGS) plus die 9 Bundesländer ohne Regierungsbezirke (2-stellig: Schleswig-Holstein, Hamburg, Bremen, Saarland, Berlin, Brandenburg, Mecklenburg-Vorpommern, Sachsen-Anhalt, Thüringen). kreis und gemeinde enthalten Berlin (11) und Hamburg (02) 2-stellig; gemeinde zusätzlich 104 kreisfreie Städte unter ihrem 5-stelligen Kreisschlüssel. „Die 38 Regierungsbezirke“ ist also falsch – Summieren oder Kartieren einer Ebene bleibt aber korrekt.
AGS (Amtlicher Gemeindeschlüssel) ags Der amtliche Schlüssel eines Landes, Kreises oder einer Gemeinde (ein String, z. B. 03 für Niedersachsen, 03361 für einen Kreis). Führende Nullen sind bedeutsam – --region ignoriert sie beim Abgleich numerischer Eingaben. Eine aufgefüllte Zeile behält ihren kurzen Schlüssel, daher nimmt --region auch den mit Nullen aufgefüllten amtlichen Schlüssel: 09162000 (der 8-stellige Gemeindeschlüssel Münchens) trifft auf gemeinde-Ebene die Zeile 09162, 11000 auf kreis-Ebene Berlins Zeile 11, mit einem Hinweis dazu.
Gebietsname name Der Name der Region (in den Daten gen), z. B. Niedersachsen, Bremen.
jahr / year --year, year Das Berichtsjahr (eine vierstellige Ganzzahl, 1000–9999; einen Wert mit Leerzeichen, führender Null oder Nachkommastellen lehnen --year und die Bibliothek gleichermaßen ab). Jeder Indikator bietet bestimmte Jahre an, oft mit Lücken; indicators listet sie alle in years auf (bei AI005 z. B. nur die Wahljahre) und in levels die Ebenen mit Werten je Jahr. Ohne --year wird das neueste Katalogjahr verwendet, das der Datenhost womöglich noch nicht geladen hat: query liefert dann [] und weist auf stderr darauf hin.
Wertfeld values Eine Wertspalte eines Indikators (z. B. ai0201) – eine Zahl oder null. --fields behält nur die genannten (unabhängig von Groß-/Kleinschreibung, - und _ gleichwertig). indicators listet jede Spalte eines Indikators mit Bezeichnung und Einheit auf, unter dem Schlüssel, den sie in values trägt – der Katalog der Zensus-2011-Indikatoren schreibt AI-Z01, der Datenhost ai_z01, und die CLI verwendet für beides ai_z01.
Veränderungsrate (v-Feld) values Eine <field>v-Spalte (z. B. ai0201v) ist die Veränderungsrate des zugehörigen Wertfelds gegenüber dem Vorjahr – ein eigenständiger veröffentlichter Wert, kein Präzisionsflag. Einheit ist Prozent, bei Anteilsindikatoren Prozentpunkte (ai0208v); indicators nennt die Einheit je Spalte.
Sonderwert missing Eine Zahl über 2.000.000.000, die für ein Tabellenzeichen steht, nicht für einen Wert: 2222222222 nichts vorhanden (-), 5555555555 Wert geheim zu halten (.), 6666666666 Aussage nicht sinnvoll (x), 7777777777 Wert nicht sicher genug (/), 8888888888 Angabe fällt später an (...) – die Codes und Bezeichnungen der Regionalatlas-Webanwendung. Die CLI gibt 2222222222 (nichts vorhanden, das - für genau null) als 0 aus und jeden anderen Code als null, und nennt die Bedeutung des Codes in beiden Fällen im Objekt missing der Zeile ("values": {"ai0507": 0}, "missing": {"ai0507": "nichts vorhanden"}, der AfD-Anteil 1998). Der Upstream schreibt 2222222222 auch für eine Veränderungsrate ohne Vorjahr (ai0201v im Jahr 2000), wo 0 keine echte Rate ist – missing unterscheidet die Fälle.
gen2 / ags2 / jahr2 (intern) Die verknüpfte Seite des SQL-LEFT OUTER JOIN. gen2 ist in den Rohdaten mit führenden Leerzeichen aufgefüllt – der Client entfernt sie; die geparste Zeile verwendet gen/ags/jahr.
dynamicLayer / queryTable (intern) Der ArcGIS-Mechanismus, der den rohen SQL-Join hinter query ausführt.
--base-url / --catalog-url Optionen Der ArcGIS-Datenhost bzw. die URL des Indikatorenkatalogs (die beiden Upstream-Hosts).
Log-Eintrag (log record) stderr, --log-format Jede Diagnosezeile, die die CLI nach stderr schreibt: ein Zeitstempel, eine Stufe (ERROR, WARN, INFO) und ein Thema regionalatlas.<Bereich>, als Text (im Stil von log4j) oder mit --log-format jsonl als ein JSON-Objekt pro Zeile. Die Bereiche: cli (Bedienfehler, Meldungen von commander, unerwartete Fehler), api (die Antworten der Hosts und die Hinweise dazu: ein Fehlerstatus, der ArcGIS-error-Umschlag, eine fehlerhafte Antwort — ungültiges JSON, die falsche Form, ein leerer Body, ein Katalog, den die CLI ablehnt — und die Hinweise auf ein leeres, abgeschnittenes oder mehrdeutiges Ergebnis), http (die Verbindung, die Hinweise zur Größengrenze, die Klartext-Warnung und je Wiederholung eine WARN-Zeile vor dem Warten) und output (ein Schreibfehler auf stdout). Ein Eintrag ist immer eine Zeile; Steuerzeichen darin werden maskiert.

Die Daten lesen

Quelle auf GitHub ansehen →