Skip to content

v0.1.0 — Initial Release

Latest

Choose a tag to compare

@mykhailoklimnyk mykhailoklimnyk released this 04 Mar 12:44
· 2 commits to main since this release

UA Administrative Codes v0.1.0 — Genesis

First public release of the Ukrainian administrative-territorial classification codes dataset.

What's included

  • KOATUU (ДК 014-97) — legacy classifier, ~48,700 records with cumulative codes from 2014 onward
  • KATOTTG — current classifier (effective since 2020), ~31,993 records (snapshot 2026)
  • Both datasets share an identical 11-column schema
  • 4 hierarchy levels: oblast → raion → council/hromada → settlement
  • 5 settlement categories: село (С), селище (Щ), селище міського типу (Т), місто (М), район у місті (Р)
  • Includes both active and cancelled/renamed codes — critical for historical data work

Files

File Format Description
koatuu.parquet Apache Parquet (Snappy) KOATUU dataset (recommended)
koatuu.csv CSV (UTF-8) KOATUU dataset
katottg.parquet Apache Parquet (Snappy) KATOTTG dataset (recommended)
katottg.csv CSV (UTF-8) KATOTTG dataset

Quick start

import pandas as pd

df_koatuu = pd.read_parquet("koatuu.parquet")
df_katottg = pd.read_parquet("katottg.parquet")