Volby do Senátu Parlamentu ČR – XML
05.08.2024 – verze 1.0
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á webcache, 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 Senátu Parlamentu ČR jsou k dispozici 4 typy XML souborů (průběžné i konečné výsledky):
Podrobnější údaje o kandidátech je možné získat z registru, který je zveřejňovaný jako XML soubor na www.volby.cz v sekci otevřená data.
Na serveru pro media i www.volby.cz budou k dispozici stejné XML i pro libovolné volby konané v dřívějších letech (od roku 1996 do dneška). Rozlišení se provádí pomocí parametru datum_voleb.
Poznámka: proti roku 2022 došlo k přidání nového typu XML – „Výsledky za obce v rámci senátního obvodu“
Kontaktní osoba k obsahu XML: Zdeňka Burešová: e-mail: zdenka.buresova@czso.cz
XML soubor obsahuje informace za všechny senátní obvody: volební účast, počty hlasů pro jednotlivé kandidáty, postup do 2. kola, zvolení a nezvolení.
XML se dynamicky generují z aktuálně zpracovaných výsledků voleb. Doba aktualizace je 60 sekund (doba držení obsahu ve webcache na straně server xml.datavolby.cz).
Doba aktualizace: 60 sekund
https://www.volby.cz/appdata/senat/20240920/odata/vysledky.xml (aktuální volby)
https://www.volby.cz/appdata/senat/RRRRMMDD/odata/vysledky.xml
(RRRRMMDD = datum prvního dne voleb – výsledky za předešlé volby)
xsd: se_vysledky.xsd
Komentář k plnění položek v XML:
XML soubor obsahuje informace o zpracovaných volebních okrscích a počet hlasů pro jednotlivé kandidáty nasčítané za obec (příp. městskou část/obvod). Informace je předávána za zadané číslo senátního obvodu. Ve výsledném XML jsou uvedeny vždy všechny obce zadaného senátního obvodu. Pro stažení informace o všech obcích v ČR je nutné stáhnout XML za všechny senátní obvody, kde se konaly volby.
Pro dekódování seznamu obcí a jejich územním zařazení se doporučuje využít číselník SECOCO, které je zveřejňován na webu spolu s XML soubory. Pro Prahu, Brno, Ostrava, 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:
Doba aktualizace: 60 sekund
https://www.volby.cz/appdata/senat/20240920/odata/obvody/vysledky_obce_obvod_XX.xml (aktuální volby)
xsd: se_vysledky_obce_obvod.xsd
XML soubor obsahuje aktuální platné složení Senátu Parlamentu ČR. Do seznamu jsou promítány změny při zvolení nového senátora nebo při zániku mandátu senátora.
Doba aktualizace: 60 sekund
https://www.volby.cz/appdata/senat/aktual/odata/vysledky_celk.xml
xsd: se_vysledky_celk.xsd
XML soubor obsahuje informaci o počtu voličů, hlasů celkem a hlasů pro jednotlivé kandidáty 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 vytváření dávek je 5 minut. Informace je předávána za zadané kolo volby (parametr volání – součást url).
Celkovou velikost přenášených XML dat (za všechny dávky) odhadujeme na cca 10 MB.
Doba aktualizace: 5 minut
https://www.volby.cz/appdata/senat/20240920/okrsky/K1/vysledky_okrsky_NNNNN.xml
xsd: se_vysledky_okrsky.xsd
Poznámky:
· identifikace okrsku: CIS_OBEC, CIS_OKRSEK
· pokud není parametr datum_voleb zadán, vrátí se data z posledních zpracovávaných voleb
· pokud není parametr davka zadán, vrátí se poslední dávka, která je k dispozici
· pokud není parametr kolo zadán, vrátí se informace z aktuálního kola
· pro každé kolo se dávky číslují od 1
· starší dávky s okrsky lze stahovat po celou dobu zpracování (a to z případného předchozího kola)
· 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 800 až 1500 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
20: chybné datum voleb – zpracování pro dané datum ještě není aktivováno
30: chybné číslo kola – zpracování pro zadané kolo ještě není aktivováno
40: pro zadané kolo ještě neexistuje žádná dávka
9999: jiná chyba
xsd: se_vysledky_okrsky.xsd