GpUnit et éléments associés

Une unité géopolitique, ou GpUnit, décrit toute unité physique ou virtuelle de représentation ou d'agrégation de votes/sièges. Utilisez cette entité pour définir des unités géopolitiques telles que des villes, des districts, des juridictions ou des circonscriptions afin d'associer des élections, des bureaux, des décomptes de voix ou d'autres informations à ces zones géographiques.

GpUnit

Les entités suivantes contiennent des références à GpUnit :

  • Election, Contest et Office contiennent une référence obligatoire à un élément GpUnit, qui définit la juridiction de l'élection, du scrutin ou du poste, respectivement.
  • SummaryCounts et VoteCounts font référence à GpUnit pour associer les récapitulatifs ou les nombres de votes aux éléments GpUnit définis pour les circonscriptions ou d'autres types d'unités géopolitiques.

Les relations parent-enfant pour les entités GpUnit similaires doivent être cohérentes. Par exemple, tous les districts congressionnels doivent avoir un seul parent, qui est un État, même si un district congressionnel particulier est entièrement contenu dans un comté.

Attributs

Le tableau suivant décrit les attributs de GpUnit :

Attribut Obligatoire ? 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 GpUnit :

Élément Multiplicité Type Description
ComposingGpUnitIds 0 ou 1 IDREFS

Identifiant unique pour un ou plusieurs éléments GpUnit. Utilisé pour référencer d'autres éléments GpUnit et les associer à l'élément GpUnit parent. Chaque élément référencé doit être défini pour une unité géopolitique contenue dans l'élément GpUnit parent.

Utilisez l'élément ComposingGpUnitIds pour ne représenter que les enfants directs de ce GpUnit spécifique. Par exemple, si les circonscriptions A et B se trouvent dans la ville M, et que la ville M se trouve dans le comté X, listez les circonscriptions A et B comme enfants de la ville M. La ville M est un enfant du comté X, mais ne faites pas des circonscriptions A et B des enfants du comté X.
ExternalIdentifiers 0 ou 1 ExternalIdentifiers

Associe un ID à GpUnit, tel que le code d'un quartier ou d'une ville.

Lorsque vous incluez ExternalIdentifiers, si le type n'est pas listé dans l'énumération IdentifierType, utilisez un Type de other et fournissez votre type personnalisé dans OtherType.

Name 0 ou 1 string Nom de l'unité géopolitique.
SummaryCounts 0 ou plus SummaryCounts

Nombre de bulletins de vote, comme les bulletins avec plusieurs votes, les bulletins avec un vote incomplet et le nombre total de bulletins. Ils peuvent également être ventilés par type d'appareil et par classe de bulletin.

GpUnit inclut SummaryCounts pour fournir des récapitulatifs des zones géopolitiques correspondantes.

ReportingUnit

Utilisez ReportingUnit pour définir une unité géopolitique telle qu'un État, une ville, une municipalité ou une circonscription avec l'énumération ReportingUnitType.

Election fait référence à cet élément pour identifier la portée géographique de l'élection. Dans ce cas, l'élément ReportingUnit qui définit le champ d'application de l'élection peut inclure ElectionAdministration pour fournir des informations sur l'autorité électorale.

Un ReportingUnit peut être l'enfant d'un autre ReportingUnit au maximum. Toutefois, si un ReportingUnit a besoin de plusieurs parents, car il s'étend légitimement sur plusieurs éléments ReportingUnit parents, contactez votre point de contact Google pour obtenir de l'aide.

La syntaxe XML pour ReportingUnit est <GpUnit xsi:type="ReportingUnit" ... />.

Éléments

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

Élément Multiplicité Type Description
AuthorityIds 0 ou 1 IDREFS Le objectId d'un ou de plusieurs éléments Person décrivant une autorité responsable de l'unité de reporting.
ContactInformation 0 ou 1 ContactInformation Associe des coordonnées à l'unité de signalement, comme l'adresse d'un bureau de vote.
CountStatus 0 ou plus CountStatus Fournit différents états de comptage pour différents types de bulletins de vote ou d'autres éléments.
ElectionAdministration 0 ou 1 ElectionAdministration Fournit des informations sur une autorité électorale. Utilisez cette option lorsque l'unité de signalement fait office d'autorité lors de l'élection.
InternationalizedName 1 InternationalizedText Nom complet et canonique de l'unité géopolitique, et non une abréviation. Par exemple, "Alaska" ou "14e circonscription de l'État de New York".
IsDistricted 0 ou 1 boolean Le booléen IsDistricted peut être utilisé de plusieurs manières. Ce n'est pas strictement nécessaire, car il est possible d'identifier les quartiers par leur sous-élément Type. Vous pouvez également examiner le sous-élément ElectoralDistrictId de l'élément Contest, qui renvoie à la circonscription électorale associée à l'élection. Toutefois, si une circonscription est définie, mais n'est pas associée à un scrutin, ou si le type de circonscription est indiqué avec OtherType, IsDistricted est nécessaire pour identifier GpUnit comme circonscription. Le booléen IsDistricted peut également être utilisé pour indiquer qu'un GpUnit défini comme une juridiction, comme une ville, est également utilisé comme circonscription, par exemple pour des concours à l'échelle de la ville.
IsMailOnly 0 ou 1 boolean Indique si l'unité de signalement ne traite que les élections par correspondance ou par vote par procuration. Si elle n'est pas présente, la valeur par défaut est false.
SubUnitsReported 0 ou 1 integer Nombre de sous-unités associées, telles que les circonscriptions, qui ont terminé leur reporting.
TotalSubUnits 0 ou 1 integer Nombre total de sous-unités associées, telles que les circonscriptions.
Type 1 ReportingUnitType

Type énuméré de l'unité de reporting, tel qu'un État, une ville, un district ou une circonscription.

Si le type d'unité de reporting ne figure pas dans l'énumération ReportingUnitType, utilisez un Type de other et indiquez votre type d'unité de reporting personnalisé dans OtherType.
OtherType 0 ou 1 string Permet de spécifier le type d'unité géopolitique lorsque la valeur de ReportingUnitType est other.
VotersParticipated 0 ou 1 integer Nombre d'électeurs ayant participé au scrutin. Autrement dit, le nombre de personnes qui se sont présentées aux urnes, y compris celles qui n'ont pas voté.
VotersRegistered 0 ou 1 integer Nombre d'électeurs inscrits résidant dans les limites de l'unité géopolitique.

Exemples

XML

    <GpUnit objectId="ru0081" xsi:type="ReportingUnit">
      <ComposingGpUnitIds>ru_wahlkreis1 ru_wahlkreis2</ComposingGpUnitIds>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-state-0081</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>ocd-id</Type>
          <Value>ocd-division/country:de/state:hb</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <InternationalizedName>
        <Text language="en">Bremen</Text>
      </InternationalizedName>
      <Name>Bremen</Name>
      <Type>state</Type>
    </GpUnit>

JSON

    "GpUnit": [
      {
        "@type": "ReportingUnit",
        "objectId": "ru0081",
        "ComposingGpUnitIds": [
          "ru_wahlkreis1",
          "ru_wahlkreis2"
        ],
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "stable-state-0081"
            },
            {
              "Type": "ocd-id",
              "Value": "ocd-division/country:de/state:hb"
            }
          ]
        },
        "InternationalizedName": {
          "Text": [
            {
              "language": "en",
              "value": "Bremen"
            }
          ]
        },
        "Name": "Bremen",
        "Type": "state"
      }
    ]