משתמשים ב-Contest כדי לתאר תחרות ולקשר אותה למועמדים ולמפלגות שמשתתפים בה.
במסמך הזה נדון ב-Contest ובישויות המשנה שלו:
ContestCandidateContestPartyContestBallotMeasureContestRetentionContest
סוגים
Contest הוא רכיב מופשט עם שלושה סוגים שנעשה בהם שימוש בהתאם לסוג התחרות:
-
CandidateContest: משתמשים בסוג הזה כש-Contestכולל מועמד אחד או יותר לתפקיד. PartyContest: משתמשים בסוג הזה כשב-Contestיש בחירה של רשימת מפלגות בקלפי. אפשר להשתמש בזה גם כתחרות וירטואלית שהיא סיכום של קבוצה גדולה יותר של תחרויות קטנות יותר.-
BallotMeasureContest: משתמשים בסוג הזה כש-Contestכולל הצעה אחת או יותר להצבעה. -
RetentionContest: השתמשו בסוג הזה כש-Contestכולל משאל עם כדי להחליט אם נבחר ציבור צריך להישאר בתפקיד או להיות מודח ממנו.
כשהתוצאות של הבחירות מתפרסמות, אתם יכולים לעדכן את הפיד כדי להציג שלבים שונים של התוצאות, כמו מדגמי בחירות או הערכות. Google מספקת הנחיות לגבי שלבי הבחירות וסוגי התוצאות שאנחנו מצפים להם. Google יכולה לבקש שלב אחד או כמה שלבים. הערכים של סוגי השלבים האלה עשויים להשתנות במהלך ליל הבחירות. מגדירים את ערך הפיד הראשוני לשלב שבו רוצים להתחיל. לפרטים נוספים, ראו CurrentResultsReportingStage ו-ResultsReportingStageCollection בקטע רכיבים.
מאפיינים
בטבלה הבאה מתוארים המאפיינים של 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
|
הרכיב הזה מציין עדכונים בלוח הזמנים של הבחירות. ערך ברירת המחדל הוא |
ContestDateType |
0 או 1 |
ElectionDateType
|
הרכיב הזה מציין את האופן שבו התחרות נוספת ליומן.
אם משמיטים את המאפיין, ערך ברירת המחדל הוא ה- |
CountingDate |
0 או 1 | PartialDate |
התאריך שאחרי ההצבעה, שבו מתבצעת ספירת הקולות בבחירות.
צריך לכלול את המאפיין הזה רק אם יום ספירת הקולות שונה מהיום האחרון של ההצבעה, למשל בבחירות ללוק סבהה בהודו. בדרך כלל, הספירה מתבצעת באותו יום שבו מסתיימת ההצבעה, כלומר בEndDate של הבחירות.
|
CurrentResultsReportingStage |
1 | ResultsReportingStageType |
השלב הנוכחי של דיווח התוצאות בתחרות. |
EarliestPollsClose |
0 או 1 | dateTime |
כשהקלפיות הראשונות נסגרות. |
ElectoralDistrictId |
1 | IDREF |
מזהה ייחודי של רכיב לדוגמה, בתחרות ספציפית, |
ExternalIdentifiers |
1 | ExternalIdentifiers |
משייך מזהה לתחרות. צריך להשתמש במזהה יציב. |
EndDate |
0 או 1 | PartialDate |
תאריך הסיום של התחרות. צריך להשתמש בתאריך שבו ההצבעה מסתיימת, למשל 2022-11-08. צריך להגדיר את תאריך הסיום רק אם תאריכי ההתחלה והסיום של Contest שונים מתאריכי ההתחלה והסיום של Election.
|
EstimatedExpectedVotePercentage |
0 או 1 | float |
האחוז המשוער של סך הקולות הצפויים שדווחו בתחרות הזו, כמספר בין 0 ל-100. לדוגמה, צריך לדווח על 24.2% בתור |
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 |
בחירת פתק הצבעה לפתקי הצבעה ריקים או פסולים. אלה פתקי הצבעה שסומנו באופן שלא מאפשר לספור את הקול בצורה תקינה. דוגמאות לפתקי הצבעה פסולים: פתקים קרועים, מלוכלכים, מסומנים יותר מדי או פחות מדי, או מסומנים באופן שמאפשר לזהות את המצביע. |
OutcomeDetermined |
0 או 1 | boolean |
אם תוצאות הבחירות כבר נקבעו.
|
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 |
מתי צפויות להופיע בפיד התוצאות הראשונות של ספירת הקולות. |
ResultsLastUpdated |
0 או 1 | dateTime |
מתי התוצאות של התחרות עודכנו בפעם האחרונה. |
ResultsReportingStageCollection |
0 או 1 | לא רלוונטי |
רכיב wrapper להגדרות של
בתחרות מורכבת (שמקושרת לתחרות ראשית באמצעות
|
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>