Concours

Utilisez Contest pour décrire un concours, et liez-le aux candidats et aux partis associés.

Ce document traite de Contest et de ses sous-entités:

  • Contest
    • CandidateContest
    • PartyContest
    • BallotMeasureContest

Concours

Contest est un élément abstrait dont les trois types sont utilisés en fonction du type de concours:

  • CandidateContest: utilisez ce type lorsqu'un Contest implique un ou plusieurs candidats à un bureau.
  • PartyContest: utilisez ce type lorsqu'une liste de partis est sélectionnée pour un Contest.
  • BallotMeasureContest: utilisez ce type lorsqu'un Contest implique une ou plusieurs mesures de vote.

Lorsque les résultats d'une élection sont rendus, vous pouvez mettre à jour votre flux pour afficher différentes étapes des résultats, telles que les sondages à la sortie des urnes ou les estimations. Google fournit des conseils sur les étapes et les types de résultats d'élections attendus. Google peut demander une ou plusieurs étapes. Ces valeurs peuvent changer pendant la nuit des élections. Définissez la valeur de flux initiale sur l'étape de départ. Pour en savoir plus, consultez ExternalIdentifiers dans la section Éléments.

Attributs

Le tableau suivant décrit les attributs de Contest:

Attribut Requis ? Type Description
objectId Obligatoire ID Identifiant interne unique utilisé par d'autres éléments pour faire référence à cet élément.

Éléments

Le tableau suivant décrit les éléments de Contest:

Élément Multiplicité Type Description
Abbreviation 0 ou 1 string Nom court du concours.
BallotSelection 0 ou plus BallotSelection

Associe les sélections effectuées sur le bulletin de vote au concours. L'ordre des candidats ou des partis dans la région Contest doit être le même que dans celui dans la région BallotSelection.

Si BallotSelection.SequenceOrder est présent pour chaque élément, il est utilisé comme ordre par défaut pour les sélections.
BallotSubTitle 0 ou 1 InternationalizedText Sous-titre du concours, qui doit correspondre à celui affiché sur les bulletins de vote des électeurs.
BallotTitle 0 ou 1 InternationalizedText Titre du concours, qui doit correspondre à celui affiché sur les bulletins de vote des électeurs.
BallotTitle 0 ou 1 InternationalizedText Titre du concours, qui doit correspondre à celui affiché sur les bulletins de vote des électeurs.
ComposingContestIds 0 ou plus IDREFS

Utilisé pour définir un concours de rattachement. Par exemple, lors des élections présidentielles américaines, il y a des élections au niveau national, où chaque élection au niveau de l'État est organisée au niveau national.

Une ComposingContest doit être associée à une portée inférieure à celle du concours parent et doit avoir lieu au même tour d'une élection.
ContestDateStatus 0 ou 1 DateStatus

Cet élément indique les mises à jour du calendrier d'une élection. La valeur par défaut est confirmed. Dans la plupart des cas, il est préférable que les valeurs ContestDateStatus correspondent au ElectionDateStatus de la Election qui la contient.
ElectoralDistrictId 1 IDREF

Identifiant unique d'un élément GpUnit. Associe le concours à une unité de rapport qui représente sa portée géographique, telle qu'un district.

Par exemple, pour un concours spécifique, ElectoralDistrictId peut faire référence à un ReportingUnit défini pour le district associé au concours. Office inclut également une référence facultative qui remplit la même fonction. Par exemple, pour un concours national, vous pouvez réutiliser le même GpUnit que celui défini pour le pays.
ExternalIdentifiers 1 ExternalIdentifiers Associe un identifiant au concours. Un identifiant stable est requis. Pour indiquer la scène des résultats des élections indiquée par votre flux, définissez OtherType avec une valeur issue de ContestStage.
HasRotation 0 ou 1 boolean Indique si les sélections du concours sont alternées. Si cet élément n'est pas présent, la valeur par défaut est false.
Name 1 string Nom du concours tel qu'il apparaît dans le rapport des résultats, et pas nécessairement tel qu'il apparaît dans le bulletin de vote.
SequenceOrder 0 ou 1 integer

Ordre par défaut des éléments Contest dans le but d'afficher les résultats. Les concours s'affichent selon les règles suivantes:

  • Si deux concours ont des valeurs identiques, ils peuvent être présentés dans un ordre non défini.
  • Tous les concours avec un SequenceOrder sont présentés dans cet ordre, suivis de tous les concours sans valeur SequenceOrder dans un ordre non défini.

SequenceOrder permet de classer les résultats affichés. Par exemple, 100 peut indiquer un concours régional, 200 peut indiquer un concours local, etc. L'utilisation de SequenceOrder n'est pas appropriée pour l'ordre de sélection. Toutefois, l'ordre de concours sur chaque bulletin de vote peut être conservé à l'aide de l'entité BallotStyle, qui associe les styles de bulletin de vote à leurs unités géopolitiques correspondantes.
SubsequentContestId 0 ou 1 IDREF

Utilisé pour pointer vers un concours ultérieur dans le même ensemble associé. Par exemple, lors d'élections américaines, il pointe généralement d'une primaire vers l'élection générale associée. Cela peut également aller d'une élection générale à un second tour.

Un SubsequentContest a généralement la même portée que le concours précédent.
SubUnitsReported 0 ou 1 integer Nombre de sous-unités, telles que les circonscriptions qui ont terminé les votes de rapport pour ce concours.
SummaryCounts 0 ou plus SummaryCounts Fournit un résumé des décomptes divers associés au concours. Cela inclut le nombre total de bulletins de vote émis pour le concours, ainsi que le nombre total d'abstentions, de survotes, de sous-votes ou d'écritures. Le décompte récapitulatif peut être associé au concours dans son ensemble ou à d'autres unités de rapport de niveau inférieur via l'utilisation de plusieurs occurrences de SummaryCounts.
TotalSubUnits 0 ou 1 integer Nombre total de sous-unités (par exemple, les circonscriptions dont les bulletins de vote sont soumis à cette élection).
VoteVariation 0 ou 1 VoteVariation Type de variante de vote associée au concours, par exemple n-of-m.
OtherVoteVariation 0 ou 1 string Utilisé pour fournir une valeur personnalisée lorsque VoteVariation est défini sur other.
StartDate 0 ou 1 PartialDate Date de début dans le calendrier du concours. Utilisez la date de début du sondage, par exemple 2022-11-08. Vous ne devez définir la date de début que si les dates de début et de fin de Contest diffèrent de celles de Election.
EndDate 0 ou 1 PartialDate Date de fin calendaire du concours. Utilisez la date de fin du sondage, par exemple 2022-11-08. Vous ne devez définir la date de fin que si les dates de début et de fin de Contest diffèrent de celles de Election.
CountingDate 0 ou 1 PartialDate Date après le vote pour le concours électoral. Cette information ne doit être incluse que si le jour de dépouillement est différent du dernier jour du vote, par exemple lors des élections indiennes de la Lok Sabha. En général, le dépouillement a lieu le même jour que le dernier jour du vote, soit le EndDate de l'élection.

CandidateContest

Utilisez CandidateContest pour décrire un concours impliquant la sélection d'un ou de plusieurs candidats.

Cette entité peut éventuellement référencer Office ou Party par ID. Il est impossible de représenter un ticket de candidats dans le même concours. Vous ne pouvez référencer qu'un seul Office. Par exemple, pour un ticket président et vice-président, vous aurez besoin de deux concours Candidate. Chacun d'eux ferait référence à un bureau différent.

Éléments

Le tableau suivant décrit les éléments de CandidateContest:

Élément Multiplicité Type Description
NumberElected 0 ou 1 integer Nombre de candidats élus dans le concours, qui correspond au n d'un concours n-of-m. Si NumberElected n'est pas présent dans le flux, la valeur par défaut 1 est utilisée.
OfficeIds 1 IDREFS Identifiant unique d'un ou de plusieurs éléments Office. Associe une description de bureau au concours.
PrimaryPartyIds 0 ou plus IDREFS Identifiant unique d'un ou de plusieurs éléments Party, qui indique que Contest fait partie d'une primaire partisane. PrimaryPartyId n'a d'intérêt que lors des élections primaires.
VotesAllowed 1 integer Nombre maximal de votes ou d'écritures autorisé par votant dans ce concours. Si VotesAllowed n'est pas présent dans le flux, la valeur par défaut 1 est utilisée.
Type 0 ou plus ElectionType Type de concours énuméré, tel que "principal" ou "général". Le type de Contest ne doit être défini que s'il diffère du type de Election.

Exemples

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">President of Kenya</Text>
        <Text language="es">Presidente de Kenya</Text>
        <Text language="fr">Président du Kenya</Text>
        <Text language="id">Presiden Kenya</Text>
      </BallotTitle>
      <CountStatus>...</CountStatus>
      <CountingDate>2022-08-11</CountingDate>
      <ElectoralDistrictId>...</ElectoralDistrictId>
      <EndDate>2022-08-09</EndDate>
      <Name>President of Kenya</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": "President and Vice-President of Kenya",
              "language": "en"
            },
            {
              "value": "Presidente y Vice-Presidente de Kenya",
              "language": "es"
            },
            {
              "value": "Président et vice-président du Kenya",
              "language": "fr"
            },
            {
              "value": "Presiden dan Wakil Presiden Kenya",
              "language": "id"
            },
            {
              "value": "राष्ट्रपति और केन्या के उपराष्ट्रपति",
              "language": "hi"
            },
            {
              "value": "Rais na Makamu wa Rais of Kenya",
              "language": "sw"
            }
          ]
        },
        "CountStatus": "...",
        "ElectoralDistrictId": "...",
        "Name": "President of Kenya",
        "SubUnitsReported": 48,
        "SummaryCounts": "...",
        "TotalSubUnits": 48,
        "VoteVariation": "1-of-m",
        "NumberElected": 1,
        "VotesAllowed": 1,
        "Type": "general"
      }
    ]

PartyContest

Utiliser PartyContest pour un concours au cours duquel les électeurs choisissent un parti.

Éléments

Le tableau suivant décrit les éléments de PartyContest:

Élément Multiplicité Type Description
NumberElected 0 ou 1 integer Nombre de candidats élus dans le concours, qui correspond au n d'un concours n-of-m. Si NumberElected n'est pas présent dans le flux, la valeur par défaut 1 est utilisée.
VotesAllowed 0 ou 1 integer Nombre maximal de votes ou d'écritures autorisé par votant dans ce concours. Si VotesAllowed n'est pas présent dans le flux, la valeur par défaut 1 est utilisée.
OfficeIds 1 IDREFS Identifiant unique d'un ou de plusieurs éléments Office. Associe une description de bureau au concours.
Type 0 ou plus ElectionType Type de concours énuméré, tel que "principal" ou "général". Le type de Contest ne doit être défini que s'il diffère du type de Election.

Exemples

XML

    <Contest xsi:type="PartyContest" objectId="pc20001">
      <BallotSelection objectId="ps10132" xsi:type="PartySelection">
        <PartyIds>par10132 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": "ps10132",
            "PartyIds": [
              "par10132", "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

Utilisez BallotMeasureContest pour les concours impliquant des scrutins.

Éléments

Le tableau suivant décrit les éléments de BallotMeasureContest:

Élément Multiplicité Type Description
BallotTitle 1 InternationalizedText

Titre officiel du scrutin, par exemple Nevada Renewable Energy Standards Initiative. Assurez-vous que BallotTitle est unique.

Certains référendums ont un titre collectif unique avec plusieurs questions numérotées. Dans ce cas, le titre peut inclure le numéro de la question afin de distinguer les entités BallotMeasureContest créées pour chaque question.
BallotSubTitle 0 ou 1 InternationalizedText Sous-titre du bulletin de vote, le cas échéant.
BallotText 1 InternationalizedText Texte qui apparaît sur le bulletin de vote. Par exemple : 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 ou 1 InternationalizedText

Une copie de l'intégralité du texte de vote Indiquez cet élément si le bulletin de vote lui-même ne contient pas de texte supplémentaire. Limité à 30 000 caractères.

Si le texte complet du scrutin comprend moins de 30 000 caractères et n'inclut aucune mise en forme non valide dans un fichier de flux, incluez-le dans FullText. Incluez également InfoUri avec un URI annoté de fulltext. Sinon, n'incluez que l'URI avec une annotation fulltext.
InfoUri 0 ou 1 AnnotatedUri

URI annoté qui accepte les annotations suivantes, plutôt que les annotations répertoriées ailleurs:

  • wikipedia: page Wikipédia sur le référendum local
  • ballotpedia: page de scrutin sur le scrutin Par exemple, https://ballotpedia.org/Nevada_Renewable_Energy_Standards_Initiative_(2020).
  • official-website: site Web officiel du référendum
  • fulltext: si le bulletin de vote comporte plus de texte que le contenu du bulletin de vote, par exemple une copie de la proposition de loi, il s'agit d'un URI pour le texte supplémentaire complet. Voici un exemple : https://www.nvsos.gov/sos/home/showdocument?id=5330
  • logo-uri: image du logo
SummaryText 0 ou 1 InternationalizedText

Résumé de la mesure de vote. Le partenaire peut générer un ou deux paragraphes courts pour résumer l'intégralité du texte du bulletin de vote, comme dans l'exemple suivant:

Requires utilities to acquire 50 percent of their electricity from renewable resources by 2030

Official Summary:

EXPLANATION—This ballot measure proposes to amend Article 4 of the Nevada Constitution to require all providers of electric utility services that sell electricity to retail customers for consumption in Nevada to meet a Renewable Portfolio Standard (RPS) that would go into effect beginning in calendar year 2022 and increase gradually until the RPS reaches 50 percent in calendar year 2030. According to the Public Utilities Commission of Nevada, an RPS establishes the percentage of electricity sold by an electric utility to retail customers that must come from renewable sources.
ProStatement 0 ou 1 InternationalizedText Une déclaration expliquant la signification d'un oui pour ce scrutin. Il ne s'agit pas d'un argument en faveur de la mesure. Exemple : A "yes" vote supports this initiative to require electric utilities to acquire 50 percent of their electricity from renewable resources by 2030.
ConStatement 0 ou 1 InternationalizedText Une déclaration expliquant la signification d'un vote Non pour ce scrutin. Il ne s'agit pas d'un argument contre la mesure. Par exemple : 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 ou 1 BallotMeasureType Type énuméré d'un scrutin. Sélectionnez la valeur qui décrit le mieux le scrutin de sa juridiction.

Exemples

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>
        <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"
          }
        ],
        "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",
      }
    ]