README.md

rada4you

Портал "rada4you" розроблений Громадянською мережею ОПОРА та партнерами. Дізнайся, як нардепи голосували у Раді за проекти рішень, які важливі для тебе. Це може тебе здивувати. Поділися з іншими, поширюй правду.

Огляд

Це бібліотека для роботи з API порталу "Вони голосують для тебе". Вона має 10 базових функцій. Що вони роблять?

УВАГА

Для роботи із бібліотекою тобі потрібен key – унікальний API ключ для роботи з порталом RADA4YOU. Отримати ключ можна тут.

Встановлення

# install.packages("devtools")
devtools::install_github("savchukidze/rada4you")

Функції

mps("key") - видає датафрейм із базовою інформацією про кожного народного депутата, який наразі є 
членом парламенту. 

* key - персональний ключ API.

|Параметр|Опис| | --- | --- | | mp_id | Унікальний визначник для кожного депутата | | mp_name | Ім'я та прізвище нардепа | | party | Фракційність парламентаря | | electorate | Спосіб обрання депутата: список/назва області |

mps_info(mp_id, "key") – видає датафрейм із деталізованою інформацією про кожного народного депутата.

* id - вектор, який містить щонайменше один id парламентаря.

|Параметр|Опис| | --- | --- | | mp_id | Унікальний визначник для кожного депутата | | mp_name | Ім'я та прізвище нардепа | | party | Фракційність парламентаря | | electorate | Спосіб обрання депутата: список/назва області | | rebellions | Кількість голосувань проти лінії фракції | | votes_attended | Загальна кількість голосувань | | votes_possible | Кількість можливих голосувань, де нардеп міг голосувати |

policies("key") – видає датафрейм із базовою інформацію про усі політики.

|Параметр|Опис| | --- | --- | | policy_id | Унікальний визначник для політики | | policy_name | Коротка назва політики | | description | Більше деталей про цю політику | | provisional | TRUE або FALSE (проект політики, яка ще не завершена і не відображається за замовчуванням) |

policy_info(policy_id, "key") – видає датафрейм із переліком голосувань, що включені до певної політики.

* policy_id – вектор, який містить щонайменше один id політики.

|Параметр|Опис| | --- | --- | | policy_id | Унікальний визначник для політики | | policy_name | Коротка назва політики | | description | Більше деталей про цю політику | | provisional | TRUE або FALSE (проект політики, яка ще не завершена і не відображається за замовчуванням) | | vote__id | Унікальний визначник для голосування | | vote_name | Скорочена назва голосування | | date | Дата в форматі yyyy-mm-dd | | time | Час голосування в форматі hh:mm AM або hh:mm PM, чи null, якщо недоступний | | aye_votes | Кількість депутатів, які проголосували “ЗА” | | no_votes | Кількість депутатів, які проголосували “ПРОТИ” | | rebellions | Загальна кількість голосів, які проти лінії фракції |

mps_policies(mp_id, "key") – видає датафрейм із рівнем підтримки певного депутата кожної з політик.

|Параметр|Опис| | --- | --- | | mp_id | Унікальний визначник для кожного депутата | | mp_name | Ім'я та прізвище нардепа | | party | Фракційність парламентаря | | electorate | Спосіб обрання депутата: список/назва області | | policy_id | Унікальний визначник для політики | | policy_name | Коротка назва політики | | description | Більше деталей про цю політику | | provisional | TRUE або FALSE (проект політики, яка ще не завершена і не відображається за замовчуванням) | | agreement | Рівень підтримки політики нардепом у проміжку від 0 до 100 | | voted | TRUE або FALSE. Показує, чи нардеп колись голосував за законопроект з цієї політики |

policy_mps(policy_id, "key") – видає датафрейм із рівнем підтримки політики кожним з нардепів.

|Параметр|Опис| | --- | --- | | policy_id | Унікальний визначник для політики | | policy_name | Коротка назва політики | | description | Більше деталей про цю політику | | provisional | TRUE або FALSE (проект політики, яка ще не завершена і не відображається за замовчуванням) | | mp_id | Унікальний визначник для кожного депутата | | mp_name | Ім'я та прізвище нардепа | | party | Фракційність парламентаря | | electorate | Спосіб обрання депутата: список/назва області | | agreement | Рівень підтримки політики нардепом у проміжку від 0 до 100 | | voted | TRUE або FALSE. Показує, чи нардеп колись голосував за законопроект з цієї політики |

votings("start_date", "end_date", "key") – видає датафрейм з усіма голосуваннями за обраний період.

* start_date – перший день обраного періоду
* end_date – останній день обраного періоду

! end_date ≥ start_date

|Параметр|Опис| | --- | --- | | vote_id | Унікальний визначник для голосування | | vote_name | Скорочена назва голосування | | date | Дата в форматі yyyy-mm-dd | | time | Час голосування в форматі hh:mm AM або hh:mm PM, чи null, якщо недоступний | | aye_votes | Кількість депутатів, які проголосували “ЗА” | | no_votes | Кількість депутатів, які проголосували “ПРОТИ” | | possible_turnout | Кількість діючих депутатів на момент голосування | | rebellions | Загальна кількість голосів, які проти лінії фракції | | edited | TRUE, якщо опис голосування був відредагований |

voting_info(vote_id, "key") – видає датафрейм із деталізованою інформацією про кожне голосування.

|Параметр|Опис| | --- | --- | | vote_id | Унікальний визначник для голосування | | vote_name | Скорочена назва голосування | | date | Дата в форматі yyyy-mm-dd | | time | Час голосування в форматі hh:mm AM або hh:mm PM, чи null, якщо недоступний | | aye_votes | Кількість депутатів, які проголосували “ЗА” | | no_votes | Кількість депутатів, які проголосували “ПРОТИ” | | possible_turnout | Кількість діючих депутатів на момент голосування | | rebellions | Загальна кількість голосів, які проти лінії фракції | | edited | TRUE, якщо опис голосування був відредагований | | summary | Якщо edited є TRUE, тоді це остання версія опису. | | bill_id | Унікальний визначник законопроекту, що пов'язаний з голосуванням | | bill_number | Номер законопроекту у форматі №1234 | | bill_title | Назва законопроекту | | bill_url | Гіперпосилання на законопроект на сайті ВРУ |

voting_policies(vote_id, "key") – видає датафрейм із сукупністю політик, до яких підв`язане певне голосування.

|Параметр|Опис| | --- | --- | | vote_id | Унікальний визначник для голосування | | vote_name | Скорочена назва голосування | | date | Дата в форматі yyyy-mm-dd | | bill_number | Номер законопроекту у форматі №1234 | | policy_id | Унікальний визначник для політики | | policy_name | Коротка назва політики | | description | Більше деталей про цю політику | | provisional | TRUE або FALSE (проект політики, яка ще не завершена і не відображається за замовчуванням) | | vote | Кожне голосування має відповідне vote | | strong | TRUE або FALSE. Показує важливість голосування|

voting_mps(vote_id, "key")`** – видає датафрейм із голосуванням кожного з депутатів щодо певного голосування.

|Параметр|Опис| | --- | --- | | vote_id | Унікальний визначник для голосування | | vote_name | Скорочена назва голосування | | bill_id | Унікальний визначник законопроекту, що пов'язаний з голосуванням | | bill_number | Номер законопроекту у форматі №1234 | | bill_title | Назва законопроекту | | date | Дата в форматі yyyy-mm-dd | | mp_id | Унікальний визначник для кожного депутата | | mp_name | Ім'я та прізвище нардепа | | party | Фракційність парламентаря | | electorate | Спосіб обрання депутата: список/назва області | | vote | Голосування депутата: aye, against, not voting, abstention |



savchukidze/rada4you documentation built on April 6, 2021, 1:42 a.m.