מפרט נתוני הבחירות של מספר זהות

מסמך זה מכיל מפרט עבור הנתונים הדרושים Google לספק את מיקום הקלפי ומידע על המועמדים בחירות לאומיות. המסמך הזה הוא מפרט טיוטה שמטרתו העיקרית היא לבקש משוב ועשוי להשתנות בעתיד.

טבלאות

יש לספק את קבוצת הטבלאות הבאה כערכים נפרדים מופרד בטאבים value (ערכים המופרדים באמצעות TAB (TSV) ). כל קובץ צריך להתחיל שורת הכותרת המפרטת את השדות לאותה טבלה. שדות אופציונליים לכותרות אין צורך להיכלל אם אין נתונים מתאימים השדה הזה. השורות הבאות בקובץ מכילות את שורות הנתונים עם באותו סדר כמו אלה שצוינו בשורת הכותרת.

צריך לתת לקבצים שמות מתאימים ולהיות מקובצים בתוך קובץ ZIP לארכיון. השמות של הקבצים צריכים להיות: votesrs.tsv, votesGroups.tsv, Departments.tsv, polyingLocations.tsv, leads.tsv, Office.tsv.

אלא אם צוין אחרת, כל אחד מהשדות במפרט הזה מחרוזת. בקובצי TSV אין צורך בתו בריחה (escape) באמצעות פסיקים או תווים מיוחדים תווים שהם לא כרטיסיות. מאחר שכרטיסיות לא מתאימות בשדות בכל אחת מהטבלאות, אנחנו אוסרים באופן מפורש להיות בשדה.

* משמש לציון שדה חובה בטבלה
** משמש כדי לציין שדה חובה שהוא גם מפתח ראשי עבור הטבלה הזו (שתי שורות לא יכולות להכיל את אותו הערך בשדה הזה)
^Æ מציין שדה שצריך להיות בינלאומי.

אינטרנציונליזציה

כדי לוודא שהנתונים מוצגים בשפה הנכונה חלק מהשדות בשורת הכותרת צריכים לכלול מפרט לוקאל. מאחר שבחלק מהמדינות יש יותר מנתוני שפה אחת, סופקו ביותר משפה אחת. עבור מדינות כאלה, העמודות יכולות להיות חוזר על עצמו עם לוקאל אחר המצורף לסוף העמודה והם מופרדים באמצעות מקף, למשל PartyAffiliation-en.

כדי ליצור לוקאלים, קראו את דף Google APIs בכתובת מזהים של שפות, מדינות, מטבעות ואזורי זמן. המפרטים האלה מסתמכים על שיטות מומלצות נוכחיות 47 – תגים לזיהוי שפות (BCP 47). מידע נוסף זמין בנספח A של BCP 47 כדי לראות דוגמאות של תגי שפה.

טבלה 1 – טבלת מצביעים (חובה)

NationalVoterId**, VoterGroupId

שורה בטבלת הבוחרים מייצגת מצביע יחיד. כל מצביע למדינה יש תעודת זהות או תעודה מזהה של מצביע. הפרטים האלה מאוחסנים שדה NationalPercentrId. VoterGroupId מציינת איזו קבוצת הצבעות הזו שייך לבוחר.

הערות: במדינות שבהן לא קיימת קבוצת הצבעה לוגית, VoterGroupId יכול להיות חזרה על ה-National הדיגיטלייםrId, ובמקרה כזה טבלת קבוצות ההצבעה (טבלה 2) תקצה את המצביעים ישירות אל מזהי מחוזות ומזהים של מיקומי קלפיות.

טבלה 2 – טבלה של קבוצת הצבעה (חובה)

VoterGroupId**, PollingLocationId*, ProvinceDistrictId, CountyDistrictId, LocalityDistrictId

שורה בטבלה הזו מציינת קבוצת הצבעה שבה הקבוצה הזו הצבעות (דרך PollingLocationId), ואילו מחוזות קבוצת ההצבעה הזו שייך אל. כל קבוצת הצבעות מזוהה באופן ייחודי באמצעות VoterGroupId. ניתן לציין מזהי מחוזות מרובים מפני קבוצות ההצבעה עשויות להצביע לנציגים רשמיים שונים ברמות שונות של ממשלתי. לדוגמה, בארה"ב אפשר להצביע למשרת מושל במדינה ברמת המדינה, מנהל מחוז ברמת המחוז וראש עיר ברמת העיר.

הערות: כל אדם בקבוצת קלפיות צריך להיות ולהצביע באותן מערכות בחירות ובאותו קלפי. א' צריך לפצל את קבוצת ההצבעה למספר קבוצות הצבעה, זה לא המקרה.

טבלה 3 – טבלת מחוז (חובה)

DistrictId**, AuthorityName*, LocalElectionOfficialName*, LocalElectionOfficialPhone*, LocalElectionUrl*, LocalElectionOfficialEmail, LocalElectionOfficialAddress

כל שורה בטבלת המחוז מכילה נתונים של מחוז הצבעה כולל מידע על הנציגים הרשמיים של הבחירות המקומיות. שם הרשות צריך לכלול את שם המחוז, במקרים הרלוונטיים. לדוגמה מחוז קולומביה.

טבלה 4 – מיקום תשאול (חובה)

PollingLocationId**, Address*Æ, Latitude, Longitude, HoursOfOperationÆ, AdditionalDirectionsÆ, ContactInfoÆ

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

השדה MoreDirections הוא אופציונלי ועשוי להכיל הוראות הגעה שנדרשים למציאת קלפי, לדוגמה בתוך המבנה שצוינה על ידי הכתובת. השדה ContactInfo צריך להכיל את המידע הדרוש כדי ליצור קשר עם הנציגים הרשמיים שאחראים לכך מיקום הקלפי.

טבלה 5 – טבלת הצעות (חובה)

CandidateId**, CandidateName*Æ, PartyAffiliationÆ, OfficeId*, Url, CampaignAddressÆ, Photo, Phone, TwitterHandle, FacebookUsername, Email, YoutubeChannel

כל שורה בטבלת ההצעות מייצגת מועמד. CandidateId שמזהה באופן ייחודי מועמד. שדה המשרד מכיל את השם של התפקיד שהמועמד הזה מתמודד איתו. שדות אחרים בקטע הזה טבלה שמספקת מידע על המועמד.

שולחן 6 - שולחן משרדי

OfficeId**, DistrictId*, NameÆ, TermÆ, DescriptionÆ

לכל משרד יש שורה בטבלה הזו שמזוהה באופן ייחודי באמצעות מזהה משרד. השם והתיאור של המשרד כלולים גם הם. השדה DistrictId חייב לציין אחד ממזהי המחוז המפורטים ב- השדות RegionDistrictId, StateDistrictId או LocalityDistrictId. בטבלה 'קבוצת הצבעה'. למשרדים שעליהם הצביעו כולם מצביעים, יש להשתמש ב-ALL כמזהה המחוז.

דוגמאות

כותרות של קובצי נתוני מיקום לדגימה לדוגמה

קובץ: votesrs.tsv
כותרת:

NationalVoterId        VoterGroupId

קובץ: PointGroups.tsv
כותרת:

VoterGroupId        PollingLocationId

קובץ: PolingLocations.tsv
כותרת:

PollingLocationId        Address        HoursOfOperation

כותרת לדוגמה של קובץ בכמה שפות

אם למדינה מסוימת היו מספר שפות, יכול להיות שהכותרת של כל קובץ כוללת שדות נוספים שמציינים את השפה/הלוקאל של הנתונים הכלולים בשדה הזה. רק שדות שמסומנים כשדות מתאימים לבינלאומיות, כלומר, באמצעות הסמן ^Æ, בתיאורי הטבלה שלמעלה המקום צורף.

קובץ: PolingLocations.tsv
כותרת:

PollingLocationId        Address        HoursOfOperation-en        HoursOfOperation-fr

בדוגמה הפשוטה הזו אפשר לראות את שדה שעות הפעילות באנגלית וצרפתית.