Valimiste avaandmete kasutusjuhend

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

Avaandmete veebilehe aadress on https://opendata.valimised.ee. Nimetatud 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

parties

 

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 RESULTS.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
  • R2 - 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 24.01.2023