Volby do Poslanecké sněmovny Parlamentu ČR 2025 – XML

11. 6. 2025 – verze 1.0

Základní informace

XML se dynamicky generují z aktuálně zpracovaných výsledků voleb z jednotlivých okrskových volebních komisí. Systém prezentace využívá cache, která omezuje dostupnost aktualizovaných XML dat na dobu 60 sekund (pokud není dále řečeno jinak).

K XML souborům se lze dostat buď přes vyhrazený server pro hromadné sdělovací prostředky (omezení na zadané IP adresy) nebo přímo z volby.cz (veřejně dostupné všem – projekt Otevřená data).

Pro volby do Poslanecké sněmovny Parlamentu ČR je k dispozici 8 typů XML souborů (průběžné i konečné výsledky):

Celkové výsledky (ČR a kraje)
Výsledky za okresy a obce
Výsledky za kraje a krajská města
Výsledky za zahraničí
Informace o přednostních hlasech pro jednotlivé kandidáty
Výsledky za volební okrsky (dávky dat)
Výsledky v jednotlivých obcích jako dávky dat (od roku 2025)
Výsledky v jednotlivých okresech jako dávky dat (od roku 2025)

Poznámka: Proti roku 2021 došlo ke změně v XML struktuře:

1. zavedení korespondenční volby – nové (nepovinné) položky ve všech XML

· DORUCOVACI_OBALKY: počet otevřených doručovacích obálek pro korespondenční volbu

· DORUCOVACI_ODLOZENE: počet odložených doručovacích obálek pro korespondenční volbu

· položky budou v XML jen, pokud mají pro dané území smysl – tzn., že se v daném území konala korespondenční volba (např. za celkem ČR ano, za Jihočeský kraj ne, za obec v ČR také ne)

2. zahraničí je rozděleno do 4 oblastí, kdy se hlasy z každé zahraniční oblasti započítávají do výsledků příslušného volebního kraje

· pro výsledky za zahraničí je nově u státu uveden atribut CIS_KRAJ – číslo kraje, do kterého byly výsledky započteny

· upozornění: přednostní hlasy pro kandidáty není možné za rozdílné zahraniční oblasti sčítat (rozdílné kandidátní listiny)

Kontaktní osoba k obsahu XML: Zdeňka Burešová: e-mail: zdenka.buresova@csu.gov.cz

1. Celkové výsledky (ČR a kraje)

XML soubor obsahuje informace o zpracovaných volebních okrscích a počet hlasů pro jednotlivé strany v součtu za jednotlivé volební kraje i za celou ČR.

Výsledky za jednotlivé zahraniční zvláštní volební okrsky započítávají do odpovídajícího kraje.

Po zpracování výsledků za všechny kraje a spuštění centrálního výpočtu se v XML objeví i počet zvolených poslanců za jednotlivé strany, včetně jejich jmenného seznamu na úrovni kraje i celé ČR.

Doba aktualizace: 60 sekund

opendata: https://www.volby.cz/appdata/ps2025/odata/vysledky.xml

xsd: ps_vysledky.xsd

2. Výsledky za okresy a obce

XML soubor obsahuje informace o zpracovaných volebních okrscích a počet hlasů pro jednotlivé strany nasčítané za danou územní úroveň (okres, obec). Informace je předávána za zadaný kód okresu (parametr nuts – součást url adresy). Ve výsledném XML jsou uvedeny vždy všechny obce zadaného okresu, tzn. i obce, kde ještě nebylo ukončeno zpracování (nebyly ČSÚ dodány výsledky za všechny volební okrsky). Pro stažení informace o všech obcích v ČR je nutné stáhnout XML postupně za všechny okresy ČR. Celkem se může jednat až o 10 MB dat.

Pro dekódování seznamu obcí a jejich územním zařazení se doporučuje využít číselník PSCOCO, které je zveřejňován na webu spolu s XML soubory. Pro Prahu, Brno, Ostravu, Plzeň, Pardubice, Ústí nad Labem, Liberec a Opavu jsou uvedeny informace i za úroveň městských částí nebo obvodů. Je tedy možné prezentovat výsledky jak za celou obec, tak i za jednotlivé její části (pokud je obec takto členěna).

Pro usnadnění orientace v datech je v rámci elementu OBEC přidán atribut TYP_OBEC:

OBEC_BEZ_MCMO – výsledky za obec bez městských částí nebo obvodů (běžné obce v ČR)
OBEC_S_MCMO – suma výsledků za obec s městskými částmi nebo obvody (Praha, Brno, …)
MCMO – výsledky za městskou část nebo obvod (např. Praha 10, Plzeň 2-Slovany, …)

Zahraničí není v tomto typu XML uvedeno, je potřeba (stejně jako minulé volby v roce 2021) stáhnout speciální XML pro zahraničí.

Doba aktualizace: 60 sekund

https://www.volby.cz/appdata/ps2025/odata/okresy/vysledky_okres_CZXXXX.xml

parametr: nuts=CZXXXX, kde CZXXXX je kód okresu dle číselníku NUTS

xsd: ps_vysledky_okres.xsd

3. Výsledky za kraje a krajská města

XML soubor obsahuje informace o zpracovaných volebních okrscích a počet hlasů pro jednotlivé strany nasčítané za kraj a jemu odpovídající krajské město (kromě Středočeského kraje). Krajská města jsou uvedena nasčítaná, tzn. bez rozlišení na případné městské části a obvody.

Do výsledku za kraj jsou případně nasčítané i výsledky za odpovídající zahraniční oblast.

Doba aktualizace: 60 sekund.

https://www.volby.cz/appdata/ps2025/odata/vysledky_krajmesta.xml

xsd: ps_vysledky_krajmesta.xsd

4. Výsledky za zahraničí

XML soubor obsahuje informace o zpracovaných volebních okrscích a počet hlasů pro jednotlivé strany nasčítané za zahraničí celkem, kontinenty a státy. Pokud je v jednom státě více měst, kde je možné hlasovat, je uvedena jen suma za celý stát. Pro každý stát je uvedeno, do kterého kraje se výsledky započítávají – státy jsou rozdělený do čtyř zahraničních oblastí.

Doba aktualizace: 60 sekund.

https://www.volby.cz/appdata/ps2025/odata/vysledky_zahranici.xml

xsd: ps_vysledky_zahranici.xsd

5. Průběžné s preferenčními hlasy pro jednotlivé kandidáty

XML soubor obsahuje informace potřebné pro průběžný výpočet složení Poslanecké sněmovny Parlamentu ČR ještě před ukončením zpracování výsledků hlasování. Pro jednotlivé volební kraje jsou v XML uvedeny údaje o zpracovaných volebních okrscích, počtu hlasů pro jednotlivé strany a počtu přednostních hlasů pro jednotlivé kandidáty. Kandidáti i strany jsou uvedeny v XML pouze kódem. Pro dekódování konkrétních kandidátů a stran se doporučuje využít registry, které jsou zveřejňovány na webu spolu s XML soubory.

Do výsledku za kraj jsou případně nasčítané i výsledky za odpovídající zahraniční oblast.

https://www.volby.cz/appdata/ps2025/odata/vysledky_kandid.xml

xsd: ps_vysledky_kandid.xsd

6. Výsledky za volební okrsky (dávky dat)

XML soubor obsahuje informaci o počtu voličů, hlasů celkem a hlasů pro jednotlivé strany (kandidátní listiny) za jednotlivé volební okrsky. Na rozdíl od ostatních XML dat, se nejedná o stavový soubor, který by vracel vždy kompletní údaje za všechny dosud zpracované okrsky. Ke stažení budou k dispozici přírůstková data za nově zpracované okrsky od poslední dávky – předpokládaný interval dávek je 5 minut.

Celkovou velikost přenášených XML dat (za všechny dávky) odhadujeme na cca 18 MB.

V dávkách jsou zasílány i data za zpracované zvláštní volební okrsky (zahraniční okrsky).

Doba aktualizace: 5 minut

https://www.volby.cz/appdata/ps2025/odata/okrsky/vysledky_okrsky_NNNNN.xml

· NNNNN je číslo dávky (vedoucí nuly, např. 00001)

· vysledky_okrsky.xml obsahují vždy poslední dávku

Poznámky:

· identifikace okrsku: CIS_OBEC, CIS_OKRSEK

· pokud není parametr davka zadán, vrátí se poslední dávka, která je k dispozici

· starší dávky s okrsky lze stahovat po celou dobu zpracování

· pokud nebude v daném pětiminutovém intervalu zpracován žádný okrsek, nebude se dávka vytvářet

· je potřeba počítat s tím, že data za okrsek mohou být zaslána opakovaně a mohou tak být odlišná od předchozí verze (lze rozlišit přes vyšší číslo PORADI_ZPRAC)

o dávky je tak potřeba zpracovávat v pořadí, ve kterém vznikly, resp. do zpracování zahrnout okrsek pouze jednou, právě ten s nejvyšším číslem PORADI_ZPRAC

· v době špičky zpracování může být zpracováno 500 až 1000 okrsků za 5 minut

· na začátku a konci zpracování může dávka obsahovat jen jednotky okrsků

Kódy chyb:

10: číslo dávky neexistuje – není ještě vytvořena (před začátkem zpracování)

9999: jiná chyba

http chyba 404 – neexistuje soubor s danou dávkou (dávka ještě nebyla zpracována)

xsd: ps_vysledky_okrsky.xsd

7. Výsledky v jednotlivých obcích jako dávky dat (od roku 2025)

XML soubor obsahuje informaci o počtu voličů, hlasů celkem a hlasů pro jednotlivé strany (kandidátní listiny) za jednotlivé obce, případně městské části nebo obvody. Na rozdíl od ostatních XML dat, se nejedná o stavový soubor, který by vracel vždy kompletní údaje za všechny dosud zpracované obce. Ke stažení budou k dispozici přírůstková data za obce, kde od poslední dávky došlo ke změně (zpracovaný volební okrsek dané obce) – předpokládaný interval dávek je 5 minut.

Celkovou velikost přenášených XML dat (za všechny dávky) odhadujeme na cca 20 MB.

V dávkách jsou zasílány i informaci o zahraničí – CIS_OBEC = 999997.

Doba aktualizace: 5 minut

https://www.volby.cz/appdata/ps2025/odata/obce_d/vysledky_obce_NNNNN.xml

· NNNNN je číslo dávky (vedoucí nuly, např. 00001)

· vysledky_obce.xml obsahují vždy poslední dávku

Poznámky:

· identifikace obce: CIS_OBEC

· u každé obce uveden TYP_OBEC – viz kap. 2

· pokud není parametr davka zadán, vrátí se poslední dávka, která je k dispozici

· číslo dávky bude přesně odpovídat číslu dávky XML za volební okrsky

· starší dávky s okrsky lze stahovat po celou dobu zpracování

· pokud nebude v daném pětiminutovém intervalu zpracován žádný okrsek, nebude se dávka vytvářet

Kódy chyb:

10: číslo dávky neexistuje – není ještě vytvořena (před začátkem zpracování)

9999: jiná chyba

http chyba 404 – neexistuje soubor s danou dávkou (dávka ještě nebyla zpracována)

xsd: ps_vysledky_obce.xsd

8. Výsledky v jednotlivých okresech jako dávky dat (od roku 2025)

XML soubor obsahuje informaci o počtu voličů, hlasů celkem a hlasů pro jednotlivé strany (kandidátní listiny) za jednotlivé okresy. Na rozdíl od ostatních XML dat, se nejedná o stavový soubor, který by vracel vždy kompletní údaje za všechny okresy. Ke stažení budou k dispozici přírůstková data za okresy, kde od poslední dávky došlo ke změně (zpracovaný volební okrsek daného okresu) – předpokládaný interval dávek je 5 minut.

Celkovou velikost přenášených XML dat (za všechny dávky) odhadujeme na cca 1 MB.

V dávkách jsou zasílány i informaci o zahraničí – NUTS_OKRES = CZZZZZ.

Doba aktualizace: 5 minut

https://www.volby.cz/appdata/ps2025/odata/okresy_d/vysledky_okresy_NNNNN.xml

· NNNNN je číslo dávky (vedoucí nuly, např. 00001)

· vysledky_okresy.xml obsahují vždy poslední dávku

Poznámky:

· identifikace obce: NUTS_OKRES

· pokud není parametr davka zadán, vrátí se poslední dávka, která je k dispozici

· číslo dávky bude přesně odpovídat číslu dávky XML za volební okrsky

· starší dávky s okrsky lze stahovat po celou dobu zpracování

· pokud nebude v daném pětiminutovém intervalu zpracován žádný okrsek, nebude se dávka vytvářet

Kódy chyb:

10: číslo dávky neexistuje – není ještě vytvořena (před začátkem zpracování)

9999: jiná chyba

http chyba 404 – neexistuje soubor s danou dávkou (dávka ještě nebyla zpracována)

xsd: ps_vysledky_okresy.xsd