נתוני בחירות בישראל

שלב 1: זיהוי סוג המידע הנדרש

שלב 2: שאילתות ל-API של הכנסת

כתובת בסיס: https://knesset.gov.il/Odata/ParliamentInfo.svc/

תבנית שאילתה:

GET {BASE_URL}/{ENTITY}?$format=json&$filter={FILTER}&$top={LIMIT}&$select={FIELDS}

קבלת כל חברי הכנסת בכנסת הנוכחית (ה-25):

GET .../KNS_PersonToPosition?$format=json&$filter=KnessetNum eq 25 and PositionID eq 54&$top=120

חיפוש חבר כנסת לפי שם:

GET .../KNS_Person?$format=json&$filter=substringof('name', LastName)&$top=10

שלב 3: גישה לנתוני הצבעות

קבלת הצבעות לכנסת מסוימת:

GET .../KNS_VoteMain?$format=json&$filter=KnessetNum eq 25&$top=50

קבלת הצבעות של חבר כנסת בהצבעה ספציפית:

GET .../KNS_VoteDetail?$format=json&$filter=VoteID eq {VOTE_ID}&$top=120

מיפוי ערכי הצבעה:

• 1 = בעד
• 2 = נגד
• 3 = נמנע
• 4 = נעדר

שלב 4: מעקב אחר חקיקה

חיפוש הצעות חוק:

GET .../KNS_Bill?$format=json&$filter=KnessetNum eq 25 and substringof('keyword', Name)&$top=50

קודי סטטוס של הצעת חוק:

• 108 = בהכנה
• 118 = אושרה בקריאה ראשונה
• 120 = אושרה (הפכה לחוק)
• 125 = נדחתה

שלבי הליך החקיקה:

1. טיוטת הצעת חוק -- הצעת חוק פרטית או ממשלתית
2. קריאה טרומית -- להצעות חוק פרטיות בלבד, הצבעה במליאה
3. דיון בוועדה -- העברה לוועדה הרלוונטית
4. קריאה ראשונה -- הצבעה במליאה על עקרונות החוק
5. הכנה בוועדה -- דיון פרטני סעיף-סעיף
6. קריאה שנייה -- הצבעה במליאה סעיף-סעיף
7. קריאה שלישית -- הצבעה סופית על החוק כולו
8. פרסום -- פרסום ברשומות, החוק נכנס לתוקף

שלב 5: תוצאות בחירות

גישה לנתוני בחירות מהוועדה המרכזית לבחירות (votes.gov.il):

• תוצאות סופיות לפי קלפי (~12,000 עמדות הצבעה)
• רשימות מפלגות ומועמדים
• אחוזי הצבעה לפי יישוב
• נתונים היסטוריים ל-25 מערכות בחירות לכנסת מאז 1949

עובדות על שיטת הבחירות:

• 120 מושבים, ייצוג יחסי
• אחוז חסימה: 3.25%
• שיטת ד'הונדט מעודכנת (בדר-עופר) להקצאת מושבים
• הסכמי עודפים בין מפלגות

שלב 6: מידע על מפלגות וקואליציות

קבלת סיעות בכנסת מסוימת:

GET .../KNS_Faction?$format=json&$filter=KnessetNum eq 25

מונחים פוליטיים ישראליים:

דוגמה 1: חיפוש חבר כנסת

המשתמש אומר: "ספר לי על הצבעות של חבר הכנסת [שם]" פעולות:

1. חיפוש ב-KNS_Person לפי שם
2. קבלת PersonID ושאילתה ל-KNS_VoteDetail
3. חישוב שיעור השתתפות בהצבעות ודפוסי הצבעה
4. הצגת סיכום עם פירוט בעד/נגד/נמנע תוצאה: פרופיל חבר הכנסת עם סטטיסטיקת הצבעות.

דוגמה 2: מעקב אחר הצעת חוק

המשתמש אומר: "מה קרה עם הצעת החוק בנושא [נושא]?" פעולות:

1. חיפוש ב-KNS_Bill עם מילת מפתח
2. קבלת סטטוס ההצעה והשלב הנוכחי
3. איתור יוזמי ההצעה דרך KNS_BillInitiator
4. בדיקת שיבוץ לוועדות וקריאות תוצאה: סטטוס הצעת החוק עם היסטוריית חקיקה מלאה.

דוגמה 3: ניתוח תוצאות בחירות

המשתמש אומר: "הראה לי תוצאות בחירות בחיפה בבחירות האחרונות" פעולות:

1. גישה לנתוני הוועדה המרכזית לבחירות עבור הכנסת ה-25
2. סינון לפי קלפיות בחיפה
3. צבירת תוצאות לפי מפלגה
4. השוואה לתוצאות הארציות תוצאה: פירוט תוצאות בחירות בחיפה לפי מפלגות.

סקריפטים

• scripts/query_knesset.py — שאילתות ל-API של הכנסת (OData) לרשימת חברי כנסת לפי כהונה, חיפוש חברי כנסת לפי שם, שליפת הצבעות מליאה עם פירוט בעד/נגד/נמנע, חיפוש הצעות חוק לפי מילת מפתח, והצגת סיעות. תומך בפקודות: mks, search-mk, votes, vote-detail, bills, factions. הרצה: python scripts/query_knesset.py --help

חומרי עזר

• references/knesset-api-entities.md — מדריך ישויות מלא ל-API של הכנסת (OData) כולל שמות שדות עבור KNS_Person, KNS_Bill, KNS_VoteMain, KNS_VoteDetail, KNS_Faction וישויות נוספות, תחביר סינון OData v3 וקודי תפקידים (54=ח"כ, 39=ראש ממשלה, 12=שר). יש לעיין במסמך בעת בניית שאילתות OData או מיפוי קודי הצבעה.

שגיאה: "OData query syntax error"

סיבה: תחביר שגוי בשאילתת OData v3 פתרון: יש להשתמש ב-eq להשוואה, and/or ללוגיקה, substringof('text', Field) לחיפוש טקסט. יש לוודא שערכי מחרוזות עטופים בגרשיים בודדים.

שגיאה: "Data returned in Hebrew"

סיבה: נתוני הכנסת הם בעיקר בעברית פתרון: שמות השדות הם באנגלית (camelCase), אך הערכים (שמות, טקסט הצעות חוק וכו') הם בעברית. ניתן להשתמש בתרגום או לשמור על העברית לדיוק.

שגיאה: "Entity not found"

סיבה: שם הישות רגיש לאותיות גדולות/קטנות (case-sensitive) פתרון: יש להשתמש בשמות ישויות מדויקים כפי שמתועדים: KNS_Person, KNS_Bill וכו'. כולם מתחילים בקידומת "KNS_". ניתן לשלוח שאילתה לשורש השירות לקבלת רשימת הישויות הזמינות.