Utilizza Contest per descrivere una competizione e collegarla ai candidati e ai partiti associati.
Questo documento illustra Contest e le relative entità secondarie:
ContestCandidateContestPartyContestBallotMeasureContestRetentionContest
Tipi
Contest è un elemento astratto con tre tipi che vengono utilizzati in base al tipo di concorso:
CandidateContest: utilizza questo tipo quando unContestcoinvolge uno o più candidati per una carica.PartyContest: utilizza questo tipo quando unContestha una selezione di liste di partito sulla scheda elettorale. Può essere utilizzato anche come concorso virtuale che riassume un insieme più ampio di concorsi più piccoli.BallotMeasureContest: utilizza questo tipo quando unContestprevede una o più misure di voto.RetentionContest: utilizza questo tipo quando unContestprevede un referendum per decidere se un funzionario eletto deve rimanere in carica o essere rimosso.
Man mano che vengono comunicati i risultati di un'elezione, puoi aggiornare il feed per mostrare
le diverse fasi dei risultati, ad esempio gli exit poll o le stime. Google fornisce indicazioni sulle fasi elettorali e sui tipi di risultati previsti. Google può richiedere una o più fasi. Questi valori del tipo di fase potrebbero cambiare durante la notte delle elezioni. Imposta il valore iniziale del feed sulla fase da cui iniziare. Per maggiori dettagli, consulta CurrentResultsReportingStage e ResultsReportingStageCollection nella sezione Elementi.
Attributi
La tabella seguente descrive gli attributi per Contest:
| Attributo | Obbligatorio? | Tipo | Descrizione |
|---|---|---|---|
objectId |
Obbligatorio | ID |
Identificatore interno univoco utilizzato da altri elementi per fare riferimento a questo elemento. |
Elementi
La tabella seguente descrive gli elementi per Contest:
| Elemento | Molteplicità | Tipo | Descrizione |
|---|---|---|---|
Abbreviation |
0 o 1 | string |
Nome breve del concorso. |
AggregateBallotSelection |
0 o 1 | SpecialBallotSelection |
Selezione delle schede elettorali per le aggregazioni dei conteggi dei voti, ad esempio l'aggregazione di più candidati in "Altri". |
BallotSelection |
0 o più | BallotSelection |
Associa le selezioni sulla scheda elettorale alla competizione. L'ordine dei candidati o dei partiti in Se |
BallotSubTitle |
0 o 1 | InternationalizedText |
Sottotitolo della competizione elettorale, che deve corrispondere a come appare sulle schede elettorali degli elettori. |
BallotTitle |
0 o 1 | InternationalizedText |
Titolo del concorso. Il testo del titolo deve corrispondere alla guida alla sintassi. Per le iniziative popolari, il titolo deve corrispondere alla dicitura sulla scheda elettorale. |
BlankBallotSelection |
0 o 1 | SpecialBallotSelection |
Selezione della scheda elettorale per le schede vuote. |
ComposingContestIds |
0 o più | IDREFS |
Utilizzato per definire un contesto di aggregazione. Ad esempio, nelle elezioni generali presidenziali degli Stati Uniti, esiste una competizione a livello nazionale con ID competizione per ciascuna delle elezioni a livello statale. Un |
ContestDateStatus |
0 o 1 |
DateStatus
|
Questo elemento indica gli aggiornamenti della programmazione per un'elezione. Il valore predefinito è |
ContestDateType |
0 o 1 |
ElectionDateType
|
Questo elemento indica il modo in cui il concorso viene aggiunto al calendario.
Se omesso, il valore predefinito è il |
CountingDate |
0 o 1 | PartialDate |
La data successiva al voto in cui avviene il conteggio per la competizione elettorale.
Questo campo deve essere incluso solo se il giorno del conteggio è diverso dall'ultimo giorno di votazione, ad esempio le elezioni della Lok Sabha in India. In genere, il conteggio avviene lo stesso giorno dell'ultimo giorno di votazione, ovvero il EndDate delle elezioni.
|
CurrentResultsReportingStage |
1 | ResultsReportingStageType |
La fase attuale della segnalazione dei risultati per la competizione. |
EarliestPollsClose |
0 o 1 | dateTime |
Quando chiudono i primi seggi. |
ElectoralDistrictId |
1 | IDREF |
Identificatore univoco di un elemento Ad esempio, per un concorso specifico, |
ExternalIdentifiers |
1 | ExternalIdentifiers |
Associa un ID al concorso. È richiesto un identificatore stabile. |
EndDate |
0 o 1 | PartialDate |
La data di fine del concorso. Utilizza la data di fine delle votazioni, ad esempio 2022-11-08. La data di fine deve essere impostata solo se la data di inizio e di fine di Contest è diversa dalla data di inizio e di fine di Election.
|
EstimatedExpectedVotePercentage |
0 o 1 | float |
Spesso abbreviata in EEVP, questa è la percentuale stimata dei voti totali previsti che sono stati segnalati per questo concorso, come numero compreso tra 0 e 100. Ad esempio, indica 24,2% come |
FilingDeadline |
0 o 1 | PartialDate |
La data entro la quale un candidato deve presentare la domanda per la competizione. |
HasRotation |
0 o 1 | boolean |
Indica se le selezioni nella competizione vengono ruotate. Se questo elemento non è presente, il valore predefinito è false. |
IsNotable |
0 o 1 | boolean |
Se l'entità è considerata degna di nota. Se non specificato, viene utilizzato il valore false.
|
LatestPollsClose |
0 o 1 | dateTime |
Quando chiudono gli ultimi seggi. |
Name |
1 | string |
Deve corrispondere a BallotTitle in inglese e alla sintassi del titolo. |
NoneOfTheAboveBallotSelection |
0 o 1 | SpecialBallotSelection |
Selezione della scheda elettorale per l'opzione su una scheda elettorale per votare "Nessuna delle risposte precedenti" o una selezione equivalente, ad esempio "Nessuna", "Nessuna di queste" o "Non impegnato". |
NullBallotSelection |
0 o 1 | SpecialBallotSelection |
Selezione della scheda elettorale per schede nulle o non valide. Si tratta di schede elettorali contrassegnate in modo tale che il voto non può essere conteggiato correttamente. Esempi di schede nulle sono schede strappate, sporche, con troppi o troppo pochi segni o contrassegnate in modo da identificare l'elettore. |
OutcomeDetermined |
0 o 1 | boolean |
Se il risultato delle elezioni è stato determinato.
|
Seat |
0 o 1 | string |
Il seggio specifico per cui si tiene la competizione. |
SequenceOrder |
0 o 1 | integer |
L'ordinamento predefinito degli elementi
|
StartDate |
0 o 1 | PartialDate |
La data di inizio del concorso. Utilizza la data di inizio delle votazioni, ad esempio 2022-11-08. La data di inizio deve essere impostata solo se le date di inizio e di fine di Contest sono diverse dalle date di inizio e di fine di Election.
|
SubsequentContestId |
0 o 1 | IDREF |
Utilizzato per rimandare a una competizione successiva nello stesso insieme correlato. Nelle elezioni statunitensi, ad esempio, di solito rimanda da un'elezione primaria alle elezioni generali correlate. Può anche rimandare da un'elezione generale a un'elezione di ballottaggio. Un |
SubUnitsReported |
0 o 1 | integer |
Il numero di subunità, ad esempio i collegi elettorali, che hanno completato la segnalazione dei voti per questa competizione. |
SummaryCounts |
0 o più | SummaryCounts |
Fornisce un riepilogo dei vari conteggi associati al concorso. Sono inclusi il numero totale di schede elettorali espresse che contengono la competizione e il numero totale di astensioni, voti in eccesso, voti in difetto o candidati non presenti sulla scheda. I conteggi di riepilogo possono essere associati al concorso nel suo complesso o ad altre unità di reporting di livello inferiore tramite l'utilizzo di più occorrenze di SummaryCounts. |
TotalSeats |
0 o 1 | integer |
Il numero totale di seggi che il distretto elettorale per questo concorso può assegnare per la carica. Questo valore equivale ai seggi in palio + i seggi riportati + i seggi vacanti. |
TotalSubUnits |
0 o 1 | integer |
Il numero totale di sottounità, ad esempio i collegi elettorali, che hanno questa competizione nella scheda elettorale. |
VoteVariation |
0 o 1 | VoteVariation |
Il tipo di variazione di voto associato alla competizione, ad esempio
n-of-m. |
OtherVoteVariation |
0 o 1 | string |
Utilizzato per fornire un valore personalizzato quando VoteVariation è
other. |
ResultsEmbargoEnd |
0 o 1 | dateTime |
Quando termina un embargo sulla pubblicazione dei risultati elettorali. |
ResultsExpected |
0 o 1 | dateTime |
Quando è prevista la visualizzazione dei primi risultati del conteggio dei voti nel feed. |
ResultsLastUpdated |
0 o 1 | dateTime |
Data e ora dell'ultimo aggiornamento dei risultati della competizione. |
ResultsReportingStageCollection |
0 o 1 | N/D | Elemento wrapper per le definizioni di ResultsReportingStage. Per maggiori dettagli, consulta
Entità di raccolta.
|
CandidateContest
Utilizza CandidateContest per descrivere un concorso che prevede la selezione di uno o più candidati.
Questa entità può facoltativamente fare riferimento a Office
o Party tramite ID. Non supportiamo la rappresentazione di una lista di candidati nella stessa competizione; puoi fare riferimento solo a un Office. Ad esempio, per un ticket di presidente e vicepresidente, sono necessarie due competizioni Candidate. Ognuno
farebbe riferimento a un ufficio diverso.
Elementi
La tabella seguente descrive gli elementi per CandidateContest:
| Elemento | Molteplicità | Tipo | Descrizione |
|---|---|---|---|
NumberElected |
0 o 1 | integer |
Il numero di candidati eletti nella competizione, ovvero il valore n di una competizione n-of-m. Se NumberElected non è presente nel feed, viene utilizzato il valore predefinito 1. |
OfficeIds |
1 | IDREFS |
Identificatore univoco per uno o più elementi Office. Associa una descrizione della carica alla competizione. |
PrimaryPartyIds |
0 o più | IDREFS |
Identificatore univoco di uno o più elementi Party, che indicano che Contest fa parte di una primaria di partito. PrimaryPartyId è significativo solo in un'elezione primaria. |
VotesAllowed |
1 | integer |
Il numero massimo di voti o candidati non in lista consentiti per elettore in questa competizione. Se VotesAllowed non è presente nel feed, viene utilizzato un valore predefinito di 1. |
Type |
0 o più | ElectionType |
Il tipo enumerato di una competizione, ad esempio primaria o generale. Il tipo di Contest deve essere impostato solo se è diverso dal tipo di Election. |
Esempi
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
Utilizza PartyContest per una competizione in cui gli elettori scelgono un partito sulla scheda elettorale.
Può essere utilizzato anche in un feed dei risultati elettorali come competizione di riepilogo virtuale per comunicare dati aggregati (ad es. una competizione di partito a livello statale che aggrega i risultati delle competizioni dei collegi elettorali).
Elementi
La tabella seguente descrive gli elementi per PartyContest:
| Elemento | Molteplicità | Tipo | Descrizione |
|---|---|---|---|
NumberElected |
0 o 1 | integer |
Il numero di candidati eletti nella competizione, ovvero il valore n di una competizione n-of-m. Se NumberElected non è presente nel feed, viene utilizzato il valore predefinito 1. |
VotesAllowed |
0 o 1 | integer |
Il numero massimo di voti o candidati non in lista consentiti per elettore in questa competizione. Se VotesAllowed non è presente nel feed, viene utilizzato un valore predefinito di 1. |
OfficeIds |
1 | IDREFS |
Identificatore univoco di uno o più elementi Office.
Associa una descrizione dell'ufficio al concorso. |
Type |
0 o più | ElectionType |
Il tipo enumerato di una competizione, ad esempio primaria o generale. Il tipo di Contest deve essere impostato solo se è diverso dal tipo di Election. |
Esempi
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
Utilizza BallotMeasureContest per una competizione che prevede misure elettorali.
Elementi
La tabella seguente descrive gli elementi per BallotMeasureContest:
| Elemento | Molteplicità | Tipo | Descrizione |
|---|---|---|---|
BallotTitle |
1 | InternationalizedText |
Il titolo ufficiale della votazione, ad esempio Alcuni referendum hanno un unico titolo collettivo con più domande numerate. In questi casi, il titolo può includere il numero della domanda per distinguere tra le entità |
BallotSubTitle |
0 o 1 | InternationalizedText |
Il sottotitolo della scheda elettorale, se presente. |
BallotText |
1 | InternationalizedText |
Il testo che appare sulla scheda elettorale. Ad esempio: 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 o 1 | InternationalizedText |
Una copia del testo completo della proposta di legge. Fornisci questo elemento se è presente del testo aggiuntivo non incluso nella scheda elettorale stessa. Limite di 30.000 caratteri. Se il testo completo della proposta di legge è più breve di 30.000 caratteri e non include formattazioni non valide in un file del feed, includilo in |
InfoUri |
0 o 1 | AnnotatedUri |
Un URI annotato che accetta le seguenti annotazioni, anziché quelle elencate altrove:
|
SummaryText |
0 o 1 | InternationalizedText |
Un riepilogo della proposta di legge. È composto da uno o due brevi paragrafi e può essere generato dal partner per riassumere il testo completo della scheda elettorale, come nell'esempio seguente:
|
ProStatement |
0 o 1 | InternationalizedText |
Una dichiarazione che spiega cosa significa un voto Sì su questa misura
di voto. Non è un argomento a favore della misura. Ad esempio: A "yes" vote supports this initiative to require electric
utilities to acquire 50 percent of their electricity from renewable
resources by 2030. |
ConStatement |
0 o 1 | InternationalizedText |
Una dichiarazione che spiega cosa significa un voto No su questa iniziativa popolare. Non è un argomento contro la misura. Ad esempio: 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 o 1 | BallotMeasureType |
Un tipo enumerato di un'iniziativa popolare. Seleziona il valore che meglio descrive la misura elettorale nella sua giurisdizione. |
PassageThreshold |
0 o 1 | string |
La percentuale minima di voti richiesta per l'approvazione di una mozione. |
Esempi
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
Utilizza questo tipo quando un Contest prevede un referendum per decidere se un funzionario eletto deve rimanere in carica o essere rimosso.
Sono inclusi casi come le elezioni per la conferma dei giudici in alcuni stati degli Stati Uniti, che decidono se un giudice deve continuare per un altro mandato. Si applica anche alle elezioni di revoca che decidono se un funzionario deve essere rimosso prima della fine del suo mandato.
Elementi
Tutti gli elementi di BallotMeasureContest si applicano anche a RetentionContest.
| Elemento | Molteplicità | Tipo | Descrizione |
|---|---|---|---|
CandidateId |
1 | IDREF | L'ID del candidato che rappresenta il funzionario che attualmente ricopre la carica |
OfficeId |
0 o 1 | IDREF | L'ID della carica attualmente ricoperta dal funzionario |
Esempi
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>