ruian-import

Python knihovna pro stahování a parsování číselníků ČÚZK (RÚIAN): kraje, okresy a obce.

Instalace

pip install ruian-import
# s podporou souřadnic (JTSK -> WGS84):
pip install "ruian-import[coordinates]"

Použití

from ruian_import import fetch_kraje, fetch_okresy, fetch_obce

kraje = fetch_kraje()   # list[Kraj]
okresy = fetch_okresy() # list[Okres]
obce = fetch_obce()     # list[Obec]

Datové třídy

@dataclass
class Kraj:
    kod: str          # např. "19"
    nazev: str        # např. "Hlavní město Praha"
    nuts_lau: str | None  # např. "CZ010"
    zrusen: str | None    # datum zrušení "YYYY-MM-DD" nebo None

@dataclass
class Okres:
    kod: str
    nazev: str
    kraj_kod: str
    nuts_lau: str | None
    zrusen: str | None

@dataclass
class Obec:
    kod: str          # 6místný kód obce, např. "554979"
    nazev: str
    okres_kod: str
    lat: float | None  # WGS84, dostupné jen s [coordinates]
    lon: float | None
    zrusen: str | None

Zrušené záznamy mají vyplněné pole zrusen; platné záznamy mají zrusen = None.

Souřadnice obcí

UI_OBEC.csv souřadnice neobsahuje. Pro doplnění souřadnic použij fetch_obce_with_coordinates(), které provede druhý dotaz na ArcGIS REST API ČÚZK a vrátí centroidy polygonů (přesnost ~100 m, jeden HTTP request pro všechny obce):

from ruian_import import fetch_obce_with_coordinates

obce = fetch_obce_with_coordinates()  # lat/lon vyplněné

Nebo načti souřadnice samostatně:

from ruian_import import fetch_obec_coordinates

coords = fetch_obec_coordinates()  # dict[str, tuple[float, float]] - kod -> (lat, lon)

Vlastní URL / lokální soubory

from ruian_import._parse import parse_obce

data = Path("UI_OBEC.zip").read_bytes()
obce = parse_obce(data)

Zdroje dat

Číselníky ČÚZK se aktualizují denně:

• Kraje: https://services.cuzk.cz/sestavy/cis/UI_VUSC.zip
• Okresy: https://services.cuzk.cz/sestavy/cis/UI_OKRES.zip
• Obce: https://services.cuzk.cz/sestavy/cis/UI_OBEC.zip

Licence

MIT