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 unità geopolitiche come città, distretti, giurisdizioni o sezioni elettorali per associare concorsi, uffici, conteggi dei 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 la giurisdizione dell'elezione, della competizione o della carica rispettivamente.
  • SummaryCounts e VoteCounts fanno riferimento a GpUnit per collegare il riepilogo dei voti o i conteggi dei voti agli elementi GpUnit definiti per i distretti elettorali 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 unico genitore, ovvero uno stato, anche se un determinato distretto congressuale è interamente contenuto in una contea.

Attributi

La tabella seguente descrive gli attributi per GpUnit:

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 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 padre GpUnit. Ogni elemento a cui viene fatto riferimento deve essere definito per un'unità geopolitica contenuta nell'elemento GpUnit principale.

Utilizza l'elemento ComposingGpUnitIds per rappresentare solo gli elementi secondari diretti di quel particolare GpUnit. Ad esempio, se i distretti A e B si trovano nella città M e la città M si trova nella contea X, allora elenca i distretti A e B come elementi secondari della città M. Quindi la città M è un elemento secondario della contea X, ma non rendere i distretti A e B elementi secondari 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 un Type di other e fornisci il tipo personalizzato in OtherType.

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

Conteggi riepilogativi delle schede elettorali, ad esempio voti in eccesso, voti mancanti e totale delle schede elettorali. Possono essere suddivisi in base al tipo di dispositivo e alla classe di voto.

GpUnit include SummaryCounts per fornire i conteggi riepilogativi per la geografia geopolitica corrispondente.

ReportingUnit

Utilizza ReportingUnit per definire un'unità geopolitica come stato, città, comune o distretto con l'enumerazione 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 all'autorità elettorale.

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

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

Elementi

La tabella seguente descrive gli elementi per ReportingUnit:

Elemento Molteplicità Tipo Descrizione
AuthorityIds 0 o 1 IDREFS Il objectId di uno o più elementi Person che descrivono un'autorità responsabile dell'unità di reporting.
ContactInformation 0 o 1 ContactInformation Associa i dati di contatto all'unità di segnalazione, ad esempio un indirizzo di un centro di voto.
CountStatus 0 o più CountStatus Fornisce vari stati di conteggio per diversi tipi di schede elettorali o altri elementi.
ElectionAdministration 0 o 1 ElectionAdministration Fornisce informazioni su un'autorità elettorale. Utilizza questa opzione quando l'unità di segnalazione funge da autorità nelle elezioni.
InternationalizedName 1 InternationalizedText Il nome canonico completo e localizzato dell'unità geopolitica, non un'abbreviazione. Ad esempio, "Alaska" o "14° distretto congressuale di New York".
IsDistricted 0 o 1 boolean Il valore booleano IsDistricted può essere utilizzato in diversi modi. Non è strettamente necessario perché è possibile identificare i distretti tramite il relativo elemento secondario Type. Puoi anche esaminare l'elemento Contest e il relativo sottoelemento ElectoralDistrictId, che rimanda al collegio elettorale associato alla competizione. Tuttavia, se viene definito un distretto, ma non è collegato a un concorso, o se il tipo di distretto viene fornito con OtherType, allora IsDistricted è necessario per identificare GpUnit come distretto. Il valore booleano IsDistricted può essere utilizzato anche per indicare che una GpUnit definita come giurisdizione, ad esempio una città, viene utilizzata anche come distretto, ad esempio per concorsi a livello cittadino.
IsMailOnly 0 o 1 boolean Indica se l'unità di segnalazione gestisce solo le elezioni con voto per corrispondenza o in assenza. Se non è presente, il valore predefinito è false.
SubUnitsReported 0 o 1 integer Numero di unità secondarie associate, ad esempio i distretti, che hanno completato la segnalazione.
TotalSubUnits 0 o 1 integer Numero totale di subunità associate, ad esempio i distretti.
Type 1 ReportingUnitType

Tipo enumerato dell'unità di reporting, ad esempio stato, città, distretto o collegio elettorale.

Se il tipo di unità di reporting non è elencato nell'enumerazione ReportingUnitType, utilizza un Type di other e fornisci il tipo di unità di reporting personalizzato 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. ovvero quanti si sono presentati ai seggi, compresi quelli che non hanno votato.
VotersRegistered 0 o 1 integer Il numero di elettori registrati che risiedono all'interno dei 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"
      }
    ]