GpUnit ed elementi correlati

Un'unità geopolitica, o GpUnit, descrive qualsiasi unità fisica o virtuale di rappresentazione o aggregazione di voti/seggi. Utilizza questa entità per definire le unità geopolitiche, come città, distretti, giurisdizioni o circoscrizioni, per associare concorsi, uffici, numero di voti o altre informazioni a queste aree geografiche.

GpUnit

Le seguenti entità contengono riferimenti a GpUnit:

  • Election, Contest e Office contengono un riferimento obbligatorio a un elemento GpUnit, che definisce rispettivamente la giurisdizione delle elezioni, del concorso o della carica.
  • SummaryCounts e VoteCounts fanno riferimento a GpUnit per il riepilogo dei link o il numero di voti per GpUnit elementi definiti per rettori o altri tipi di unità geopolitiche.

Le relazioni padre-figlio per entità GpUnit simili devono essere coerenti. Ad esempio, tutti i distretti congressuali devono avere un solo genitore, ovvero uno stato, anche se un determinato collegio elettorale è interamente contenuto all'interno di una contea.

Attributi

Nella tabella seguente vengono descritti gli attributi di GpUnit:

Attributo Campo obbligatorio? Tipo Descrizione
objectId Obbligatorie ID Identificatore interno univoco utilizzato da altri elementi per fare riferimento a questo elemento.

Elementi

Nella tabella seguente vengono descritti gli elementi di GpUnit:

Elemento Molteplicità Tipo Descrizione
ComposingGpUnitIds 0 o 1 IDREFS

Identificatore univoco per uno o più elementi GpUnit. Utilizzato per fare riferimento ad altri elementi GpUnit e associarli all'elemento GpUnit principale. Ogni elemento di riferimento deve essere definito per un'unità geopolitica contenuta all'interno dell'elemento GpUnit principale.

Utilizza l'elemento ComposingGpUnitIds per rappresentare solo gli elementi secondari diretti di quel determinato GpUnit. Ad esempio, se i quartieri A e B si trovano nella Città M e la Città M si trova nella Contea X, elenca i circoscrizioni A e B come secondari della Città M. Quindi, City M è figlio della contea X, ma non far diventare i distretto A e B figli della contea X.
ExternalIdentifiers 0 o 1 ExternalIdentifiers

Associa un ID a GpUnit, ad esempio il codice di un distretto o di una città.

Quando includi ExternalIdentifiers, se il tipo non è elencato nell'enumerazione IdentifierType, utilizza Type di other e fornisci il tuo tipo personalizzato in OtherType.

Name 0 o 1 string Nome dell'unità geopolitica.
SummaryCounts 0 o più SummaryCounts

I conteggi del riepilogo delle votazioni, come voti sovrapposti, voti insufficienti e il totale dei voti. Facoltativamente, possono essere suddivisi per tipo di dispositivo e classe di votazione.

GpUnit include SummaryCounts per fornire un riepilogo dei conteggi per la corrispondente area geografica geopolitica.

ReportingUnit

Utilizza ReportingUnit per definire un'unità geopolitica, ad esempio uno stato, una città, un distretto o un distretto con l'enumerazione di ReportingUnitType.

Election fa riferimento a questo elemento per identificare l'ambito geografico delle elezioni. In questo caso, l'elemento ReportingUnit che definisce l'ambito delle elezioni può includere ElectionAdministration per fornire informazioni relative alle autorità elettorali.

Un ReportingUnit può essere al massimo il figlio di un altro ReportingUnit. Tuttavia, se un ReportingUnit ha bisogno di più genitori perché si estende legittimamente agli elementi ReportingUnit principali, rivolgiti al tuo punto di contatto Google per ricevere indicazioni.

La sintassi XML per ReportingUnit è <GpUnit xsi:type="ReportingUnit" ... />.

Elementi

Nella tabella seguente vengono descritti gli elementi di ReportingUnit:

Elemento Molteplicità Tipo Descrizione
AuthorityIds 0 o 1 IDREFS objectId di uno o più elementi Person che descrivono un'autorità responsabile dell'unità di reporting.
ContactInformation 0 o 1 ContactInformation Associa le informazioni di contatto all'unità segnalante, ad esempio l'indirizzo di un centro elettorale.
CountStatus 0 o più CountStatus Fornisce vari stati di conteggio per diversi tipi di voti o altre voci.
ElectionAdministration 0 o 1 ElectionAdministration Fornisce informazioni su un'autorità elettorale. Da utilizzare quando l'unità report svolge il ruolo di autorità nelle elezioni.
InternationalizedName 1 InternationalizedText Il nome canonico completo e localizzato dell'unità geopolitica, non un'abbreviazione. Ad esempio, "Alaska" o "14° collegio elettorale di New York".
IsDistricted 0 o 1 boolean L'operatore booleano IsDistricted può essere utilizzato in vari modi. Non è strettamente necessario perché è possibile identificare i distretti in base al relativo sottoelemento Type. Puoi anche esaminare l'elemento secondario ElectoralDistrictId dell'elemento Contest, che rimanda al distretto elettorale associato al concorso. Tuttavia, se un distretto è definito ma non è collegato a un concorso o se il tipo di distretto viene assegnato a OtherType, IsDistricted è necessario per identificare GpUnit come distretto. Il valore booleano IsDistricted può essere utilizzato anche per indicare che un GpUnit definito come giurisdizione, come una città, viene utilizzato anche come distretto, ad esempio per competizioni che si svolgono in tutta la città.
IsMailOnly 0 o 1 boolean Indica se l'unità segnalante gestisce solo le elezioni per corrispondenza o per corrispondenza. Se non è presente, il valore predefinito è false.
SubUnitsReported 0 o 1 integer Numero di sottounità associate, come i distretti, che hanno completato il report.
TotalSubUnits 0 o 1 integer Numero totale di sottounità associate, come i distretti.
Type 1 ReportingUnitType

Tipo enumerato dell'unità segnalante, ad esempio stato, città, distretto o distretto.

Se il tipo di unità di reporting non è elencato nell'enumerazione ReportingUnitType, utilizza un valore Type di other e specifica il tipo di unità di reporting personalizzata in OtherType.
OtherType 0 o 1 string Utilizzato per specificare il tipo di unità geopolitica quando il valore di ReportingUnitType è other.
VotersParticipated 0 o 1 integer Il numero di elettori che hanno partecipato alle elezioni. In altre parole, quanti si sono presentati alle urne, compresi coloro che non hanno votato.
VotersRegistered 0 o 1 integer Il numero di elettori registrati che risiedono nei confini dell'unità geopolitica.

Esempi

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