Użyj typu Contest, aby opisać konkurs i powiązać go z odpowiednimi kandydatami i partiami.
W tym dokumencie omawiamy Contest i powiązane z nim elementy podrzędne:
ContestCandidateContestPartyContestBallotMeasureContestRetentionContest
Typy
Contest to element abstrakcyjny z 3 typami, które są używane w zależności od typu konkursu:
CandidateContest: użyj tego typu, gdyContestdotyczy co najmniej jednego kandydata na urząd.PartyContest: użyj tego typu, gdyContestma na karcie do głosowania listę partyjną. Można go też użyć jako wirtualnego konkursu, który jest podsumowaniem większego zestawu mniejszych konkursów.BallotMeasureContest: użyj tego typu, gdyContestobejmuje co najmniej 1 głosowanie nad ustawą.RetentionContest: użyj tego typu, gdyContestobejmuje referendum, w którym wyborcy decydują, czy wybrany urzędnik powinien pozostać na stanowisku, czy zostać z niego usunięty.
W miarę ogłaszania wyników wyborów możesz aktualizować kanał, 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 typów wyników, których oczekujemy. Google może poprosić o jeden lub kilka etapów. Te wartości mogą ulec zmianie podczas wieczoru wyborczego. Ustaw początkową wartość pliku danych na etap, od którego chcesz zacząć. Więcej informacji znajdziesz w sekcjach CurrentResultsReportingStage i ResultsReportingStageCollection w artykule Elementy.
Atrybuty
W tabeli poniżej opisano atrybuty elementu Contest:
| Atrybut | Wymagany? | Typ | Opis |
|---|---|---|---|
objectId |
Wymagane | 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. |
AggregateBallotSelection |
0 lub 1 | SpecialBallotSelection |
Wybór karty do głosowania na potrzeby agregacji liczby głosów, np. agregacji wielu kandydatów w kategorii „Inni”. |
BallotSelection |
0 lub więcej | BallotSelection |
Powiązuje opcje na karcie do głosowania z wyborami. Kolejność kandydatów lub partii w elemencie Jeśli dla każdego elementu jest podany atrybut |
BallotSubTitle |
0 lub 1 | InternationalizedText |
Podtytuł głosowania, 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 odpowiadać sformułowaniu na karcie do głosowania. |
BlankBallotSelection |
0 lub 1 | SpecialBallotSelection |
Wybór karty do głosowania w przypadku pustych kart. |
ComposingContestIds |
0 lub więcej | IDREFS |
Służy do definiowania konkursu zbiorczego. Na przykład w wyborach prezydenckich w USA odbywają się wybory na poziomie krajowym, które mają identyfikatory wyborów składowych dla poszczególnych wyborów na poziomie stanowym. Element |
ContestDateStatus |
0 lub 1 |
DateStatus
|
Ten element wskazuje aktualizacje harmonogramu wyborów. Wartością domyślną jest |
ContestDateType |
0 lub 1 |
ElectionDateType
|
Ten element wskazuje sposób dodania konkursu do kalendarza.
Jeśli nie zostanie podany, wartością domyślną jest |
CountingDate |
0 lub 1 | PartialDate |
Data po głosowaniu, kiedy odbywa się 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 Lok Sabha w Indiach. Zwykle liczenie głosów odbywa się tego samego dnia co ostatni dzień głosowania, czyli w EndDate wyborów.
|
CurrentResultsReportingStage |
1 | ResultsReportingStageType |
Bieżący etap raportowania wyników konkursu. |
EarliestPollsClose |
0 lub 1 | dateTime |
Gdy zostaną zamknięte pierwsze lokale wyborcze. |
ElectoralDistrictId |
1 | IDREF |
Unikalny identyfikator elementu Na przykład w przypadku konkretnego konkursu element |
ExternalIdentifiers |
1 | ExternalIdentifiers |
Powiąż identyfikator z konkursem. Wymagany jest stały identyfikator. |
EndDate |
0 lub 1 | PartialDate |
Data zakończenia konkursu. 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 elementu Contest różni się od daty rozpoczęcia i zakończenia elementu Election.
|
EstimatedExpectedVotePercentage |
0 lub 1 | float |
Często skracany jako EEVP, jest to szacowany odsetek oczekiwanej łącznej liczby głosów, które zostały zgłoszone w tym głosowaniu, jako liczba z zakresu od 0 do 100. Na przykład wartość 24,2% podaj jako |
FilingDeadline |
0 lub 1 | PartialDate |
Data, do której kandydat musi zgłosić się do wyborów. |
HasRotation |
0 lub 1 | boolean |
Wskazuje, czy opcje w konkursie są rotowane. Jeśli ten element nie jest obecny, domyślną wartością jest false. |
IsNotable |
0 lub 1 | boolean |
Czy podmiot jest uważany za godny uwagi. Jeśli nie określono, przyjmuje się false.
|
LatestPollsClose |
0 lub 1 | dateTime |
Po zamknięciu ostatnich lokali wyborczych. |
Name |
1 | string |
Powinien on odpowiadać BallotTitle w języku angielskim i być zgodny ze składnią tytułu. |
NoneOfTheAboveBallotSelection |
0 lub 1 | SpecialBallotSelection |
Opcja na karcie do głosowania, która umożliwia oddanie głosu na „Żadne z powyższych” lub równoważną opcję, np. „Żadne”, „Żadne z tych” lub „Niezdecydowany”. |
NullBallotSelection |
0 lub 1 | SpecialBallotSelection |
Wybór karty do głosowania w przypadku kart nieważnych lub uszkodzonych. Są to karty do głosowania, które zostały oznaczone w taki sposób, że nie można prawidłowo policzyć głosów. Przykłady nieważnych głosów to głosy, które zostały podarte, zabrudzone, zaznaczone zbyt wiele razy lub zbyt mało razy albo zaznaczone w sposób, który umożliwia identyfikację wyborcy. |
OutcomeDetermined |
0 lub 1 | boolean |
czy wynik wyborów został już ustalony;
|
Seat |
0 lub 1 | string |
Konkretne stanowisko, którego dotyczy konkurs. |
SequenceOrder |
0 lub 1 | integer |
Domyślna kolejność elementów
|
StartDate |
0 lub 1 | PartialDate |
Data rozpoczęcia konkursu. 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.
|
SubsequentContestId |
0 lub 1 | IDREF |
Służy do wskazywania późniejszego konkursu w tym samym powiązanym zestawie. Na przykład w wyborach w USA zwykle wskazuje z prawyborów na powiązane z nimi wybory powszechne. Może też wskazywać na wybory uzupełniające po wyborach powszechnych.
|
SubUnitsReported |
0 lub 1 | integer |
Liczba podjednostek, które zakończyły raportowanie głosów w tym głosowaniu. |
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ą dany konkurs, oraz łączną liczbę głosów wstrzymujących się, głosów nieważnych, głosów pustych lub głosów na kandydatów spoza listy. Podsumowania mogą być powiązane z konkursem jako całością lub z innymi jednostkami raportowania niższego poziomu przez wielokrotne użycie elementu SummaryCounts. |
TotalSeats |
0 lub 1 | integer |
Łączna liczba miejsc, które okręg wyborczy może obsadzić w ramach danego głosowania. Jest to suma miejsc do zdobycia, miejsc przeniesionych i miejsc nieobsadzonych. |
TotalSubUnits |
0 lub 1 | integer |
Łączna liczba podjednostek, w których to głosowanie jest na karcie do głosowania. |
VoteVariation |
0 lub 1 | VoteVariation |
Typ odmiany głosowania powiązanej z konkursem, np. n-of-m. |
OtherVoteVariation |
0 lub 1 | string |
Służy do podawania wartości niestandardowej, gdy parametr VoteVariation ma wartość other. |
ResultsEmbargoEnd |
0 lub 1 | dateTime |
gdy kończy się embargo na publikowanie wyników wyborów. |
ResultsExpected |
0 lub 1 | dateTime |
Kiedy można oczekiwać pierwszych wyników liczenia głosów w kanale. |
ResultsLastUpdated |
0 lub 1 | dateTime |
Kiedy wyniki konkursu zostały ostatnio zaktualizowane. |
ResultsReportingStageCollection |
0 lub 1 | Nie dotyczy |
Element kodu dla definicji W przypadku konkursu składowego (do którego odwołuje się element |
CandidateContest
Używaj mikrodanych CandidateContest do opisu konkursu, który polega na wyborze co najmniej jednego kandydata.
Ten element może opcjonalnie odwoływać się do elementu Office lub Party według identyfikatora. Nie obsługujemy reprezentacji listy kandydatów w tych samych wyborach. Możesz odwołać się tylko do jednego elementu Office. Na przykład w przypadku wyborów prezydenta i wiceprezydenta potrzebne są 2 konkursy Candidate. Każdy z nich odnosiłby 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 wyborach, czyli n w wyborach n-of-m. Jeśli w pliku danych nie ma parametru NumberElected, używana jest wartość domyślna 1. |
OfficeIds |
1 | IDREFS |
Unikalny identyfikator co najmniej jednego elementu Office. Powiąż 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 dopisanych kandydatów dozwolona na wyborcę 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 wyliczeniowy 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="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
Użyj PartyContest w przypadku głosowania, w którym wyborcy wybierają partię na karcie do głosowania.
Można go też używać w pliku danych o wynikach wyborów jako wirtualnego podsumowania wyborów, aby przekazywać dane zbiorcze (np. wybory partyjne na poziomie stanu, które podsumowują wyniki wyborów w okręgach wyborczych).
Elementy
W tabeli poniżej opisano elementy PartyContest:
| Element | Mnogość | Typ | Opis |
|---|---|---|---|
NumberElected |
0 lub 1 | integer |
Liczba kandydatów wybranych w wyborach, czyli n w wyborach 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 dopisanych kandydatów dozwolona na wyborcę 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.
Powiąż opis biura z konkursem. |
Type |
0 lub więcej | ElectionType |
Typ wyliczeniowy 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="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
Użyj BallotMeasureContest w przypadku głosowania nad ustawami.
Elementy
W tabeli poniżej opisano elementy BallotMeasureContest:
| Element | Mnogość | Typ | Opis |
|---|---|---|---|
BallotTitle |
1 | InternationalizedText |
Oficjalny tytuł głosowania, np. Niektóre referenda mają jeden tytuł zbiorczy z kilkoma ponumerowanymi pytaniami. W takich przypadkach tytuł może zawierać numer pytania, aby odróżnić elementy |
BallotSubTitle |
0 lub 1 | InternationalizedText |
Podtytuł karty do głosowania, jeśli 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 pytania referendalnego. Podaj ten element, jeśli istnieje dodatkowy tekst, który nie jest zawarty w karcie do głosowania. Limit wynosi 30 000 znaków. Jeśli pełny tekst pytania referendalnego 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 |
Identyfikator URI z adnotacjami, który akceptuje te adnotacje, a nie adnotacje wymienione w innym miejscu:
|
SummaryText |
0 lub 1 | InternationalizedText |
Podsumowanie wyniku głosowania. Składa się z 1–2 krótkich akapitów i może zostać wygenerowane przez partnera, aby podsumować pełny tekst karty do głosowania, jak w tym przykładzie:
|
ProStatement |
0 lub 1 | InternationalizedText |
Oświadczenie wyjaśniające, co oznacza głos na Tak w przypadku tej inicjatywy. Nie jest to argument na rzecz tego środka. 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 |
Oświadczenie wyjaśniające, co oznacza głos na 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 |
Wyliczony typ wyniku głosowania. Wybierz wartość, która najlepiej opisuje głosowanie w danej jurysdykcji. |
PassageThreshold |
0 lub 1 | string |
Minimalny udział głosów wymagany do przyjęcia wniosku. |
Przykłady
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
Użyj tego typu, gdy Contest obejmuje referendum, w którym decyduje się, czy wybrany urzędnik powinien pozostać na stanowisku, czy zostać z niego usunięty.
Obejmuje to takie przypadki jak wybory sędziów w niektórych stanach USA, które decydują o tym, czy sędzia powinien kontynuować pracę przez kolejną kadencję. Dotyczy to również wyborów odwołujących, które decydują o tym, czy urzędnik powinien zostać usunięty przed zakończeniem kadencji.
Elementy
Wszystkie elementy z: BallotMeasureContest dotyczą też: RetentionContest.
| Element | Mnogość | Typ | Opis |
|---|---|---|---|
CandidateId |
1 | IDREF | Identyfikator kandydata reprezentującego osobę sprawującą urząd, która obecnie sprawuje urząd |
OfficeId |
0 lub 1 | IDREF | Identyfikator urzędu, który obecnie sprawuje urzędnik |
Przykłady
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>