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

שלב 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 43 or PositionID eq 61)&$top=120

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

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

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

הערה: נתוני הצבעות אינם זמינים דרך ה-API הציבורי של OData. הישויות KNS_VoteMain ו-KNS_VoteDetail אינן קיימות בשירות ה-OData הציבורי של הכנסת. לנתוני הצבעות, יש לפנות ישירות לאתר הכנסת או לבדוק אם קיימים מקורות מידע חלופיים.

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

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

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

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

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

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

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_PersonToPosition לתפקידים
3. חיפוש סיעה דרך KNS_Faction
4. הצגת פרופיל חבר הכנסת עם שיוך מפלגתי ותפקידים תוצאה: פרופיל חבר הכנסת עם רקע פוליטי. הערה: נתוני הצבעה לפי חבר כנסת אינם זמינים דרך ה-API הציבורי של OData.

דוגמה 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_Faction וישויות נוספות, תחביר סינון OData v3 וקודי תפקידים (43=ח"כ זכר, 61=ח"כ נקבה, 45=ראש ממשלה, 39=שר זכר, 57=שרה נקבה). הערה: נתוני הצבעות אינם זמינים דרך ה-API הציבורי של OData. יש לעיין במסמך בעת בניית שאילתות 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_". ניתן לשלוח שאילתה לשורש השירות לקבלת רשימת הישויות הזמינות.