Gunakan Contest untuk mendeskripsikan kontes dan menautkan kontes ke kandidat dan partai terkait.
Dokumen ini membahas Contest dan sub-entitasnya:
ContestCandidateContestPartyContestBallotMeasureContestRetentionContest
Jenis
Contest adalah elemen abstrak dengan tiga jenis yang digunakan berdasarkan
jenis kontes:
CandidateContest: Gunakan jenis ini jikaContestmelibatkan satu atau beberapa kandidat untuk suatu jabatan.PartyContest: Gunakan jenis ini jikaContestmemiliki pilihan daftar partai pada surat suara. Hal ini juga dapat digunakan sebagai kontes virtual yang merupakan ringkasan dari kumpulan kontes yang lebih besar dan lebih kecil.BallotMeasureContest: Gunakan jenis ini jikaContestmelibatkan satu atau beberapa pemungutan suara.RetentionContest: Gunakan jenis ini jikaContestmelibatkan referendum untuk memutuskan apakah pejabat terpilih harus tetap menjabat atau diberhentikan dari jabatannya.
Saat hasil pemilu dilaporkan, Anda dapat memperbarui feed untuk menampilkan
berbagai tahap hasil, seperti exit poll atau estimasi. Google
memberikan panduan tentang tahap pemilu dan jenis hasil yang kami harapkan. Google
dapat meminta satu atau beberapa tahap. Nilai jenis tahap ini mungkin berubah selama
malam pemilu. Tetapkan nilai feed awal ke tahap yang akan dimulai. Untuk mengetahui detail selengkapnya, lihat CurrentResultsReportingStage dan ResultsReportingStageCollection di bagian Elemen.
Atribut
Tabel berikut menjelaskan atribut untuk Contest:
| Atribut | Wajib? | Jenis | Deskripsi |
|---|---|---|---|
objectId |
Wajib | ID |
ID internal unik yang digunakan oleh elemen lain untuk mereferensikan elemen ini. |
Elemen
Tabel berikut menjelaskan elemen untuk Contest:
| Elemen | Keanekaragaman | Jenis | Deskripsi |
|---|---|---|---|
Abbreviation |
0 atau 1 | string |
Nama pendek untuk kontes. |
AggregateBallotSelection |
0 atau 1 | SpecialBallotSelection |
Pemilihan surat suara untuk agregasi penghitungan suara, seperti menggabungkan beberapa kandidat ke dalam "Lainnya". |
BallotSelection |
0 atau lebih | BallotSelection |
Mengaitkan pilihan pada surat suara dengan kontes. Urutan
kandidat atau partai di Jika |
BallotSubTitle |
0 atau 1 | InternationalizedText |
Subjudul kontes, yang harus sama dengan yang muncul di surat suara pemilih. |
BallotTitle |
0 atau 1 | InternationalizedText |
Judul kontes. Teks judul harus sesuai dengan panduan sintaksis. Untuk kontes Ballot Measure, judulnya harus sesuai dengan kata-kata pada surat suara. |
BlankBallotSelection |
0 atau 1 | SpecialBallotSelection |
Pemilihan surat suara untuk surat suara kosong. |
ComposingContestIds |
0 atau lebih | IDREFS |
Digunakan untuk menentukan kontes rollup. Misalnya, dalam pemilihan umum presiden AS, ada kontes tingkat nasional dengan ID kontes penyusun untuk setiap pemilihan tingkat negara bagian.
|
ContestDateStatus |
0 atau 1 |
DateStatus
|
Elemen ini menunjukkan pembaruan penjadwalan untuk pemilu. Nilai defaultnya adalah |
ContestDateType |
0 atau 1 |
ElectionDateType
|
Elemen ini menunjukkan cara kontes ditambahkan ke kalender.
Jika dihilangkan, nilai defaultnya adalah |
CountingDate |
0 atau 1 | PartialDate |
Tanggal pasca-pemungutan suara saat penghitungan suara dilakukan untuk kontes pemilu.
Ini hanya boleh disertakan jika hari penghitungan berbeda dengan
hari terakhir pemungutan suara, misalnya pemilu Lok Sabha India. Kasus yang umum
adalah penghitungan terjadi pada hari yang sama dengan hari terakhir pemungutan suara,
yaitu EndDate pemilu.
|
CurrentResultsReportingStage |
1 | ResultsReportingStageType |
Tahap pelaporan hasil saat ini untuk kontes. |
EarliestPollsClose |
0 atau 1 | dateTime |
Saat pemungutan suara pertama ditutup. |
ElectoralDistrictId |
1 | IDREF |
ID unik untuk elemen
Misalnya, untuk kontes tertentu, |
ExternalIdentifiers |
1 | ExternalIdentifiers |
Mengaitkan ID dengan kontes. ID stabil diperlukan. |
EndDate |
0 atau 1 | PartialDate |
Tanggal akhir kalender kontes. Gunakan tanggal saat pemungutan suara
berakhir, seperti 2022-11-08. Tanggal akhir hanya boleh ditetapkan jika tanggal mulai
dan akhir Contest berbeda dengan tanggal mulai dan akhir
Election.
|
EstimatedExpectedVotePercentage |
0 atau 1 | float |
Sering disingkat sebagai EEVP, ini adalah perkiraan persentase total suara yang diharapkan yang telah dilaporkan untuk kontes ini, sebagai angka antara 0 dan 100. Misalnya, laporkan 24,2% sebagai |
FilingDeadline |
0 atau 1 | PartialDate |
Tanggal batas waktu pendaftaran kandidat untuk kontes. |
HasRotation |
0 atau 1 | boolean |
Menunjukkan apakah pilihan dalam kontes dirotasi. Jika elemen ini tidak ada, nilai defaultnya adalah false. |
IsNotable |
0 atau 1 | boolean |
Apakah entitas dianggap penting. Diasumsikan false
jika tidak ditentukan.
|
LatestPollsClose |
0 atau 1 | dateTime |
Saat pemungutan suara terakhir ditutup. |
Name |
1 | string |
Judul ini harus cocok dengan BallotTitle dalam bahasa Inggris dan sesuai
dengan sintaksis judul. |
NoneOfTheAboveBallotSelection |
0 atau 1 | SpecialBallotSelection |
Pilihan surat suara untuk opsi pada surat suara untuk memilih "Tidak satu pun di atas" atau beberapa pilihan yang setara, seperti "Tidak ada", "Tidak satu pun dari ini", atau "Tidak berkomitmen". |
NullBallotSelection |
0 atau 1 | SpecialBallotSelection |
Pemilihan surat suara untuk surat suara yang tidak sah atau rusak. Ini adalah surat suara yang telah ditandai sedemikian rupa sehingga suara tidak dapat dihitung dengan benar. Contoh surat suara tidak sah adalah surat suara yang telah dirobek, kotor, ditandai berlebihan atau kurang, atau ditandai dengan cara yang akan mengidentifikasi pemilih. |
OutcomeDetermined |
0 atau 1 | boolean |
Apakah hasil pemilu telah ditentukan.
|
Seat |
0 atau 1 | string |
Kursi tertentu yang diperebutkan dalam kontes. |
SequenceOrder |
0 atau 1 | integer |
Urutan default elemen
|
StartDate |
0 atau 1 | PartialDate |
Tanggal mulai kalender kontes. Gunakan tanggal saat polling
dimulai, seperti 2022-11-08. Tanggal mulai hanya boleh ditetapkan jika
tanggal mulai dan akhir Contest berbeda dengan tanggal mulai dan
akhir Election.
|
SubsequentContestId |
0 atau 1 | IDREF |
Digunakan untuk mengarahkan ke kontes berikutnya dalam kumpulan terkait yang sama. Misalnya, dalam pemilu Amerika Serikat, properti ini biasanya mengarah dari pemilu primer ke pemilu umum terkait. Pemilu juga dapat mengarah dari pemilu umum ke pemilu putaran kedua.
|
SubUnitsReported |
0 atau 1 | integer |
Jumlah subunit, seperti daerah pemilihan yang telah menyelesaikan pelaporan suara untuk kontes ini. |
SummaryCounts |
0 atau lebih | SummaryCounts |
Memberikan ringkasan berbagai jumlah yang terkait dengan kontes. Hal ini mencakup jumlah total surat suara yang diberikan yang berisi
kontes, dan jumlah total abstain, suara berlebih, suara kurang, atau
suara tulis. Jumlah ringkasan dapat dikaitkan dengan kontes secara keseluruhan atau dengan unit pelaporan tingkat bawah lainnya melalui penggunaan beberapa kemunculan SummaryCounts. |
TotalSeats |
0 atau 1 | integer |
Jumlah total kursi yang dapat diisi oleh distrik pemilihan untuk kontes ini di kantor. Jumlah ini setara dengan kursi yang diperebutkan dalam pemilu + kursi yang dipertahankan + kursi kosong. |
TotalSubUnits |
0 atau 1 | integer |
Total jumlah subunit, seperti daerah pemilihan yang memiliki kontes ini dalam surat suara. |
VoteVariation |
0 atau 1 | VoteVariation |
Jenis variasi suara yang terkait dengan kontes, seperti
n-of-m. |
OtherVoteVariation |
0 atau 1 | string |
Digunakan untuk memberikan nilai kustom saat VoteVariation adalah
other. |
ResultsEmbargoEnd |
0 atau 1 | dateTime |
Saat embargo publikasi hasil pemilu berakhir. |
ResultsExpected |
0 atau 1 | dateTime |
Kapan hasil penghitungan suara pertama diperkirakan akan muncul di feed. |
ResultsLastUpdated |
0 atau 1 | dateTime |
Waktu saat hasil kontes terakhir diperbarui. |
ResultsReportingStageCollection |
0 atau 1 | T/A | Elemen wrapper untuk definisi
ResultsReportingStage. Untuk mengetahui detail selengkapnya, baca
Entity koleksi.
|
CandidateContest
Gunakan CandidateContest untuk mendeskripsikan kontes yang melibatkan pemilihan satu
atau beberapa kandidat.
Entity ini dapat secara opsional merujuk ke Office
atau Party berdasarkan ID. Kami tidak mendukung
representasi tiket kandidat ke dalam kontes yang sama; Anda hanya dapat
mereferensikan satu Office. Jadi, sebagai contoh, untuk
tiket Presiden dan Wakil Presiden, Anda memerlukan dua
kontes Candidate. Masing-masing
akan merujuk ke kantor yang berbeda.
Elemen
Tabel berikut menjelaskan elemen untuk CandidateContest:
| Elemen | Keanekaragaman | Jenis | Deskripsi |
|---|---|---|---|
NumberElected |
0 atau 1 | integer |
Jumlah kandidat yang terpilih dalam kontes, yang merupakan
n dari kontes n-of-m. Jika
NumberElected tidak ada dalam feed, nilai default
1 akan digunakan. |
OfficeIds |
1 | IDREFS |
ID unik untuk satu atau beberapa elemen
Office. Mengaitkan deskripsi jabatan dengan kontes. |
PrimaryPartyIds |
0 atau lebih | IDREFS |
ID unik untuk satu atau beberapa elemen
Party,
yang menunjukkan bahwa Contest adalah bagian dari
pemilihan pendahuluan partisan. PrimaryPartyId hanya bermakna dalam
pemilu awal (primary). |
VotesAllowed |
1 | integer |
Jumlah maksimum suara atau saran yang diizinkan per pemilih dalam kontes ini. Jika VotesAllowed tidak ada dalam feed, nilai default 1 akan digunakan. |
Type |
0 atau lebih | ElectionType |
Jenis kontes yang dihitung, seperti pemilihan pendahuluan atau pemilihan umum. Jenis
Contest hanya boleh ditetapkan jika berbeda dengan jenis
Election. |
Contoh
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
Gunakan PartyContest untuk kontes yang pemilihnya memilih partai di surat suara.
Hal ini juga dapat digunakan dalam feed hasil pemilu sebagai kontes ringkasan virtual
untuk mengomunikasikan data gabungan (misalnya, kontes Partai tingkat Negara Bagian yang
menggabungkan hasil kontes daerah pemilihan).
Elemen
Tabel berikut menjelaskan elemen untuk PartyContest:
| Elemen | Keanekaragaman | Jenis | Deskripsi |
|---|---|---|---|
NumberElected |
0 atau 1 | integer |
Jumlah kandidat yang terpilih dalam kontes, yang merupakan
n dari kontes n-of-m. Jika NumberElected
tidak ada dalam feed, nilai default 1 akan
digunakan. |
VotesAllowed |
0 atau 1 | integer |
Jumlah maksimum suara atau saran yang diizinkan per pemilih dalam kontes ini. Jika VotesAllowed tidak ada dalam feed, nilai default 1 akan digunakan. |
OfficeIds |
1 | IDREFS |
ID unik untuk satu atau beberapa elemen Office.
Mengaitkan deskripsi jabatan dengan kontes. |
Type |
0 atau lebih | ElectionType |
Jenis kontes yang dihitung, seperti pemilihan pendahuluan atau pemilihan umum. Jenis
Contest hanya boleh ditetapkan jika berbeda dengan jenis
Election. |
Contoh
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
Gunakan BallotMeasureContest untuk kontes yang melibatkan pemungutan suara.
Elemen
Tabel berikut menjelaskan elemen untuk BallotMeasureContest:
| Elemen | Keanekaragaman | Jenis | Deskripsi |
|---|---|---|---|
BallotTitle |
1 | InternationalizedText |
Judul resmi surat suara, seperti Beberapa referendum memiliki satu judul kolektif dengan beberapa
pertanyaan bernomor. Dalam kasus ini, judul dapat menyertakan nomor pertanyaan untuk membedakan antara entitas |
BallotSubTitle |
0 atau 1 | InternationalizedText |
Subjudul surat suara, jika ada. |
BallotText |
1 | InternationalizedText |
Teks yang muncul di surat suara itu sendiri. Contoh: 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 atau 1 | InternationalizedText |
Salinan teks lengkap dari pemungutan suara. Berikan elemen ini jika ada teks tambahan yang tidak disertakan dalam surat suara itu sendiri. Dibatasi hingga 30.000 karakter. Jika teks lengkap ukuran surat suara lebih pendek dari 30.000
karakter dan tidak menyertakan format apa pun yang tidak valid dalam file feed, sertakan dalam |
InfoUri |
0 atau 1 | AnnotatedUri |
URI yang dianotasi yang menerima anotasi berikut, bukan anotasi yang tercantum di tempat lain:
|
SummaryText |
0 atau 1 | InternationalizedText |
Ringkasan inisiatif dan referendum. Terdiri dari satu hingga dua paragraf singkat dan dapat dibuat oleh partner untuk meringkas teks lengkap surat suara, seperti contoh berikut:
|
ProStatement |
0 atau 1 | InternationalizedText |
Pernyataan yang menjelaskan arti suara Ya dalam pemungutan suara ini. Hal ini bukan argumen yang mendukung tindakan tersebut. Contoh: A "yes" vote supports this initiative to require electric
utilities to acquire 50 percent of their electricity from renewable
resources by 2030. |
ConStatement |
0 atau 1 | InternationalizedText |
Pernyataan yang menjelaskan arti suara Tidak dalam referendum ini. Hal ini bukan argumen yang menentang tindakan tersebut. Misalnya: 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 atau 1 | BallotMeasureType |
Jenis enumerasi dari pemungutan suara. Pilih nilai yang paling sesuai dengan ukuran surat suara di wilayah hukumnya. |
PassageThreshold |
0 atau 1 | string |
Jumlah suara minimum yang diperlukan agar mosi disetujui. |
Contoh
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
Gunakan jenis ini jika Contest melibatkan referendum untuk memutuskan apakah pejabat terpilih
harus tetap menjabat atau diberhentikan dari jabatannya.
Hal ini mencakup kasus seperti kontes retensi yudisial di beberapa negara bagian AS yang memutuskan apakah seorang hakim harus melanjutkan masa jabatan berikutnya. Hal ini juga berlaku untuk pemilu recall yang memutuskan apakah seorang pejabat harus diberhentikan sebelum masa jabatannya berakhir.
Elemen
Semua elemen dari BallotMeasureContest juga berlaku
untuk RetentionContest.
| Elemen | Keanekaragaman | Jenis | Deskripsi |
|---|---|---|---|
CandidateId |
1 | IDREF | ID kandidat yang mewakili pejabat yang saat ini menjabat |
OfficeId |
0 atau 1 | IDREF | ID jabatan yang saat ini dipegang oleh pejabat |
Contoh
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>