Valimiste avaandmete kasutusjuhend

Juhendi eesmärk on anda ülevaade VIS3 avaandmete lehel pakutavatest andmefailidest, täpsustada avaldatavate andmete sisu ning seda, kuidas välistel rakendustel on võimalik avaldatavaid andmeid tarbida.

Avaandmete veebilehe aadress on https://opendata.valimised.ee. Sellel aadressil asub nii inimkasutajatele mõeldud kasutajaliides kui ka masinliides, mille abil saavad välised rakendused andmeid tarbida.

Välise rakenduse kaudu on võimalik tarbida järgnevaid andmeid:

  • Kandidaatide info (vt 5 Kandidaatide info)
  • Hääletamisstatistika maakondade kaupa (vt 6 Hääletamisstatistika maakondade kaupa)
  • Valimistulemused (vt 7 Valimistulemused, 8 Detailne hääletamistulemus riigis ja maakondades, 9 Detailne hääletamistulemus valdades ja linnades)

Selleks, et andmed alla laadida, peab väline rakendus tegema järgneva päringu:

meetod: GET

           URL: https://opendata.valimised.ee/api/<valimissündmuse kood>/<failinimi>

Näiteks - GET https://opendata.valimised.ee/api/RK_2023/ELECTION_CANDIDATES.xml laeks alla kandidaatide info faili valimissündmuse RK_2023 jaoks. Valimissündmuse koodi (või koodid, kui sündmusi peaks olema mitu) leiab avaandmete lehelt ripploendist „Valimine või rahvahääletus“. Võimalikud failinimed on koondatud järgnevasse tabelisse:

Faili sisu Failinimi
Kandidaatide info ELECTION_CANDIDATES.xml
E-hääletanute hääletamisstatistika maakondade kaupa ONLINE_VOTERS_PARTICIPATION_INFO.xml
Paberhääletanute hääletamisstatistika maakondade kaupa PAPER_VOTERS_PARTICIPATION_INFO.xml
E-ja paberhääletanute hääletamisstatistika maakondade kaupa PARTICIPATION_INFO.xml
Valimistulemused RESULTS.xml
Detailne hääletamistulemus riigis ja maakondades (KOV valimised) POSTELECTION_PARTICIPATION_INFO.xml
Detailne hääletamistulemus riigis ja maakondades (RK valimised) VOTING_RESULT_IN_COUNTIES.xml
Detailne hääletamistulemus valdades ja linnades (KOV valimised) DETAILED_RESULT_PARISH_<EHAK_KOOD>.xml
Detailne hääletamistulemus valdades ja linnades (RK valimised) VOTING_RESULT_IN_PARISH_<EHAK_KOOD>.xml

Jaoskondade ja hääletamisruumide infot pakutakse CSV failina. Andmestik avaldatakse hetkel, mil valimisjaoskonnad peavad valimisseaduste järgi olema hiljemalt sisestatud (50p enne valimispäeva).

CSV failis on igal real hääletamisruumi andmed, kui jaoskonnal on hääletamisruume mitu, siis on need eraldi ridadel. Iga rea kohta kuvatakse järgmiseid andmeid:

Veeru nimetus Selgitus Näide
Valimissündmus Valimisündmuse kood, mille andmeid kuvatakse KOV_2021
Jaoskonna number Jaoskonna number, mille andmeid kuvatakse 1
KOV või linnaosa Asukohaüksuse nimetus, kuhu jaoskond kuulub Anija vald
Valimisringkond Valimisringkond, kuhu jaoskond kuulub Valimisringkond nr 1 – Anija vald
Jaoskonnas saavad hääletada ka teise ringkonda kuuluvad valijad Tõeväärtus, kas antud jaoskonnas on lubatud hääletada ka teise ringkonda kuuluvatel valijatel true
Jaoskonna telefoninumber Jaoskonna kontaktnumber +3725666866
Valimiskasti koju tellimise number Jaoskonna telefoninumber, mille kaudu saab tellida koju valimiskasti +3725666866
E-posti aadress Jaoskonna e-posti aadress [email protected]
Aadress Hääletamisruumi aadress Hane tee 3, Anija vald, Harju maakond
Asukoha nimetus Hääletamisruumi asukoha nimetus Hane Rimi hüpermarket
Info ligipääsetavuse kohta Andmed hääletamisruumi ligipääsetavuse kohta Saab ligi ratastooli kui lapsevankriga
Valimispäev või eelhääletamine Tõeväärtus, kas hääletamisruumis saab hääletada valimispäeval või eelhääletamise ajal (V, kui valimispäeval; E, kui eelhääletamise ajal) V
Kellaajad Hääletamise toimumise kellaaeg 09:00-20:00
Valimispäev või eelhääletamise päev Kuupäev(ad), millal hääletamisruumis hääletamine toimub 05.07.2021

Välisesinduste infot pakutakse CSV failina Riigikogu, Euroopa Parlamendi valimiste ja rahvahääletuse korral. Andmestik kirjeldab, missugustes välisesindustes on võimalik oma paberhäält anda ja millal. Andmestik avaldatakse 15p enne valimispäeva.

CSV failis on igal real välisesinduse andmed, kus rea kohta kuvatakse järgmiseid andmeid:

Veeru nimetus Selgitus Näide
Valimissündmus Valimisündmuse kood, mille andmeid kuvatakse RK_2023
Välisesinduse nimi Välisesinduse nimi, kuhu on võimalik hääletama minna Eesti Vabariigi Suursaatkond Ankaras
Asukoha riik Riik, kus välisesindus asub Türgi
Esindatavad riigid Riigid, kelle alalistele elanikele selles välisesinduses hääletamist korraldatakse  (üks välisesindus võib esindada mitme riigi alalisi elanikke). Asukoha riiki esindatakse alati ja seda siin eraldi välja ei tuua. Egiptus; Maroko
Telefoninumber Välisesinduse kontaktnumber +903124056970
E-posti aadress Välisesinduse e-posti aadress [email protected]
Veebiaadress Välisesinduse veebiaadress https://ankara.mfa.ee/et/
Hääletamise kuupäev ja kellaaeg Hääletamise kuupäev(ad) ja kellaajad, mil on võimalik välisesinduses hääletada 01.01.2021 10:00-18:00
03.01.2021 10:00-18:00

Kandidaatide info

Kandidaatide info avaldatakse XML failina kandidaatide registreerimise lõppemise järel. Fail sisaldab kõiki registreeritud kandidaate.
Kandidaatide faili nimi on kujul ELECTION_CANDIDATES.xml
Skeemifail: election-candidates_v1.xsd
 

Kohaliku omavalitsuse volikogu valimiste (KOV) kandidaadid

XML tag Näide Kirjeldus
electionCode KOV_2021 Valimissündmuse kood
reportType ELECTION_CANDIDATES Aruande nimi
generated 2017-10-19T10:50:09.474+03:00 Aruande genereerimise aeg
XML tag Näide Kirjeldus
name Harju maakond Maakonna nimi
code 0037 Maakonna EHAK kood
childAdminUnits/childAdminUnit Maakonna koosseisu kuuluvad vallad/ linnad
XML tag Näide Kirjeldus
name Anija vald Valla/linna nimi
code 0141 Valla/linna EHAK kood
districts Valimisringkondade andmed
XML tag Näide Kirjeldus
districtComment Valimisringkond nr 1 - Anija vald Valimisringkonna nimi
districtNumber 1 Valimisringkonna number
partie Ringkonnas kandideerivad poliitilised ühendused
XML tag Näide Kirjeldus
partyName Eesti Roheline Erakond Erakonna nimi
partyCode ROH Erakonna lühend
numberOfCandidates 20 Kandidaatide arv
candidates Erakonna kandidaadid
XML tag Näide Kirjeldus
forename MEELIS Kandidaadi eesnimi
surname KOPPEL Kandidaadi perekonnanimi
citizenship Eesti Kandidaadi kodakondsus
candidateRegNumber 146 Kandidaadi registreerimisnumber
sequenceNumberInAdminUnit 17 Kandidaadi erakonnasisene järjekonnanumber ülelinnalises nimekirjas (Tallinna korral).
partyName Eesti Kollane Erakond Kandidaadi erakondlik kuuluvus
education Kõrgharidus Haridustase
employment Tisler, Thor OÜ Töökoht ja amet
birthday 31.07.1988 Sünniaeg
sex M Sugu
contactInfos Kandidaadi kontaktandmed
XML tag Näide Kirjeldus
type PHONE

Kontaktandmete tüüp

Võimalikud väärtused:

  • PHONE
  • EMAIL
  • ADDRESS
  • FB
  • TWITTER
contact

+37256656621 Tüübile vastav kandidaadi tel.nr / email / aadress / fb / twitter

Riigikogu (RK) kandidaadid

XML tag Näide Kirjeldus
electionCode RK_2022 Valimissündmuse kood
reportType ELECTION_CANDIDATES Aruande nimi
generated 2017-10-19T10:50:09.474+03:00 Aruande genereerimise aeg
XML tag Näide Kirjeldus
districtName Tallinna Haabersti, Põhja-Tallinna ja Kristiine linnaosa Valimisringkonna nimi
districtNumber 1 Valimisringkonna number
numberOfCandidates 107 Valimisringkonnas registreeritud kandidaatide arv
XML tag Näide Kirjeldus
partyCode Erakonna lühend ROH
partyName Erakonna nimi Eesti Roheline Erakond
numberOfCandidates Registreeritud kandidaatide arv vastavas erakonnas ja vastavas valimisringkonnas 12
XML tag Näide Kirjeldus
forename MEELIS Kandidaadi eesnimi
surname KOPPEL Kandidaadi perekonnanimi
citizenship Eesti Kandidaadi kodakondsus
candidateId 10000 Kandidaadi ID
candidateRegNumber 146 Kandidaadi registreerimisnumber
sequenceNumberInAdminUnit 17

EP puhul on <sequenceNumberInAdminUnit> ja <sequenceNumberInDistrict> väärtused samad.

RK puhul üleriigiline positsiooninumber.

Üksikkandidaadil liisuheitmise järjekord üksikkandidaatide seas

sequenceNumberInDistrict 11 Positsioon ringkonnanimekirjas
partyName Eesti Kollane Erakond Kandidaadi erakondlik kuuluvus
education Kõrgharidus Haridustase
employment Tisler, Thor OÜ Töökoht ja amet
birthday 31.07.1988 Sünniaeg
sex M Sugu
contactInfos Kandidaadi kontaktandmed
XML tag Näide Kirjeldus
type PHONE

Kontaktandmete tüüp

Võimalikud väärtused:

  • PHONE
  • EMAIL
  • ADDRESS
  • FB
  • TWITTER
contact +37256656621 Tüübile vastav kandidaadi tel.nr / email / aadress / fb / twitter

Hääletamisstatistika maakondade kaupa

Hääletamisstatistikat väljastatakse kolmel erineval viisil:

  1. E-hääletanute hääletamisstatistika (faili nimi on ONLINE_VOTERS_PARTICIPATION_INFO.xml);
  2. Paberhääletanute hääletamisstatistika (faili nimi on PAPER_VOTERS_PARTICIPATION_INFO.xml);
  3. E-ja paberhääletanute hääletamisstatistika (faili nimi on PARTICIPATION_INFO.xml).

Osavõtustatistika väljastatakse maakondade, Tallinna, Tartu linna, E-häälte ja Eesti Vabariigi kohta.

Skeemifail: participation-info_v1.xsd

Hääletamisstatistikat hakatakse avaldama eelhääletamise esimesel päeval ning seda uuendatakse pidevalt hääletamise perioodi vältel.

XML tag Näide Kirjeldus
electionCode KOV_2021 Valimissündmuse kood
reportType PARTICIPATION_INFO Aruande nimi
  • PARTICIPATION_INFO (sisaldab nii e- kui paberhääletanuid)
  • PAPER_VOTERS_PARTICIPATION_INFO
    • (sisaldab paberhääletanuid)
  • ONLINE_VOTERS_PARTICIPATION_INFO
    • (sisaldab e-hääletanuid
generated 2017-10-

19T10:50:09.474+03:00

Aruande genereerimise aeg
XML tag Näide Kirjeldus
description Harju maakond Maakonna nimi, Tallinn, Tartu linn, FOREIGN (RK, EP või RH korral) või TOTAL
ForeignCountryVotesCounted true Tõeväärtus, kas osavõtustatistikas on ka välisesindustes hääletanud (KOV valimiste korral alati false)
percentagesRow/percentageCell Osavõtu andmed
XML tag Näide Kirjeldus
controlTime

Kontrollaeg.

Võimalikud kontrollajad:

  • 6 päeva enne valimispäeva
  • 5 päeva enne valimispäeva
  • 4 päeva enne valimispäeva
  • 3 päeva enne valimispäeva
  • 2 päeva enne valimispäeva
  • 1 päeva enne valimispäeva
  • Valimispäeval kell 12:00 (ei kuvata, kui reportType: ONLINE_VOTERS_PARTICIPATION_INFO)
  • Valimispäeval kell 16:00 (ei kuvata, kui reportType: ONLINE_VOTERS_PARTICIPATION_INFO)
  • Valimispäeval kell 20:00 (ei kuvata, kui reportType: ONLINE_VOTERS_PARTICIPATION_INFO)
  • Viimane seis (TOTAL)
votedCount 2912 Hääletanuid kontrollajal
percentage 2.1 Hääletanute %

Valimistulemused

Valimistulemuste andmeid hakatakse avaldama hetkest, mil VIS3-s allkirjastatakse hääletamistulemuste protokoll või on selgunud e-häälte tulemused. Valimistulemusi uuendatakse, kuni kõik häälte lugemisega seotud protokollid on VIS3-s allkirjastatud.

Valimistulemuste faili nimi on .xml

Valimissündmuste lõikes andmete struktuur varieerub:

  • Riigikogu valimistulemuste schema fail on election-result_rk_v1.xsd
  • Kohaliku omavalitsuse volikogu valimiste schema fail on election-result_kov_v1.xsd

KOV valimistulemuste fail

XML tag Näide Kirjeldus
electionCode KOV_2021 Valimissündmuse kood

reportType RESULTS Aruande nimi
generated 2017-10-19T10:50:09.474+03:00 Aruande genereerimise aeg
XML tag Näide Kirjeldus
adminUnit/name Eesti Vabariik Haldusüksuse nimi (Eesti Vabariik, maakonna nimi või kohaliku omavalitsusüksuse nimi)
adminUnit/code 0000 Haldusüksuse EHAK kood
adminUnit/parentAdminUnitName Üksuse nimetus, mille alla vald/linn kuulub.
adminUnit/parentEhakCode Üksuse EHAK kood, mille alla vald/linn kuulub.
totalDepartmentsCount 552 Kõigi jaoskondade arv haldusüksuses
confirmedDepartmentCount 221 Hääletamistulemuse edastanud jaoskondade arv
totalVotes 222222 Kehtivaid hääli kokku
mandateCount 85 Mandaatide arv. Moodustatakse KOV taseme haldusüksuse korral
fivePercentage 9596.2500 5% künnis. Moodustatakse KOV taseme haldusüksuse korral
isEVOTINGConfirmed false Tõene, kui e-hääled edastatud, väär, kui ehääled edastamata
parties/party Nimekirjade hääletamistulemused haldusüksuses
(Eesti ja maakonna tasemel liidetakse valimisliitude hääled kokku, party/name =“Valimisliidud”)
parties/party/name Valimisliit Alutaguse Eest Erakonna või valimisliidu nimi või Üksikandidaadid (nimekirja nimi)
parties/party/code VLAE Poliitilise ühenduse lühend
parties/party/votesCount 256 Kehtivate häälte arv
parties/party/totalElectedCandidatesCount 2

Nimekirjast valituks osutunud kandidaatide arv

Moodustatakse KOV taseme haldusüksuse korral

parties/party/votePercentage 19.5 Nimekirja poolt antud häälte protsent kehtivate häälte üldarvust haldusüksuses
XML tag Näide Kirjeldus
forename Boris Kandidaadi eesnimi
surname Kuusk Kandidaadi perekonnanimi
candidateRegNumber 1048 Kandidaadi registreerimisnumber
sequenceNumberInAdminUnit

11 Kandidaadi erakonnasisene järjekonnanumber ülelinnalises nimekirjas (moodustatakse Tallinna korral)
sequenceNumberInDistrict 3 Kandidaadi erakonnasisene järjekonnanumber ringkonna nimekirjas
votesCount 1271 Kandidaadi kogutud häälte arv
seqNoFinal 15 Kandidaadi valimistulemust määrav järjekorranumber ringkonnas, Tallinna korral linnas
partyName Eesti Kollane Erakond Nimekirja nimi (erakonna, valimisliidu nimi või „Üksikkandidaadid“)
districtNumber 2 Valimisringkonna number, kus kandidaat kandideerib
quota 808.025 Lihtkvoot
vrd 0.000 Võrdlusarv
v1 false Isikumandaat. Väärtustatakse true, kui kandidaat sai isikumandaadi, muul juhul false.
v2 false Ringkonnamandaat. Väärtustatakse true, kui kandidaat sai ringkonnamandaadi, muul juhul false.
V3 true Kompensatsioonimandaat. Väärtustatakse true, kui kandidaat sai kompensatsioonimandaadi, muul juhul false. Saavad tekkida vaid Tallinnas.
elected true Tunnus, kas kandidaat osutus valituks (true/false)
reserved false Tõene, kui kandidaat on ringkonnamandaadi saanud kandidaadi asendusliige. Väär, kui kandidaat osutus valituks.

RK valimistulemuste fail

XML tag Näide Kirjeldus
electionCode RK_2022 Valimissündmuse kood
reportType RESULTS Aruande nimi
generated 2012-10-19T10:50:09.474+03:00 Aruande genereerimise aeg
XML tag Näide Kirjeldus
adminUnitName Eesti Vabariik Üksus, mille kohta tulemused käivad
ehakCode 0000 Üksuse EHAK-kood
participation Osavõtu andmed
XML tag Näide Kirjeldus
votes 561141 Kõigi ringkondade häälte summa
numberOfProtocols 122 Allkirjastatud protokolle
totalNumberOfProtocols 531 Protokollide koguarv
evotesCounted true Tunnus, kas e-hääled on loetud või ei
XML tag Näide Kirjeldus
partyName Erakond Kollased Erakonna nimi
partyCode KOL Erakonna lühend
partyTossUpNumber 3 Nimekirja liisuheitmise number
PartyNumberOfMandates 5 Saadud mandaatide arv
candidates Kandidaatide tulemused
XML tag Näide Kirjeldus
forename Boris Kandidaadi eesnimi
surname Kuusk Kandidaadi perekonnanimi
candidateRegNumber 1048 Kandidaadi registreerimisnumber
candidateId 32444 Kandidaadi ID
candidateVotes 1453 Kandidaadi häälte arv
partyName Eesti Kollane Erakond Erakonna nimi
districtNumber 2 Valimisringkonna number, kus kandidaat kandideerib
quota 808.025 Lihtkvoot
vrd 0.000 Võrdlusarv
v1 false Isikumandaat. Väärtustatakse true, kui kandidaat sai isikumandaadi, muul juhul false.
v2 false Ringkonnamandaat. Väärtustatakse true, kui kandidaat sai ringkonnamandaadi, muul juhul false.
V3 true Kompensatsioonimandaat. Väärtustatakse true, kui kandidaat sai kompensatsioonimandaadi, muul juhul false.
elected true Tunnus, kas kandidaat osutus valituks (true/false)
reserved false Tõene, kui kandidaat on ringkonnamandaadi saanud kandidaadi asendusliige. Väär, kui kandidaat osutus valituks.
XML tag Näide Kirjeldus
partyName Eesti Kollaste Erakond Erakonna nimi
partyCode EKE Erakonna lühend
partyVotes 244444 Saadud häälte arv
percentage 12.3% Kogutud hääli protsentides
partyNumberOfMandates 13 Saadud mandaatide arv

Detailne hääletamistulemus riigis ja maakondades

Andmefail võimaldab vaadata detailseid hääletamistulemusi riigis ja maakondades. Andmed avaldatakse hetkel, mil selguvad esimesed hääletamistulemused (allkirjastatakse hääletamistulemuste protokoll või kui on selgunud e-häälte tulemused) ning uuendatakse seni, kuni kõik hääletamistulemustega seotud protokollid on VIS3-s allkirjastatud.

Valimissündmuste lõikes andmete struktuur varieerub:

  • Riigikogu valimistulemuste skeemifail on detailed-voting-result-greater-municipality_ep_rk_v1.xsd
  • Kohaliku omavalitsuse volikogu valimiste skeemifail on detailed-voting-result-greater-municipality_kov_v1.xs

KOV detailne hääletamistulemus riigis ja maakondades

Faili nimi on POSTELECTION_PARTICIPATION_INFO.xml

XML tag Näide Kirjeldus
electionCode KOV_2021 Valimissündmuse kood
reportType POSTELECTION_PARTICIPATION_INFO Aruande nimi
generated 2017-10-19T10:50:09.474+03:00 Aruande genereerimise aeg
XML tag Näide Kirjeldus
name Harju maakond Maakonna nimi, Tallinn, Tartu linn või Eesti Vabariik
code 0037 Asukohaüksuse EHAK-kood
participationInfoRow Maakonna hääletamistulemuse andmed
participationInfoRow/ totalVotersInList 122933 Valijate koguarv vastavas maakonnas
participationInfoRow/ votedCount 70707 Hääletanute koguarv vastavas asukohaüksuses
participationInfoRow/ percentage 57.5 Hääletamisest osavõtu protsent vastavas asukohaüksuses
participationInfoRow/ eVotes 5334 Antud e-hääli vastavas asukohaüksuses
overallStatistics Üleüldised hääletamisstatistika andmed (kuvatakse vaid Eesti Vabariigi korral)
overallStatistics/ statisticsRow/name Hääletanuid Väärtused:
  • Valijaid
  • Hääletanuid
  • Kehtivaid sedeleid
  • Kehtetuid sedeleid
  • Eelhääletanuid
  • Kodus hääletanuid
  • Elektrooniliselt hääletanuid
overallStatistics/ statisticsRow/value 586519 Eelmisele väärtusele vastav häälte hulk
XML tag Näide Kirjeldus
name Haljala vald Valla/linna nimi, mis vastava üksuse alla kuulub
code 0191 Valla/linna EHAK kood
participationInfoRow Valla/linna hääletamistulemuse andmed
participationInfoRow/ totalVotersInList 3764 Valijate koguarv vastavas vallas/linnas
participationInfoRow/ votedCount 2184 Hääletanute koguarv vastavas vallas/linnas
participationInfoRow/ percentage 58.0 Hääletamisest osavõtu protsent vastavas vallas/linnas

RK detailne hääletamistulemus riigis ja maakondades

Faili nimi on VOTING_RESULT_IN_COUNTIES.xml

XML tag Näide Kirjeldus
electionCode RK_2021 Valimissündmuse kood
reportType VOTING_RESULT_IN_COUNTIES Aruande nimi
generated 2017-10-19T10:50:09.474+03:00 Aruande genereerimise aeg
XML tag Näide Kirjeldus
adminUnitName Eesti Vabariik Asukoha nimetus, mille kohta hääletamistulemused käivad
ehakCode 0000 Asukoha EHAK-kood
overallStatistics Asukoha üleüldine hääletamisstatistika
XML tag Näide Kirjeldus
name Valijaid Võimalikud väärtused:
  • Valijaid
  • Hääletanuid
  • Kehtivaid sedeleid
  • Kehtetuid sedeleid
  • Kehtetuid sedeleid
  • Eelhääletanuid
  • Kodus hääletanuid
  • Elektrooniliselt hääletanuid
  • Välisriikides hääletanuid
value 1000000
XML tag Näide Kirjeldus
name Tallinna Haabersti, Põhja-Tallinna ja Kristiine linnaosa Valimisringkonna nimi või Eesti Vabariik
votersInList 130204 Valijate arv vastavas asukohas
percentage 12.0 Valimisaktiivsus vastavas asukohas
validVotes 15625 Kehtivate häälte arv vastavas asukohas
XML tag Näide Kirjeldus
districtName Tallinna Haabersti, Põhja-Tallinna ja Kristiine linnaosa Valimisringkonna nimi
districtNumber 1 Valimisringkonna number
districtSimpleQuota Kvoot
districtNumberOfMandates Mandaatide arv ringkonnas
participation Osavõtt valimisringkonnas
XML tag Näide Kirjeldus
name Põhja-Tallinna linnaosa Võimalikud väärtused:
  • Asukohaüksuse nimi, mis ringkonna alla kuulub (vald / linn / Tallinna korral linnaosa)
  • Välisriigid
  • E-hääled
  • Välisriigis elektrooniliselt
votersInList 80000 Valijate arv vastavas asukohaüksuses
votedCount 40000 Hääletanute arv vastavas asukohaüksuses
percentage 50.0 Valimisaktiivsus vastavas asukohaüksuses
validVotes 40000 Kehtivate häälte arv vastavas asukohaüksuses
XML tag Näide Kirjeldus
partyName Roheline Erakond Valimisringkonnas kandideerinud erakonna nimi
partyCode ROH Valimisringkonnas kandideerinud erakonna lühend
candidates Ringkonnas kandideerinud kandidaadid
totalRows Ringkonnas erakonna poolt saadud hääled
XML tag Näide Kirjeldus
forename Mari Kandidaadi eesnimi
surname Maasikas Kandidaadi perekonnanimi
candidateRegNumber 122 Kandidaadi registreerimisnumber
candidateId 10032 Kandidaadi ID
votesDistributionRow Häälte jaotus
XML tag Näide Kirjeldus
name Haabersti linnaosa Võimalikud väärtused:
  • Asukohaüksuse nimi, mis ringkonna alla kuulub (vald/linn/Tallinna korral linnaosa)
  • Hääli kokku
  • Väljaspoolt ringkonda hääled
  • Hääled välisriigist
  • E-hääled
value 24 Väärtusele vastav häälte arv
XML tag Näide Kirjeldus
rowName Nimekiri kokku Võimalikud väärtused:
  • Nimekiri kokku
  • Nimekiri %
  • Nimekiri kvoot
votesDistributionRow

Kui rowName = “Nimekiri kokku”, siis näeb eraldi väärtusi ringkonna peale kokku, asukohaüksuste kaupa (vald / linn / Tallinna korral linnaosa), mis ringkonna alla kuuluvad, väljaspoolt ringkonda saadud häälte kohta, välisriigist saadud häälte kohta ja e-häälte kohta.

Kui rowName = “Nimekiri %”, siis on samad tulemused protsentides, ainsana ei arvutata välisriigist saabunud häälte korral.

Kui rowName = “Nimekiri kvoot”, siis kuvatakse välja saadud kvoot.

Detailne hääletamistulemus valdades ja linnades

Andmefail võimaldab vaadata detailseid hääletamistulemusi konkreetse valla või linna kohta (Tallinna puhul linnaosade kaupa). Iga valla või linna kohta tekib eraldi XML fail. Andmed avaldatakse hetkel, mil selguvad esimesed hääletamistulemused vastavas asukohaüksuses (allkirjastatakse hääletamistulemuste protokoll või kui on selgunud e-häälte tulemused) ning uuendatakse seni, kuni kõik hääletamistulemustega seotud protokollid on VIS3-s allkirjastatud.

Valimissündmuste lõikes andmete struktuur varieerub:

  • Riigikogu valimistulemuste skeemifail on detailed-voting-result-municipality_rk_v1.xsd
  • Kohaliku omavalitsuse volikogu valimiste skeemifail on detailed-voting-result-municipality_kov_v1.xsd

KOV detailne hääletamistulemus valdades ja linnades

Faili nimi on kujul DETAILED_RESULT_PARISH_<EHAK_KOOD>.xml, kus EHAK-koodiks on valitud valla või linna EHAK-kood.

XML tag Näide Kirjeldus
electionCode KOV_2021 Valimissündmuse kood
reportType DETAILED_RESULT_PARISH Aruande nimi
generated 2017-10-19T10:50:09.474+03:00 Aruande genereerimise aeg
XML tag Näide Kirjeldus
fivePercentage 110.3500 5% künnis KOV-is
validVotedCount 2207 Kehtivaid hääli KOV-is
participationRows/participationRow Osavõtu andmed ringkonnas
partyVotesAndMandatesRows/ partyVotesAndMandatesRow Nimekirjade hääled ja mandaadid
districts/district Valimistulemused ringkondades
XML tag Näide Kirjeldus
name R1 Vastava ringkonna hääletanute statistika (R1…RN)
totalVotersInList 1290 Valijaid nimekirjas
votedCount 573 Hääletanuid
paperVotes 273 Paberhääletanute arv ringkonnas
eVotes 300 E-hääletanute arv ringkonnas
percentage 44.4 Hääletamisest osavõtu protsent
XML tag Näide Kirjeldus
sequenceNo 1 Poliitilise ühenduse liisu heitmise number. Kui kuvatakse KOKKU andmeid, siis ei täideta
name Eesti Sinine Erakond Erakonna või valimisliidu nimetus, “Üksikkandidaadid” või “KOKKU”
votesAndMandatesRows/ votesAndMandatesRow
votesAndMandatesRows/ votesAndMandatesRow/name H
  • H – nimekirjale antud häälte arv KOV-is kokku
  • % - KOV-is antud häältest
  • R1- ringkonnas 1 nimekirjale antud hääled
  • R2- ringkonnas 2 nimekirjale antud hääled
  • M - nimekirja poolt KOV-is saadud mandaate
  • % - KOV-i mandaatide koguarvust
  • R1- ringkonnas 1 nimekirja poolt saadud mandaate
  • ….
votesAndMandatesRows/ votesAndMandatesRow/value 120 “name”-le vastav väärtus
XML tag Näide Kirjeldus
districtNumber 1 Valimisringkonna number
mandateCount 19 Mandaatide arv valimisringkonnas kokku
simpleQuota 116.1579 Lihtkvoot
voteDistributionByParties/party Häälte jagunemine poliitiliste ühenduste kaupa
voteDistributionByParties/party/name Eesti Roheline Erakond Poliitilise ühenduse nimi
voteDistributionByParties/party/ candidates/candidate Vastava poliitilise ühenduse kandidaadid
voteDistributionByParties/party/ candidates/candidate/name Kati Vaarikas Kandidaadi ees- ja perekonnanimi
voteDistributionByParties/party/candidates/ candidate/candidateRegNumber 123 Kandidaadi registreerimisnumber
voteDistributionByParties/party/candidates/ candidate/vrd 53.3333 Võrdlusarv
voteDistributionByParties/party/candidates/ candidate/elected false Tunnus, kas kandidaat on osutunud valituks või ei
voteDistributionByParties/party/candidates/ candidate/votesDistributionRow/ votesDistributionCell Saadud häälte jagunemine
voteDistributionByParties/party/candidates/ candidate/votesDistributionRow/ votesDistributionCell/name R Vastavat tüüpi kandidaadile antud hääled, kus:
  • R - ringkonnas antud häälte arv kokku;
  • P - paberhäälte arv kokku (sh. teisest ringkonnast saabunud paberhääled);
  • E - e-häälte arv kokku;
  • JN - vastava ringkonna jaoskonnas antud häälte arv kokku.
  • VPR - väljaspool elukohajärgset ringkonda hääletanute pabersedeliga antud hääled
voteDistributionByParties/party/candidates/ candidate/votesDistributionRow/ votesDistributionCell/value 21 Vastavat tüüpi saadud häälte arv
voteDistributionByParties/party/ votesDistributionRow/votesDistributionCell Poliitilisele ühendusele antud hääled vastavas asukohaüksuses
voteDistributionByParties/party/ votesDistributionRow/votesDistributionCell/name R Vastavat tüüpi poliitilise ühenduse poolt kogutud häälte arv, kus:
  • R - ringkonnas antud häälte arv kokku;
  • P - paberhäälte arv kokku (sh. teisest ringkonnast saabunud paberhääled);
  • E - e-häälte arv kokku;
  • JN - vastava ringkonna jaoskonnas antud häälte arv kokku.
  • VPR - väljaspool elukohajärgset ringkonda hääletanute pabersedeliga antud hääled
voteDistributionByParties/party votesDistributionRow/votesDistributionCell/value 804 Vastavat tüüpi saadud häälte arv
votesDistributionRow/votesDistributionCell Ringkonnas antud häälte koguarvud
votesDistributionRow/votesDistributionCell/name R Vastavat tüüpi kogutud häälte arv, kus:
  • R - ringkonnas antud häälte arv kokku;
  • P - paberhäälte arv kokku (sh. teisest ringkonnast saabunud paberhääled);
  • E - e-häälte arv kokku;
  • JN - vastava ringkonna jaoskonnas antud häälte arv kokku.
  • VPR - väljaspool elukohajärgset ringkonda hääletanute pabersedeliga antud hääled
votesDistributionRow/votesDistributionCell/value 2600 Vastavat tüüpi antud häälte arv

RK detailne hääletamistulemus valdades ja linnades

Faili nimi on kujul VOTING_RESULT_IN_PARISH_<EHAK_KOOD>.xml, kus EHAK-koodiks on valitud valla või linna EHAK-kood.

XML tag Näide Kirjeldus
electionCode RK_2021 Valimissündmuse kood
reportType VOTING_RESULT_IN_PARISH Aruande nimi
generated 2017-10-19T10:50:09.474+03:00 Aruande genereerimise aeg
XML tag Näide Kirjeldus
adminUnitName Anija vald Valla/linna nimi
ehakCode 0141 Valla/linna EHAK-kood
voteDistributionByParties Häälte jagunemine vastavas vallas/linnas erakondade kaupa
XML tag Näide Kirjeldus
partyName Roheline Erakond Erakonna nimi
partyCode ROH Erakonna lühend
candidates Vastavas vallas/linnas kandideerinud erakonna kandidaadid
votesDistributionRow Erakonna poolt kogutud hääled kokku.

Kuvatakse eraldi K (kokku), P (saadud paberhääled), E (saadud e-hääled), J1…JN (saadud paberhääled jaoskonniti)

XML tag Näide Kirjeldus
forename Mari Kandidaadi eesnimi
surname Maasikas Kandidaadi perekonnanimi
candidateRegNumber 123 Kandidaadi registreerimisnumber
candidateId 100042 Kandidaadi ID
votesDistributionRow

Kandidaadi poolt kogutud hääled kokku.

Kuvatakse eraldi K (kokku), P (saadud paberhääled), E (saadud e-hääled), J1…JN (saadud paberhääled jaoskonniti)

Viimati uuendatud 25.08.2023