אפשר להשתמש ב-Contest כדי לתאר תחרות ולקשר אותה למועמדים ולמפלגות שקשורים אליה.
במסמך הזה מוסבר על Contest ועל ישויות המשנה שלו:
ContestCandidateContestPartyContestBallotMeasureContestRetentionContest
סוגים
Contest הוא רכיב מופשט עם שלושה סוגים שמשמשים בהתאם לסוג התחרות:
-
CandidateContest: משתמשים בסוג הזה כשContestכולל מועמד אחד או יותר לתפקיד. -
PartyContest: משתמשים בסוג הזה כשבפתק ההצבעה שלContestיש רשימת מפלגות לבחירה. אפשר להשתמש בזה גם כתחרות וירטואלית שהיא סיכום של קבוצה גדולה יותר של תחרויות קטנות יותר. -
BallotMeasureContest: משתמשים בסוג הזה כשContestכולל הצבעה על הצעה אחת או יותר. -
RetentionContest: משתמשים בסוג הזה כשContestכולל משאל עם כדי להחליט אם נבחר ציבור צריך להישאר בתפקיד או להיות מודח ממנו.
כשמתפרסמות תוצאות הבחירות, אפשר לעדכן את הפיד כדי להציג שלבים שונים של התוצאות, כמו מדגם בחירות או הערכות. Google מספקת הנחיות לגבי שלבי הבחירות וסוגי התוצאות שאנחנו צפויים לראות. יכול להיות ש-Google תבקש שלב אחד או יותר. הערכים האלה של סוג השלב עשויים להשתנות במהלך ליל הבחירות. מגדירים את הערך הראשוני של הפיד לשלב שרוצים להתחיל ממנו. פרטים נוספים זמינים במאמר ExternalIdentifiers בקטע רכיבים.
מאפיינים
בטבלה הבאה מפורטים המאפיינים של Contest:
| מאפיין | חובה? | סוג | תיאור |
|---|---|---|---|
objectId |
חובה | ID |
מזהה פנימי ייחודי שמשמש רכיבים אחרים כדי ליצור הפניה לרכיב הזה. |
רכיבים
בטבלה הבאה מפורטים הרכיבים של Contest:
| רכיב | ריבוי | סוג | תיאור |
|---|---|---|---|
Abbreviation |
0 או 1 | string |
השם הקצר של התחרות. |
AggregateBallotSelection |
0 או 1 | SpecialBallotSelection |
בחירת פתקי הצבעה לצורך צבירת נתונים של ספירת קולות, כמו צבירה של כמה מועמדים לקטגוריה 'אחרים'. |
BallotSelection |
0 או יותר | BallotSelection |
משייך את הבחירות בפתק ההצבעה לתחרות. הסדר
של המועמדים או המפלגות ב- אם המאפיין |
BallotSubTitle |
0 או 1 | InternationalizedText |
כותרת המשנה של התחרות, שצריכה להיות זהה למה שמופיע בפתקי ההצבעה. |
BallotTitle |
0 או 1 | InternationalizedText |
שם התחרות. הטקסט של שם הפריט צריך להיות תואם למדריך התחביר. בתחרויות בנושא הצעות חוק, השם צריך להיות זהה לנוסח שמופיע בפתק ההצבעה. |
BlankBallotSelection |
0 או 1 | SpecialBallotSelection |
בחירת פתק הצבעה לפתקים ריקים. |
ComposingContestIds |
0 או יותר | IDREFS |
משמש להגדרת תחרות איחוד לתצוגה אחת. לדוגמה, בבחירות הכלליות לנשיאות ארה"ב, יש תחרות ברמה הלאומית עם מזהי תחרות מורכבים לכל אחת מהבחירות ברמת המדינה. התחרות |
ContestDateStatus |
0 או 1 |
DateStatus
|
הרכיב הזה מציין עדכונים לגבי תזמון של בחירות. ערך ברירת המחדל הוא |
CountingDate |
0 או 1 | PartialDate |
התאריך שאחרי ההצבעה שבו מתבצעת ספירת הקולות בבחירות.
צריך לכלול את הפרמטר הזה רק אם יום הספירה שונה מהיום האחרון להצבעה, למשל בבחירות ללוק סבהה בהודו. בדרך כלל הספירה מתבצעת באותו יום שבו מתקיים יום ההצבעה האחרון, כלומר בEndDate של הבחירות.
|
CurrentResultsReportingStage |
1 | ResultsReportingStageType |
השלב הנוכחי של דיווח התוצאות בתחרות. |
EarliestPollsClose |
0 או 1 | dateTime |
כשנסגרות הקלפיות הראשונות. אם לא צוין אחרת, התחרויות שיוגדרו יקבלו את ההגדרה הזו מהתחרות הראשית. |
ElectoralDistrictId |
1 | IDREF |
מזהה ייחודי של רכיב לדוגמה, בתחרות ספציפית, יכול להיות ש |
ExternalIdentifiers |
1 | ExternalIdentifiers |
משייך מזהה לתחרות. צריך לציין מזהה יציב. כדי לציין את השלב בתוצאות הבחירות שמדווח בפיד, מגדירים את המאפיין OtherType עם ערך מתוך ContestStage. |
EndDate |
0 או 1 | PartialDate |
תאריך הסיום של התחרות ביומן. משתמשים בתאריך שבו מסתיימת ההצבעה, למשל 2022-11-08. תאריך הסיום צריך להיות מוגדר רק אם תאריך ההתחלה ותאריך הסיום של Contest שונים מתאריך ההתחלה ותאריך הסיום של Election.
|
FilingDeadline |
0 או 1 | PartialDate |
התאריך האחרון להגשת מועמדות לתחרות. |
HasRotation |
0 או 1 | boolean |
מציין אם הבחירות בתחרות מוחלפות. אם הרכיב הזה לא מופיע, ערך ברירת המחדל הוא false. |
IsNotable |
0 או 1 | boolean |
האם הישות נחשבת לראויה לציון. אם לא מציינים ערך, ברירת המחדל היא false.
|
LatestPollsClose |
0 או 1 | dateTime |
כשהקלפיות האחרונות נסגרות. אם לא צוין אחרת, התחרויות שיוגדרו יקבלו את ההגדרה הזו מהתחרות הראשית. |
Name |
1 | string |
השם הזה צריך להיות זהה לBallotTitle באנגלית, ולהתאים לתחביר של שם הפריט. |
NoneOfTheAboveBallotSelection |
0 או 1 | SpecialBallotSelection |
בחירה בקלפי באפשרות להצביע ל'אף אחת מהאפשרויות שלמעלה' או לאפשרות שוות ערך, כמו 'אף אחת', 'אף אחת מהאפשרויות האלה' או 'לא החלטתי'. |
NullBallotSelection |
0 או 1 | SpecialBallotSelection |
בחירת פתק הצבעה לפתקי הצבעה פסולים או ריקים. אלה פתקי הצבעה שסומנו באופן שלא מאפשר לספור את ההצבעה בצורה תקינה. דוגמאות לפתקי הצבעה פסולים: פתקים קרועים, מוכתמים, עם סימון יתר או סימון חסר, או פתקים שסומנו באופן שיכול לחשוף את זהות המצביע. |
Seat |
0 או 1 | string |
המושב הספציפי שאליו מתייחסת התחרות. |
SequenceOrder |
0 או 1 | integer |
סדר ברירת המחדל של רכיבי
הפרמטר |
StartDate |
0 או 1 | PartialDate |
תאריך ההתחלה של התחרות ביומן. משתמשים בתאריך שבו מתחילים את הסקר, למשל 2022-11-08. תאריך ההתחלה צריך להיות מוגדר רק אם תאריכי ההתחלה והסיום של Contest שונים מתאריכי ההתחלה והסיום של Election.
|
SubsequentContestId |
0 או 1 | IDREF |
משמש להפניה לתחרות מאוחרת יותר באותה קבוצה קשורה. לדוגמה, בבחירות בארה"ב, בדרך כלל יש קישור מבחירות מקדימות לבחירות הכלליות שקשורות אליהן. היא יכולה גם להפנות מבחירות כלליות לבחירות חוזרות. לרוב, |
SubUnitsReported |
0 או 1 | integer |
מספר יחידות המשנה, כמו מחוזות בחירה, שהשלימו את דיווח ההצבעות בתחרות הזו. |
SummaryCounts |
0 או יותר | SummaryCounts |
סיכום של מספרים שונים שקשורים לתחרות. הנתונים כוללים את המספר הכולל של פתקי ההצבעה שהוגשו ומכילים את התחרות, ואת המספר הכולל של ההימנעויות, ההצבעות הכפולות, ההצבעות החלקיות או ההצבעות למועמדים שלא מופיעים ברשימה. אפשר לשייך את מספרי הסיכום לתחרות כולה או ליחידות דיווח אחרות ברמה נמוכה יותר באמצעות שימוש בכמה מופעים של SummaryCounts. |
TotalSeats |
0 או 1 | integer |
המספר הכולל של המושבים במחוז הבחירה שבהם אפשר להתמודד על התפקיד הזה. הערך הזה שווה למספר המושבים שנכללים בבחירות + מספר המושבים שנותרו + מספר המושבים הפנויים. |
TotalSubUnits |
0 או 1 | integer |
המספר הכולל של יחידות המשנה, כמו מחוזות בחירה, שבהן התחרות הזו מופיעה בפתק ההצבעה. |
VoteVariation |
0 או 1 | VoteVariation |
סוג וריאציית ההצבעה שמשויכת לתחרות, כמו
n-of-m. |
OtherVoteVariation |
0 או 1 | string |
המאפיין הזה משמש כדי לספק ערך מותאם אישית כשערך המאפיין VoteVariation הוא other. |
ResultsEmbargoEnd |
0 או 1 | dateTime |
כשמסתיים האמברגו על פרסום תוצאות הבחירות. תחרויות יורשות את ההגדרה הזו מהתחרות הראשית אם היא לא מוגדרת בהן. |
ResultsExpected |
0 או 1 | dateTime |
מתי צפויות להופיע בפיד תוצאות הספירה הראשונה של הקולות. תחרויות שנוצרות יקבלו את ההגדרה הזו מהתחרות הראשית אם היא לא מוגדרת. |
ResultsReportingStageCollection |
0 או 1 | לא רלוונטי | רכיב wrapper להגדרות של ResultsReportingStage. פרטים נוספים זמינים במאמר בנושא ישויות אוסף. |
CandidateContest
אפשר להשתמש ב-CandidateContest כדי לתאר תחרות שכוללת בחירה של מועמד אחד או יותר.
הישות הזו יכולה להפנות באופן אופציונלי אל Office
או אל Party באמצעות מזהה. אנחנו לא תומכים בהצגה של כרטיס של מועמדים באותו מבצע. אפשר להפנות רק אל Office אחד. לדוגמה, כדי להציג כרטיס של נשיא וסגן נשיא, צריך להשתמש בשני Candidate תחרויות. כל אחד מהם יתייחס למשרד אחר.
רכיבים
בטבלה הבאה מפורטים הרכיבים של CandidateContest:
| רכיב | ריבוי | סוג | תיאור |
|---|---|---|---|
NumberElected |
0 או 1 | integer |
מספר המועמדים שנבחרים בתחרות, כלומר n בתחרות n-of-m. אם התג NumberElected לא מופיע בפיד, המערכת משתמשת בערך ברירת המחדל 1. |
OfficeIds |
1 | IDREFS |
מזהה ייחודי של רכיב Office אחד או יותר. משייך תיאור של משרה לתחרות. |
PrimaryPartyIds |
0 או יותר | IDREFS |
מזהה ייחודי של אלמנט אחד או יותר מסוג
Party, שמציין שאלמנט Contest הוא חלק מבחירות מקדימות של מפלגה. PrimaryPartyId רלוונטי רק לבחירות מקדימות. |
VotesAllowed |
1 | integer |
המספר המקסימלי של קולות או שמות של מועמדים שאפשר להוסיף לרשימה שמותר לכל מצביע להצביע עבורם בתחרות הזו. אם המאפיין VotesAllowed לא מופיע בפיד, נעשה שימוש בערך ברירת המחדל 1. |
Type |
0 או יותר | ElectionType |
הסוג המפורט של תחרות, כמו ראשונית או כללית. צריך להגדיר את סוג Contest רק אם הוא שונה מהסוג של Election. |
דוגמאות
XML
<Contest xsi:type="CandidateContest" objectId="c-1-001"> <Abbreviation>KENYAPRES</Abbreviation> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-kenyatta">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-odinga">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-mudavadi">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-kenneth">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-dida">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-karua">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-kiyiapi">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs-1-001-muite">...</BallotSelection> <BallotTitle> <Text language="en">2022 Kenya Presidential election</Text> <Text language="es">2022 Elecciones presidenciales de Kenia</Text> <Text language="fr">2022 Élection présidentielle au Kenya</Text> </BallotTitle> <CountStatus>...</CountStatus> <CountingDate>2022-08-11</CountingDate> <ElectoralDistrictId>...</ElectoralDistrictId> <EndDate>2022-08-09</EndDate> <Name>2022 Kenya Presidential election</Name> <StartDate>2022-08-09</StartDate> <SubUnitsReported>48</SubUnitsReported> <SummaryCounts>...</SummaryCounts> <TotalSubUnits>48</TotalSubUnits> <VoteVariation>1-of-m</VoteVariation> <NumberElected>1</NumberElected> <OfficeIds>off-9999a</OfficeIds> <VotesAllowed>1</VotesAllowed> <Type>general</Type> </Contest>
PartyContest
אפשר להשתמש ב-PartyContest לתחרות שבה המצביעים בוחרים מפלגה בפתק ההצבעה.
אפשר להשתמש בזה גם בפיד של תוצאות בחירות בתור תחרות סיכום וירטואלית כדי להציג נתונים מצטברים (לדוגמה, תחרות של מפלגה ברמת המדינה שמציגה תוצאות מצטברות של תחרות במחוז בחירה).
רכיבים
בטבלה הבאה מפורטים הרכיבים של PartyContest:
| רכיב | ריבוי | סוג | תיאור |
|---|---|---|---|
NumberElected |
0 או 1 | integer |
מספר המועמדים שנבחרים בתחרות, כלומר n בתחרות n-of-m. אם התכונה NumberElected
לא מופיעה בפיד, המערכת משתמשת בערך ברירת המחדל 1. |
VotesAllowed |
0 או 1 | integer |
המספר המקסימלי של קולות או שמות של מועמדים שאפשר להוסיף לרשימה שמותר לכל מצביע להצביע עבורם בתחרות הזו. אם המאפיין VotesAllowed לא מופיע בפיד, נעשה שימוש בערך ברירת המחדל 1. |
OfficeIds |
1 | IDREFS |
מזהה ייחודי של רכיב Office אחד או יותר.
משייך תיאור של המשרד לתחרות. |
Type |
0 או יותר | ElectionType |
הסוג המפורט של תחרות, כמו ראשונית או כללית. צריך להגדיר את סוג Contest רק אם הוא שונה מהסוג של Election. |
דוגמאות
XML
<Contest xsi:type="PartyContest" objectId="c-20001"> <BallotSelection objectId="ps-101321" xsi:type="PartySelection"> <PartyIds>par-10132</PartyIds> </BallotSelection> <BallotSelection objectId="ps-101322" xsi:type="PartySelection"> <PartyIds>par-10133</PartyIds> </BallotSelection> <BallotTitle> <Text language="en">Ballot title example</Text> </BallotTitle> <ContestDateStatus>confirmed</ContestDateStatus> <CountingDate>2022-08-11</CountingDate> <ElectoralDistrictId>...</ElectoralDistrictId> <EndDate>2022-08-09</EndDate> <ExternalIdentifiers>...</ExternalIdentifiers> <Name>Contest name example</Name> <StartDate>2022-08-09</StartDate> <VoteVariation>1-of-m</VoteVariation> <OfficeIds>off-9999a</OfficeIds> <Type>general</Type> <VotesAllowed>1</VotesAllowed> </Contest>
BallotMeasureContest
אפשר להשתמש ב-BallotMeasureContest בתחרות שכוללת הצעות חוק למשאל עם.
רכיבים
בטבלה הבאה מפורטים הרכיבים של BallotMeasureContest:
| רכיב | ריבוי | סוג | תיאור |
|---|---|---|---|
BallotTitle |
1 | InternationalizedText |
השם הרשמי של כרטיס ההצבעה, כמו בחלק מהמשאלים יש שם קולקטיבי אחד עם כמה שאלות ממוספרות. במקרים כאלה, אפשר לכלול בשם את מספר השאלה
כדי להבדיל בין |
BallotSubTitle |
0 או 1 | InternationalizedText |
כותרת המשנה של כרטיס ההצבעה, אם יש כזו. |
BallotText |
1 | InternationalizedText |
הטקסט שמופיע בפתק ההצבעה עצמו. לדוגמה: Shall
Article 4 of the Nevada Constitution be amended to require, beginning in
calendar year 2022, that all providers of electric utility services who
sell electricity... in Nevada comes from renewable energy
resources? |
FullText |
0 או 1 | InternationalizedText |
עותק של הטקסט המלא של הצעת החוק. צריך לספק את הרכיב הזה אם יש טקסט נוסף שלא נכלל בפתק ההצבעה עצמו. מוגבל ל-30,000 תווים. אם הטקסט המלא של הצעת החוק קצר מ-30,000 תווים ולא כולל עיצוב שלא תקין בקובץ פיד, צריך לכלול אותו במאפיין |
InfoUri |
0 או 1 | AnnotatedUri |
URI עם הערות שמקבל את ההערות הבאות, ולא את ההערות שמפורטות במקום אחר:
|
SummaryText |
0 או 1 | InternationalizedText |
סיכום של הצעת החוק. הוא כולל פסקה אחת או שתיים קצרות, והשותף יכול ליצור אותו כדי לסכם את הטקסט המלא של כרטיס ההצבעה, כמו בדוגמה הבאה:
|
ProStatement |
0 או 1 | InternationalizedText |
הצהרה שמסבירה מה המשמעות של הצבעה בעד בהצעה הזו. זה לא טיעון בעד המדידה. לדוגמה: A "yes" vote supports this initiative to require electric
utilities to acquire 50 percent of their electricity from renewable
resources by 2030. |
ConStatement |
0 או 1 | InternationalizedText |
הסבר על המשמעות של הצבעה נגד בהצעת החוק הזו. זה לא טיעון נגד המדידה. לדוגמה: A
"no" vote opposes this initiative, thus keeping the existing requirement
that electric utilities acquire 25 percent of their electricity from
renewable resources by 2025. |
Type |
0 או 1 | BallotMeasureType |
סוג ממוספר של הצעת חוק. בוחרים את הערך שמתאר בצורה הכי טובה את הצעת החוק להצבעה בתחום השיפוט שלה. |
PassageThreshold |
0 או 1 | string |
חלק המינימלי של הקולות שנדרש כדי שהצעה תאושר. |
דוגמאות
XML
<Contest objectId="c-0" xsi:type="BallotMeasureContest"> <BallotSelection objectId="bms-00" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bms-00-yes</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection> <Text language="en">Yes</Text> </Selection> </BallotSelection> <BallotSelection objectId="bms-01" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bms-01-no</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection> <Text language="en">No</Text> </Selection> </BallotSelection> <BallotSubTitle> <Text language="en">Farm Animal Confinement Initiative</Text> </BallotSubTitle> <BallotTitle> <Text language="en"> California Proposition 12, Farm Animal Confinement Initiative (2018) </Text> </BallotTitle> <ElectoralDistrictId>ru-ca-1</ElectoralDistrictId> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>c-0</Value> </ExternalIdentifier> </ExternalIdentifiers> <Name> California Proposition 12, Farm Animal Confinement Initiative (2018) </Name> <BallotText> <Text language="en"> Establishes minimum requirements for confining certain farm animals. Prohibits sales of meat and egg products from animals confined in noncomplying manner. Fiscal Impact: Potential decrease in state income tax revenues from farm businesses, likely not more than several million dollars annually. State costs up to $10 million annually to enforce the measure. </Text> </BallotText> <ConStatement> <Text language="en">No means the measure will not be enacted </Text> </ConStatement> <InfoUri Annotation="fulltext"> https://example-government.gov/ballot-measures/California_Proposition_12_2018 </InfoUri> <InfoUri Annotation="wikipedia"> https://en.wikipedia.org/wiki/2018_California_Proposition_12 </InfoUri> <PassageThreshold> <Text language="en">50.01%</Text> </PassageThreshold> <ProStatement> <Text language="en">Yes means the measure will be enacted </Text> </ProStatement> <SummaryText> <Text language="en"> The proposition establishes new minimum requirements on farmers to provide more space for egg-laying hens, breeding pigs, and calves raised for veal. California businesses will be banned from selling eggs or uncooked pork or veal that came from animals housed in ways that did not meet these requirements. </Text> </SummaryText> <Type>ballot-measure</Type> </Contest>
RetentionContest
משתמשים בסוג הזה כשContest כולל משאל עם כדי להחליט אם פקיד נבחר צריך להישאר בתפקיד או להיות מודח ממנו.
האיסור חל גם על מקרים כמו בחירות להמשך כהונה של שופטים במדינות מסוימות בארה"ב, שבהן מחליטים אם שופט מסוים ימשיך לכהונה נוספת. הכללים האלה חלים גם על בחירות להדחה, שבהן מחליטים אם להדיח בעל תפקיד לפני שתקופת הכהונה שלו מסתיימת.
רכיבים
כל האלמנטים מ-BallotMeasureContest חלים גם על RetentionContest.
| רכיב | ריבוי | סוג | תיאור |
|---|---|---|---|
CandidateId |
1 | IDREF | המזהה של המועמד שמייצג את נבחר הציבור שמכהן כרגע בתפקיד |
OfficeId |
0 או 1 | IDREF | המזהה של התפקיד שבעל התפקיד מכהן בו כרגע |
דוגמאות
XML
<Contest objectId="c-40001" xsi:type="RetentionContest"> <!-- Retention contest selections are actually BallotMeasureSelection objects, and should use the 'bms-' objectId prefix.--> <BallotSelection objectId="bms-40001a" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bms-40001a</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection label="bms-40001at"> <Text language="en">Yes</Text> </Selection> </BallotSelection> <BallotSelection objectId="bms-40001b" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bms-40001b</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection label="bms-40001bt"> <Text language="en">No</Text> </Selection> </BallotSelection> <BallotTitle> <Text language="en">Retention of Supreme Court Justice</Text> </BallotTitle> <ElectoralDistrictId>ru-0002</ElectoralDistrictId> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>c-vageneral-2013-va16-country-us</Value> </ExternalIdentifier> </ExternalIdentifiers> <Name>Judicial Retention, Supreme Court</Name> <CandidateId>can-12345</CandidateId> <OfficeId>off-20006</OfficeId> </Contest>