שימוש ב-Contest
כדי לתאר תחרות ולקשר את התחרות למועמדים ולצדדים הרלוונטיים.
המסמך הזה עוסק ב-Contest
ובישויות המשנה שלו:
Contest
CandidateContest
PartyContest
BallotMeasureContest
תחרות
Contest
הוא אלמנט מופשט עם שלושה סוגים שנעשה בהם שימוש בהתאם לסוג התחרות:
CandidateContest
: כדאי להשתמש בסוג הזה כאשרContest
עוסק במועמד אחד או יותר למשרד.PartyContest
: שימוש בסוג הזה כאשר ל-Contest
יש רשימה של רשימת המפלגה בפתק ההצבעה.BallotMeasureContest
: יש להשתמש בסוג הזה כאשרContest
כולל פתק הצבעה אחד או יותר.
כשמדווחות תוצאות הבחירות, אפשר לעדכן את הפיד כך שיוצגו שלבים שונים של התוצאות, כמו סקרים בעקבות יציאה או אומדנים. Google
מספקת הנחיות לגבי שלבי הבחירות וסוגי התוצאות הצפויים. Google יכולה לבקש שלב אחד או כמה שלבים. הערכים של סוג השלב עשויים להשתנות במהלך ליל הבחירות. מגדירים את הערך הראשוני של הפיד לשלב שבו יתחיל. לפרטים נוספים, קראו את המאמר ExternalIdentifiers
בקטע Elements.
מאפיינים
בטבלה הבאה מפורטים המאפיינים של Contest
:
מאפיין | חובה? | סוג | תיאור |
---|---|---|---|
objectId |
חובה | ID |
מזהה פנימי ייחודי המשמש רכיבים אחרים להפניה לאלמנט הזה. |
Elements
בטבלה הבאה מתוארים הרכיבים של Contest
:
רכיב | ריבוי | סוג | תיאור |
---|---|---|---|
Abbreviation |
0 או 1 | string |
שם קצר של התחרות. |
BallotSelection |
0 או יותר | BallotSelection |
משייך את המתמודדים שנבחרו לפתק ההצבעה לתחרות. סדר
המועמדים או המפלגות ב- אם |
BallotSubTitle |
0 או 1 | InternationalizedText |
השם המשני של התחרות, אשר חייב להתאים לאופן שבו הוא מופיע בפתקי ההצבעה. |
BallotTitle |
0 או 1 | InternationalizedText |
שם התחרות, שחייב להתאים לאופן שבו הוא מופיע בפתקי ההצבעה. |
BallotTitle |
0 או 1 | InternationalizedText |
שם התחרות, שחייב להתאים לאופן שבו הוא מופיע בפתקי ההצבעה. |
ComposingContestIds |
0 או יותר | IDREFS |
הגדרה של תחרות אוסף ערוצים. לדוגמה, בבחירות הכלליות לנשיאות ארה"ב מתקיימת תחרות ברמה הארצית, שבה מורכב פרטי מזהה של תחרויות לכל אחת מהבחירות ברמת המדינה.
|
ContestDateStatus |
0 או 1 |
DateStatus
|
הרכיב הזה מציין לוחות זמנים של בחירות. ערך ברירת המחדל הוא |
ElectoralDistrictId |
1 | IDREF |
מזהה ייחודי של רכיב לדוגמה, עבור תחרות ספציפית, |
ExternalIdentifiers |
1 | ExternalIdentifiers |
משייך מזהה לתחרות. צריך
מזהה יציב. כדי לספק את השלב של תוצאות הבחירות שמדווחות בפיד שלך, צריך להגדיר את OtherType עם ערך
ContestStage . |
HasRotation |
0 או 1 | boolean |
מציין אם הבחירות בתחרות יוצגו בסבב. אם
הרכיב הזה לא קיים, ערך ברירת המחדל הוא false . |
Name |
1 | string |
שם התחרות כפי שהוא מופיע בדוח התוצאות, לא בהכרח כפי שהוא מופיע בפתק ההצבעה. |
SequenceOrder |
0 או 1 | integer |
סדר ברירת המחדל של רכיבי
|
SubsequentContestId |
0 או 1 | IDREF |
משמש להצבעה על תחרות מאוחרת יותר באותה קבוצה קשורה. למשל, בבחירות בארה"ב, לרוב, הבחירות המקדימות למפלגה מובילות לבחירות הכלליות בארה"ב. הוא יכול גם להצביע על מערכת בחירות כללית או על סיבוב גורף. ל- |
SubUnitsReported |
0 או 1 | integer |
מספר יחידות המשנה, כגון מחוזות בחירה שהשלימו את הדיווחים על הצבעות לתחרות הזו. |
SummaryCounts |
0 או יותר | SummaryCounts |
סיכום של הספירות השונות שמשויכות
לתחרות. הנתונים האלה כוללים את המספר הכולל של פתקי ההצבעה שמכילים את
התחרות ואת המספר הכולל של הימנעות, הצבעות יתר, הצבעות חסרות או
תשובות. אפשר לשייך את ספירות הסיכום לתחרות כולה או ליחידות דיווח אחרות ברמה נמוכה יותר, על ידי שימוש במספר מופעים של SummaryCounts . |
TotalSubUnits |
0 או 1 | integer |
המספר הכולל של יחידות המשנה, כגון מחוזות שבהם יש את התחרות הזו בפתק ההצבעה. |
VoteVariation |
0 או 1 | VoteVariation |
סוג הווריאציה של ההצבעה המשויכת לתחרות, למשל
n-of-m . |
OtherVoteVariation |
0 או 1 | string |
משמש כדי לספק ערך מותאם אישית כאשר VoteVariation הוא
other . |
StartDate |
0 או 1 | PartialDate |
תאריך ההתחלה הקלנדרי של התחרות. יש להשתמש בתאריך של תחילת הקלפי, למשל 8.11.2022. יש להגדיר את תאריך ההתחלה רק אם תאריך ההתחלה ותאריך הסיום של Contest שונים מתאריך ההתחלה ותאריך הסיום של Election .
|
EndDate |
0 או 1 | PartialDate |
תאריך הסיום הקלנדרי של התחרות. יש להשתמש בתאריך של סיום הקלפי, למשל 8.11.2022. יש להגדיר תאריך סיום רק אם תאריך ההתחלה ותאריך הסיום של Contest שונים מתאריך ההתחלה ותאריך הסיום של Election .
|
CountingDate |
0 או 1 | PartialDate |
התאריך שלאחר ההצבעה, כאשר הספירה מתקיימת במערכת הבחירות. צריך לכלול את המידע הזה רק אם יום הספירה שונה מיום ההצבעה האחרון, לדוגמה, הבחירות לפרלמנט ההודי (Lok Sabha) בהודו. במקרה הנפוץ, הספירה מתרחשת באותו יום כמו יום ההצבעה האחרון, כלומר EndDate של הבחירות.
|
CandidateContest
ניתן להשתמש ב-CandidateContest
כדי לתאר תחרות שכרוכה בבחירה של מועמד אחד או יותר.
הישות הזו יכולה להפנות ל-Office
או ל-Party
לפי מזהה. אנחנו לא תומכים בייצוג כרטיס של מועמדים שמשתתפים באותה תחרות – אפשר להפנות רק לאחד מהם Office
. כך, לדוגמה, כדי לקבל כרטיס לנשיאות ולסמנכ"ל, נדרשות שתי תחרויות Candidate
. כל אחד מהם יפנה למשרד אחר.
Elements
בטבלה הבאה מתוארים הרכיבים של 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="cc1-001"> <Abbreviation>KENYAPRES</Abbreviation> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-kenyatta">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-odinga">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-mudavadi">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-kenneth">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-dida">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-karua">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-kiyiapi">...</BallotSelection> <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-muite">...</BallotSelection> <BallotTitle> <Text language="en">President of Kenya</Text> <Text language="es">Presidente de Kenya</Text> <Text language="fr">Président du Kenya</Text> <Text language="id">Presiden Kenya</Text> </BallotTitle> <CountStatus>...</CountStatus> <CountingDate>2022-08-11</CountingDate> <ElectoralDistrictId>...</ElectoralDistrictId> <EndDate>2022-08-09</EndDate> <Name>President of Kenya</Name> <StartDate>2022-08-09</StartDate> <SubUnitsReported>48</SubUnitsReported> <SummaryCounts>...</SummaryCounts> <TotalSubUnits>48</TotalSubUnits> <VoteVariation>1-of-m</VoteVariation> <NumberElected>1</NumberElected> <OfficeIds>off9999a</OfficeIds> <VotesAllowed>1</VotesAllowed> <Type>general</Type> </Contest>
JSON
"Contest": [ { "@type": "CandidateContest", "objectId": "cc1-001", "Abbreviation": "KENYAPRES", "BallotSelection": [ { "@type": "CandidateSelection", "objectId": "cs1-001-kenyatta", ... }, { "@type": "CandidateSelection", "objectId": "cs1-001-odinga", ... }, { "@type": "CandidateSelection", "objectId": "cs1-001-mudavadi", ... }, { "@type": "CandidateSelection", "objectId": "cs1-001-kenneth", ... }, { "@type": "CandidateSelection", "objectId": "cs1-001-dida", ... }, { "@type": "CandidateSelection", "objectId": "cs1-001-karua", ... }, { "@type": "CandidateSelection", "objectId": "cs1-001-kiyiapi", ... }, { "@type": "CandidateSelection", "objectId": "cs1-001-muite", ... } ], "BallotTitle": { "Text": [ { "value": "President and Vice-President of Kenya", "language": "en" }, { "value": "Presidente y Vice-Presidente de Kenya", "language": "es" }, { "value": "Président et vice-président du Kenya", "language": "fr" }, { "value": "Presiden dan Wakil Presiden Kenya", "language": "id" }, { "value": "राष्ट्रपति और केन्या के उपराष्ट्रपति", "language": "hi" }, { "value": "Rais na Makamu wa Rais of Kenya", "language": "sw" } ] }, "CountStatus": "...", "ElectoralDistrictId": "...", "Name": "President of Kenya", "SubUnitsReported": 48, "SummaryCounts": "...", "TotalSubUnits": 48, "VoteVariation": "1-of-m", "NumberElected": 1, "VotesAllowed": 1, "Type": "general" } ]
PartyContest
יש להשתמש בערך PartyContest
לתחרות שבה המצביעים בוחרים מפלגה בבחירות.
Elements
בטבלה הבאה מתוארים הרכיבים של 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="pc20001"> <BallotSelection objectId="ps10132" xsi:type="PartySelection"> <PartyIds>par10132 par10133</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>off9999a</OfficeIds> <Type>general</Type> <VotesAllowed>1</VotesAllowed> </Contest>
JSON
"Contest": [ { "@type": "PartyContest", "objectId": "pc20001", "BallotSelection": [ { "@type": "PartySelection", "objectId": "ps10132", "PartyIds": [ "par10132", "par10133" ] } ], "BallotTitle": { "Text": [ { "value": "Ballot title example", "language": "en" } ] }, "ContestDateStatus": "confirmed", "CountingDate": "2022-08-11", "ElectoralDistrictId": "...", "EndDate": "2022-08-09", "ExternalIdentifiers": [ ... ], "Name": "Contest name example", "StartDate": "2022-08-09", "VoteVariation": "1-of-m", "OfficeIds": "off9999a", "Type": "general", "VotesAllowed": 1 } ]
BallotMeasureContest
אפשר להשתמש בכתובת BallotMeasureContest
לתחרות שיש בה משאלי עם (ballot measures).
Elements
בטבלה הבאה מתוארים הרכיבים של 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 |
סוג ספירה של משאל חקיקה. צריך לבחור את הערך שמתאר בצורה הטובה ביותר את משאל החקיקה בסמכות השיפוט שלו. |
דוגמאות
XML
<Contest objectId="bmc0" xsi:type="BallotMeasureContest"> <BallotSelection objectId="bms00" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bmc0_yes</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection> <Text language="en">Yes</Text> </Selection> </BallotSelection> <BallotSelection objectId="bms01" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bmc0_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>bmc0</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> <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>
JSON
"Contest": [ { "@type": "BallotMeasureContest", "objectId": "bmc0", "BallotSelection": [ { "@type": "BallotMeasureSelection", "objectId": "bms00", "ExternalIdentifiers": { "ExternalIdentifier" : [ { "Type": "other", "OtherType": "stable", "Value": "bmc0_yes" } ] } } "Text": [ { "value": "Yes", "language": "en" }, ] ], "BallotSelection": [ { "@type": "BallotMeasureSelection", "objectId": "bms01", "ExternalIdentifiers": { "ExternalIdentifier" : [ { "Type": "other", "OtherType": "stable", "Value": "bmc0_no" } ] } } "Text": [ { "value": "No", "language": "en" }, ] ], "BallotSubTitle": { "Text": [ { "value": "Farm Animal Confinement Initiative", "language": "en" } ] }, "BallotTitle": { "Text": [ { "value": "California Proposition 12, Farm Animal Confinement Initiative (2018)", "language": "en" } ] }, "ElectoralDistrictId": "ru_ca_1" "ExternalIdentifiers": { "ExternalIdentifier" : [ { "Type": "other", "OtherType": "stable", "Value": "bmc0" } ] }, "Name": "California Proposition 12, Farm Animal Confinement Initiative (2018)", "BallotText": [ "Text": [ { "value": "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.", "language": "en" } ] ], "ConStatement": [ "Text": [ { "value": "No means the measure will not be enacted", "language": "en" } ] ], "InfoUri": [ { "value": "https://example-government.gov/ballot-measures/California_Proposition_12_2018", "annotation": "fulltext" } ], "InfoUri": [ { "value": "https://en.wikipedia.org/wiki/2018_California_Proposition_12", "annotation": "wikipedia" } ], "ProStatement": [ "Text": [ { "value": "Yes means the measure will be enacted", "language": "en" } ] ], "SummaryText": [ "Text": [ { "value": "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.", "language": "en" } ] ], "Type": "ballot-measure", } ]