Gunakan Contest
untuk mendeskripsikan kontes dan menautkan kontes ke kandidat dan partai terkait.
Dokumen ini membahas Contest
dan sub-entitasnya:
Contest
CandidateContest
PartyContest
BallotMeasureContest
RetentionContest
Jenis
Contest
adalah elemen abstrak dengan tiga jenis yang digunakan berdasarkan
jenis kontes:
CandidateContest
: Gunakan jenis ini saatContest
melibatkan satu atau beberapa kandidat untuk suatu jabatan.PartyContest
: Gunakan jenis ini saatContest
memiliki pilihan daftar partai dalam surat suara.BallotMeasureContest
: Gunakan jenis ini saatContest
melibatkan satu atau beberapa inisiatif pemungutan suara.RetentionContest
: Gunakan jenis ini saatContest
melibatkan referendum untuk memutuskan apakah pejabat terpilih harus tetap menjabat atau dicopot dari jabatannya.
Saat hasil pemilu dilaporkan, Anda dapat memperbarui feed untuk menampilkan berbagai tahap hasil, seperti hasil survei di tempat pemungutan suara 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 dapat berubah selama
malam pemilu. Tetapkan nilai feed awal ke tahap yang akan dimulai. Untuk mengetahui detail selengkapnya, lihat ExternalIdentifiers
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 singkat untuk kontes. |
BallotSelection |
0 atau lebih | BallotSelection |
Mengaitkan pilihan pada surat suara dengan kontes. Urutan
kandidat atau partai dalam Jika |
BallotSubTitle |
0 atau 1 | InternationalizedText |
Subjudul kontes, yang harus sesuai dengan yang muncul di surat suara pemilih. |
BallotTitle |
0 atau 1 | InternationalizedText |
Judul kontes. Teks judul harus sesuai dengan panduan sintaksis. Untuk kontes Pemungutan Suara, judul harus sesuai dengan kata-kata pada surat suara. |
ComposingContestIds |
0 atau lebih | IDREFS |
Digunakan untuk menentukan kontes penggabungan. Misalnya, dalam pemilu umum presiden AS, ada pemilihan tingkat nasional dengan ID pemilihan yang terdiri dari ID pemilihan tingkat negara bagian.
|
ContestDateStatus |
0 atau 1 |
DateStatus
|
Elemen ini menunjukkan penjadwalan pembaruan untuk pemilu. Nilai
default-nya adalah |
ElectoralDistrictId |
1 | IDREF |
ID unik untuk elemen
Misalnya, untuk kontes tertentu, |
ExternalIdentifiers |
1 | ExternalIdentifiers |
Mengaitkan ID dengan kontes.
ID stabil
wajib diisi. Untuk memberikan tahap hasil pemilu yang
dilaporkan oleh feed Anda, tetapkan OtherType dengan nilai dari
ContestStage . |
HasRotation |
0 atau 1 | boolean |
Menunjukkan apakah pilihan dalam kontes dirotasi. Jika elemen ini tidak ada, nilai defaultnya adalah false . |
Name |
1 | string |
Judul ini harus cocok dengan BallotTitle dalam bahasa Inggris dan sesuai
dengan sintaksis judul. |
SequenceOrder |
0 atau 1 | integer |
Urutan default elemen
|
SubsequentContestId |
0 atau 1 | IDREF |
Digunakan untuk mengarahkan ke kontes berikutnya dalam set terkait yang sama. Misalnya, dalam pemilu Amerika Serikat, biasanya menunjuk dari pemilu pendahuluan ke pemilu umumnya yang terkait. Hal ini juga dapat mengarah dari pemilu umum ke pemilu putaran kedua.
|
SubUnitsReported |
0 atau 1 | integer |
Jumlah sub-unit, seperti daerah pemilihan yang telah menyelesaikan pelaporan suara untuk kontes ini. |
SummaryCounts |
0 atau lebih | SummaryCounts |
Memberikan ringkasan jumlah lain-lain yang terkait dengan
kontes. Hal ini mencakup jumlah total surat suara yang berisi
kontes, dan jumlah total abstain, suara berlebih, suara kurang, atau
suara tertulis. Jumlah ringkasan dapat dikaitkan dengan kontes secara
keseluruhan atau dengan unit pelaporan tingkat bawah lainnya melalui penggunaan beberapa
kemunculan SummaryCounts . |
TotalSubUnits |
0 atau 1 | integer |
Jumlah total sub-unit, seperti daerah pemilihan yang memiliki pemilihan 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 . |
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 .
|
EndDate |
0 atau 1 | PartialDate |
Tanggal akhir kalender kontes. Gunakan tanggal saat polling berakhir, seperti 2022-11-08. Tanggal akhir hanya boleh ditetapkan jika tanggal mulai dan akhir Contest berbeda dengan tanggal mulai dan akhir Election .
|
CountingDate |
0 atau 1 | PartialDate |
Tanggal setelah pemungutan suara saat penghitungan suara dilakukan untuk pemilihan. Ini hanya boleh disertakan jika hari penghitungan berbeda dengan hari terakhir pemungutan suara, misalnya pemilu Lok Sabha India. Kasus umumnya adalah penghitungan dilakukan pada hari yang sama dengan hari terakhir pemungutan suara, yaitu EndDate pemilu.
|
CandidateContest
Gunakan CandidateContest
untuk mendeskripsikan kontes yang melibatkan pemilihan satu
atau beberapa kandidat.
Entitas ini dapat secara opsional mereferensikan Office
atau Party
menurut ID. Kami tidak mendukung
representasi tiket kandidat dalam kontes yang sama; Anda hanya dapat
mereferensikan satu Office
. Jadi, sebagai contoh, untuk
tiket Presiden dan Wakil Presiden, Anda memerlukan dua
kontes Candidate
. Setiap kantor
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, yaitu
n 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 kantor 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
pemilihan pendahuluan. |
VotesAllowed |
1 | integer |
Jumlah maksimum suara atau tulisan yang diizinkan per pemilih dalam
kontes ini. Jika VotesAllowed tidak ada di feed, nilai default 1 akan digunakan. |
Type |
0 atau lebih | ElectionType |
Jenis pemilihan yang dihitung, seperti utama atau umum. Jenis
Contest hanya boleh ditetapkan jika berbeda dengan jenis
Election . |
Contoh
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">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>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": "2022 Kenya Presidential election", "language": "en" }, { "value": "2022 Elecciones presidenciales de Kenia", "language": "es" }, { "value": "2022 Élection présidentielle au Kenya", "language": "fr" }, ] }, "CountStatus": "...", "ElectoralDistrictId": "...", "Name": "2022 Kenya Presidential election", "SubUnitsReported": 48, "SummaryCounts": "...", "TotalSubUnits": 48, "VoteVariation": "1-of-m", "NumberElected": 1, "VotesAllowed": 1, "Type": "general" } ]
PartyContest
Gunakan PartyContest
untuk kontes yang memungkinkan pemilih memilih partai di surat suara.
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 tulisan yang diizinkan per pemilih dalam
kontes ini. Jika VotesAllowed tidak ada di feed, nilai default 1 akan digunakan. |
OfficeIds |
1 | IDREFS |
ID unik untuk satu atau beberapa elemen Office .
Mengaitkan deskripsi kantor dengan kontes. |
Type |
0 atau lebih | ElectionType |
Jenis pemilihan yang dihitung, seperti utama atau umum. Jenis
Contest hanya boleh ditetapkan jika berbeda dengan jenis
Election . |
Contoh
XML
<Contest xsi:type="PartyContest" objectId="pc20001"> <BallotSelection objectId="ps101321" xsi:type="PartySelection"> <PartyIds>par10132</PartyIds> </BallotSelection> <BallotSelection objectId="ps101322" xsi:type="PartySelection"> <PartyIds>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": "ps101321", "PartyIds": [ "par10132" ] } ], "BallotSelection": [ { "@type": "PartySelection", "objectId": "ps101322", "PartyIds": [ "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
Gunakan BallotMeasureContest
untuk kontes yang melibatkan ukuran surat 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 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 inisiatif 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 inisiatif pemungutan suara lebih pendek dari 30.000 karakter dan tidak menyertakan format yang tidak valid dalam file feed, sertakan dalam |
InfoUri |
0 atau 1 | AnnotatedUri |
URI beranotasi 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 pada ukuran
surat suara ini. 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 pada 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 yang disebutkan dari inisiatif pemungutan suara. Pilih nilai yang paling menggambarkan inisiatif pemungutan suara di wilayah hukumnya. |
PassageThreshold |
0 atau 1 | string |
Porsi minimum suara yang diperlukan agar mosi disetujui. |
Contoh
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> <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>
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" } ], "PassageThreshold": [ "Text": [ { "value": "50.01%", "language": "en" } ] ], "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", } ]
RetentionContest
Gunakan jenis ini saat Contest
melibatkan referendum untuk memutuskan apakah pejabat terpilih harus tetap menjabat atau diberhentikan.
Hal ini mencakup kasus seperti kontes retensi yudisial di beberapa negara bagian AS yang memutuskan apakah seorang hakim harus melanjutkan masa jabatannya untuk periode berikutnya. Hal ini juga berlaku untuk pemilu pemanggilan kembali yang memutuskan apakah seorang pejabat harus dicopot sebelum masa jabatannya berakhir.
Elemen
Semua elemen dari BallotMeasureContest
juga berlaku
untuk RetentionContest
.
Elemen | Keanekaragaman | Jenis | Deskripsi |
---|---|---|---|
CandidateID |
1 | IDREF | ID kandidat yang mewakili pemegang jabatan yang saat ini memegang jabatan tersebut |
OfficeID |
0 atau 1 | IDREF | ID jabatan yang saat ini dipegang oleh pemegang jabatan |
Contoh
XML
<Contest objectId="rc40001" xsi:type="RetentionContest"> <!-- Retention contest selections are actually BallotMeasureSelection objects, and should use the 'bms' objectId prefix.--> <BallotSelection objectId="bms40001a" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bmc_bms40001a</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection label="bms40001at"> <Text language="en">Yes</Text> </Selection> </BallotSelection> <BallotSelection objectId="bms40001b" xsi:type="BallotMeasureSelection"> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>bmc_bms40001at</Value> </ExternalIdentifier> </ExternalIdentifiers> <Selection label="bms40001bt"> <Text language="en">No</Text> </Selection> </BallotSelection> <BallotTitle> <Text language="en">Retention of Supreme Court Justice</Text> </BallotTitle> <ElectoralDistrictId>ru0002</ElectoralDistrictId> <ExternalIdentifiers> <ExternalIdentifier> <Type>other</Type> <OtherType>stable</OtherType> <Value>vageneral-cont-2013-va16-country-us</Value> </ExternalIdentifier> </ExternalIdentifiers> <Name>Judicial Retention, Supreme Court</Name> <CandidateId>can12345</CandidateId> <OfficeId>off20006</OfficeId> </Contest>