Użyj typu Contest
, aby opisać wybory i połączyć je z odpowiednimi kandydatami i partiami.
W tym dokumencie omawiamy Contest
i jego podmioty:
Contest
CandidateContest
PartyContest
BallotMeasureContest
RetentionContest
Typy
Contest
to element abstrakcyjny z 3 typami, które są używane w zależności od rodzaju konkursu:
CandidateContest
: użyj tego typu, gdyContest
dotyczy jednego lub większej liczby kandydatów na urząd.PartyContest
: użyj tego typu, gdyContest
zawiera na karcie do głosowania listę partii.BallotMeasureContest
: użyj tego typu, gdyContest
obejmuje co najmniej 1 propozycję głosowania.RetentionContest
: użyj tego typu, gdyContest
dotyczy referendum, w którym wyborcy decydują, czy wybrany urzędnik powinien pozostać na stanowisku, czy zostać z niego odwołany.
W miarę publikowania wyników wyborów możesz aktualizować plik danych, aby wyświetlać różne etapy wyników, np. sondaże exit poll lub szacunki. Google podaje wskazówki dotyczące etapów wyborów i rodzajów wyników, których oczekujemy. Google może poprosić o jeden lub kilka etapów. Wartości te mogą ulec zmianie podczas wieczoru wyborczego. Ustaw początkową wartość pliku danych na etap, od którego chcesz zacząć. Więcej informacji znajdziesz w sekcji Elementy.ExternalIdentifiers
Atrybuty
W tabeli poniżej opisano atrybuty Contest
:
Atrybut | Wymagany? | Typ | Opis |
---|---|---|---|
objectId |
Wymagany | ID |
Unikalny identyfikator wewnętrzny używany przez inne elementy do odwoływania się do tego elementu. |
Elementy
W tabeli poniżej opisano elementy Contest
:
Element | Mnogość | Typ | Opis |
---|---|---|---|
Abbreviation |
0 lub 1 | string |
Krótka nazwa konkursu. |
BallotSelection |
0 lub więcej | BallotSelection |
Powiązanie wyborów na karcie do głosowania z wyborami. Kolejność kandydatów lub partii w Jeśli atrybut |
BallotSubTitle |
0 lub 1 | InternationalizedText |
Podtytuł konkursu, który musi być zgodny z tym, co widnieje na kartach do głosowania. |
BallotTitle |
0 lub 1 | InternationalizedText |
Tytuł konkursu. Tekst tytułu powinien być zgodny z przewodnikiem po składni. W przypadku referendum tytuł powinien być zgodny z treścią pytania na karcie do głosowania. |
ComposingContestIds |
0 lub więcej | IDREFS |
Służy do definiowania konkursu zbiorczego. Na przykład w wyborach prezydenckich w Stanach Zjednoczonych odbywają się wybory na poziomie krajowym, a także wybory na poziomie poszczególnych stanów, które mają własne identyfikatory.
|
ContestDateStatus |
0 lub 1 |
DateStatus
|
Ten element wskazuje aktualizacje harmonogramu wyborów. Wartością domyślną jest |
ElectoralDistrictId |
1 | IDREF |
Unikalny identyfikator elementu Na przykład w przypadku konkretnego konkursu |
ExternalIdentifiers |
1 | ExternalIdentifiers |
Przypisuje identyfikator do konkursu. Wymagany jest stały identyfikator. Aby podać etap wyników wyborów, który jest raportowany przez Twój plik danych, ustaw OtherType na wartość z ContestStage . |
HasRotation |
0 lub 1 | boolean |
Wskazuje, czy wybory w konkursie są rotowane. Jeśli ten element nie jest obecny, domyślna wartość to false . |
Name |
1 | string |
Musi być zgodny z elementem BallotTitle w języku angielskim i odpowiadać składni tytułu. |
SequenceOrder |
0 lub 1 | integer |
Domyślna kolejność elementów
Parametr |
SubsequentContestId |
0 lub 1 | IDREF |
Służy do wskazywania późniejszego konkursu w tym samym powiązanym zestawie. Na przykład w przypadku wyborów w Stanach Zjednoczonych zwykle wskazuje od prawyborów do powiązanych z nimi wyborów powszechnych. Może też wskazywać wybory powszechne jako źródło wyborów uzupełniających.
|
SubUnitsReported |
0 lub 1 | integer |
Liczba podjednostek, np. okręgów wyborczych, które zakończyły raportowanie głosów w tym konkursie. |
SummaryCounts |
0 lub więcej | SummaryCounts |
Zawiera podsumowanie różnych liczb związanych z konkursem. Obejmuje to łączną liczbę oddanych głosów, które zawierają wybory, oraz łączną liczbę głosów wstrzymujących się, głosów oddanych na więcej niż 1 kandydata, głosów oddanych na mniej niż 1 kandydata lub głosów oddanych na kandydata, którego nie ma na liście. Podsumowania liczbowe mogą być powiązane z konkursem jako całością lub z innymi jednostkami raportowania niższego poziomu dzięki użyciu wielu wystąpień elementu SummaryCounts . |
TotalSubUnits |
0 lub 1 | integer |
Łączna liczba podjednostek, np. okręgów wyborczych, w których w wyborach będzie można oddać głos na tego kandydata. |
VoteVariation |
0 lub 1 | VoteVariation |
Rodzaj wariantu głosowania powiązanego z konkursem, np. n-of-m . |
OtherVoteVariation |
0 lub 1 | string |
Służy do podawania wartości niestandardowej, gdy warunek VoteVariation jest other . |
StartDate |
0 lub 1 | PartialDate |
Data rozpoczęcia konkursu w kalendarzu. Użyj daty rozpoczęcia głosowania, np. 2022-11-08. Datę rozpoczęcia należy ustawić tylko wtedy, gdy data rozpoczęcia i zakończenia Contest różni się od daty rozpoczęcia i zakończenia Election .
|
EndDate |
0 lub 1 | PartialDate |
Data zakończenia konkursu w kalendarzu. Użyj daty zakończenia głosowania, np. 2022-11-08. Datę zakończenia należy ustawić tylko wtedy, gdy data rozpoczęcia i zakończenia Contest różnią się od daty rozpoczęcia i zakończenia Election .
|
CountingDate |
0 lub 1 | PartialDate |
Data po głosowaniu, w której następuje liczenie głosów w wyborach. Należy to uwzględnić tylko wtedy, gdy dzień liczenia głosów różni się od ostatniego dnia głosowania, np. w przypadku wyborów do indyjskiej Lok Sabhy. Zwykle liczenie głosów odbywa się w tym samym dniu co ostatni dzień głosowania, czyli w EndDate wyborów.
|
CandidateContest
Używaj typu CandidateContest
do opisywania konkursu, w którym wybierany jest co najmniej jeden kandydat.
Ten podmiot może opcjonalnie odwoływać się do Office
lub Party
za pomocą identyfikatora. Nie obsługujemy reprezentacji listy kandydatów w tym samym konkursie. Możesz odwoływać się tylko do jednego Office
. Na przykład w przypadku kandydatów na prezydenta i wiceprezydenta potrzebne są 2 Candidate
konkursy. Każda z nich odnosiłaby się do innego biura.
Elementy
W tabeli poniżej opisano elementy CandidateContest
:
Element | Mnogość | Typ | Opis |
---|---|---|---|
NumberElected |
0 lub 1 | integer |
Liczba kandydatów wybranych w konkursie, czyli n w konkursie typu n-of-m . Jeśli w pliku danych nie ma atrybutu NumberElected , używana jest wartość domyślna 1 . |
OfficeIds |
1 | IDREFS |
Unikalny identyfikator co najmniej jednego elementu Office .
Łączy opis biura z konkursem. |
PrimaryPartyIds |
0 lub więcej | IDREFS |
Unikalny identyfikator co najmniej jednego elementu Party , który wskazuje, że Contest jest częścią prawyborów partyjnych. PrimaryPartyId ma znaczenie tylko w prawyborach. |
VotesAllowed |
1 | integer |
Maksymalna liczba głosów lub wpisów dozwolonych na jednego głosującego w tym konkursie. Jeśli w pliku danych nie ma atrybutu VotesAllowed , używana jest wartość domyślna 1 . |
Type |
0 lub więcej | ElectionType |
Typ wyborów, np. prawybory lub wybory powszechne. Typ Contest należy ustawić tylko wtedy, gdy różni się od typu Election . |
Przykłady
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
Użyj PartyContest
w przypadku konkursu, w którym głosujący wybierają partię na karcie do głosowania.
Elementy
W tabeli poniżej opisano elementy PartyContest
:
Element | Mnogość | Typ | Opis |
---|---|---|---|
NumberElected |
0 lub 1 | integer |
Liczba kandydatów wybranych w konkursie, czyli n w konkursie typu n-of-m . Jeśli w pliku danych nie ma atrybutu NumberElected , używana jest wartość domyślna 1 . |
VotesAllowed |
0 lub 1 | integer |
Maksymalna liczba głosów lub wpisów dozwolonych na jednego głosującego w tym konkursie. Jeśli w pliku danych nie ma atrybutu VotesAllowed , używana jest wartość domyślna 1 . |
OfficeIds |
1 | IDREFS |
Unikalny identyfikator co najmniej jednego elementu Office .
Łączy opis biura z konkursem. |
Type |
0 lub więcej | ElectionType |
Typ wyborów, np. prawybory lub wybory powszechne. Typ Contest należy ustawić tylko wtedy, gdy różni się od typu Election . |
Przykłady
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
Użyj ikony BallotMeasureContest
w przypadku konkursu, który obejmuje głosowanie.
Elementy
W tabeli poniżej opisano elementy BallotMeasureContest
:
Element | Mnogość | Typ | Opis |
---|---|---|---|
BallotTitle |
1 | InternationalizedText |
Oficjalny tytuł karty do głosowania, np. Niektóre referenda mają jeden zbiorczy tytuł z wieloma ponumerowanymi pytaniami. W takich przypadkach tytuł może zawierać numer pytania, aby odróżnić |
BallotSubTitle |
0 lub 1 | InternationalizedText |
Podtytuł karty do głosowania, jeśli taki istnieje. |
BallotText |
1 | InternationalizedText |
Tekst, który pojawia się na karcie do głosowania. Na przykład: 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 lub 1 | InternationalizedText |
Kopia pełnego tekstu środka głosowania. Podaj ten element, jeśli jest dodatkowy tekst, który nie znajduje się na karcie do głosowania. Limit: 30 000 znaków. Jeśli pełny tekst propozycji jest krótszy niż 30 000 znaków i nie zawiera formatowania,które byłoby nieprawidłowe w pliku danych, umieść go w polu |
InfoUri |
0 lub 1 | AnnotatedUri |
Adnotowany identyfikator URI, który akceptuje te adnotacje, a nie adnotacje wymienione w innych miejscach:
|
SummaryText |
0 lub 1 | InternationalizedText |
Podsumowanie propozycji ustawodawczej. Składa się z 1–2 krótkich akapitów i może być generowany przez partnera w celu podsumowania pełnego tekstu karty do głosowania, jak w tym przykładzie:
|
ProStatement |
0 lub 1 | InternationalizedText |
Oświadczenie wyjaśniające, co oznacza głos Tak w przypadku tego środka głosowania. Nie jest to argument przemawiający za tym środkiem. Na przykład: A "yes" vote supports this initiative to require electric
utilities to acquire 50 percent of their electricity from renewable
resources by 2030. |
ConStatement |
0 lub 1 | InternationalizedText |
Wyjaśnienie, co oznacza głos Nie w tym referendum. Nie jest to argument przeciwko temu środkowi. Na przykład: 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 lub 1 | BallotMeasureType |
Typ wyliczeniowy propozycji ustawodawczej. Wybierz wartość, która najlepiej opisuje głosowanie w danym okręgu. |
PassageThreshold |
0 lub 1 | string |
Minimalny odsetek głosów wymagany do przyjęcia wniosku. |
Przykłady
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
Użyj tego typu, gdy Contest
dotyczy referendum, w którym wyborcy decydują, czy wybrany urzędnik powinien pozostać na stanowisku, czy zostać z niego usunięty.
Dotyczy to na przykład wyborów sędziów w niektórych stanach USA, w których decyduje się, czy sędzia powinien pełnić funkcję przez kolejną kadencję. Dotyczy to również wyborów odwoławczych, w których decyduje się, czy urzędnik powinien zostać usunięty ze stanowiska przed zakończeniem kadencji.
Elementy
Wszystkie elementy z BallotMeasureContest
obowiązują również w przypadku RetentionContest
.
Element | Mnogość | Typ | Opis |
---|---|---|---|
CandidateID |
1 | IDREF | Identyfikator kandydata reprezentującego urzędującego urzędnika |
OfficeID |
0 lub 1 | IDREF | Identyfikator urzędu, który obecnie sprawuje osoba pełniąca funkcję |
Przykłady
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>