Volby do Senátu Parlamentu ČR – XML

05.08.2024 – 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á 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):

  1. Výsledky za jednotlivé senátní obvody a ČR
  2. Výsledky za obce v rámci senátního obvodu
  3. Aktuální platné složení Senátu
  4. Výsledky za volební okrsky (dávky dat) – (od voleb v říjnu 2018)

 

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.

 

XML za volby do Senátu Parlamentu ČR v jiných letech

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

 


 

1.    Výsledky za jednotlivé senátní obvody a ČR

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:

 


2.    Výsledky za obce v rámci senátního obvodu

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

 


 

3.    Aktuální platné složení Senátu

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

 


4.    Výsledky za volební okrsky (od voleb v říjnu 2018)

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