GpUnit y elementos relacionados

Una unidad geopolítica, o GpUnit, describe cualquier unidad física o virtual de representación o agregación de votos o bancas. Usa esta entidad para definir unidades geopolíticas, como ciudades, distritos, jurisdicciones o precintos, y asociar concursos, oficinas, recuentos de votos o cualquier otra información con esas ubicaciones geográficas.

GpUnit

Las siguientes entidades contienen referencias a GpUnit:

  • Election, Contest y Office contienen una referencia obligatoria a un elemento GpUnit, que define la jurisdicción de la elección, la contienda o el cargo, respectivamente.
  • SummaryCounts y VoteCounts hacen referencia a GpUnit para vincular el resumen o los recuentos de votos a los elementos GpUnit que se definen para los distritos electorales o para otros tipos de unidades geopolíticas.

Las relaciones entre entidades principales y secundarias para entidades GpUnit similares deben ser coherentes. Por ejemplo, todos los distritos electorales deben tener una sola entidad superior, que es un estado, incluso si un distrito electoral en particular está completamente contenido dentro de un condado.

Atributos

En la siguiente tabla, se describen los atributos de GpUnit:

Atributo ¿Es obligatorio? Tipo Descripción
objectId Obligatorio ID Es el identificador interno único que usan otros elementos para hacer referencia a este.

Elementos

En la siguiente tabla, se describen los elementos de GpUnit:

Elemento Multiplicidad Tipo Descripción
ComposingGpUnitIds 0 o 1 IDREFS

Es el identificador único de uno o más elementos GpUnit. Se usa para hacer referencia a otros elementos GpUnit y asociarlos con el elemento GpUnit principal. Cada elemento al que se hace referencia debe definirse para una unidad geopolítica que esté contenida dentro del elemento GpUnit principal.

Usa el elemento ComposingGpUnitIds para representar solo los elementos secundarios directos de ese GpUnit en particular. Por ejemplo, si los distritos electorales A y B se encuentran en la ciudad M, y la ciudad M se encuentra en el condado X, entonces enumera los distritos electorales A y B como secundarios de la ciudad M. Luego, la ciudad M es secundaria del condado X, pero no hagas que los distritos electorales A y B sean secundarios del condado X.
ExternalIdentifiers 0 o 1 ExternalIdentifiers

Asocia un ID con el GpUnit, como el código de un distrito o una ciudad.

Cuando incluyas ExternalIdentifiers, si el tipo no aparece en la enumeración IdentifierType, usa un Type de other y proporciona tu tipo personalizado en OtherType.

Name 0 o 1 string Nombre de la unidad geopolítica.
SummaryCounts 0 o más SummaryCounts

Recuentos de resúmenes de votos, como los votos en exceso, los votos insuficientes y el total de votos Opcionalmente, se pueden desglosar por tipo de dispositivo y clase de boleta.

GpUnit incluye SummaryCounts para proporcionar recuentos de resumen de la geografía geopolítica correspondiente.

ReportingUnit

Usa ReportingUnit para definir una unidad geopolítica, como un estado, una ciudad, un municipio o un distrito electoral, con la enumeración ReportingUnitType.

Election hace referencia a este elemento para identificar el alcance geográfico de la elección. En este caso, el elemento ReportingUnit que define el alcance de la elección puede incluir ElectionAdministration para proporcionar información relacionada con la autoridad electoral.

Un ReportingUnit puede ser hijo de, como máximo, otro ReportingUnit. Sin embargo, si un ReportingUnit necesita varios elementos principales porque abarca legítimamente varios elementos ReportingUnit principales, comunícate con tu punto de contacto de Google para obtener orientación.

La sintaxis XML para ReportingUnit es <GpUnit xsi:type="ReportingUnit" ... />.

Elementos

En la siguiente tabla, se describen los elementos de ReportingUnit:

Elemento Multiplicidad Tipo Descripción
AuthorityIds 0 o 1 IDREFS Es el objectId de uno o más elementos Person que describen una autoridad responsable de la unidad de informes.
ContactInformation 0 o 1 ContactInformation Asocia la información de contacto con la unidad de informes, como la dirección de un centro de votación.
CountStatus 0 o más CountStatus Proporciona varios estados de recuento para diferentes tipos de votos o otros elementos.
ElectionAdministration 0 o 1 ElectionAdministration Proporciona información sobre una autoridad electoral. Usa esta opción cuando la unidad de informe sea la autoridad en la elección.
InternationalizedName 1 InternationalizedText Nombre canónico completo y localizado de la unidad geopolítica, no una abreviatura. Por ejemplo, "Alaska" o "Distrito electoral 14 de Nueva York".
IsDistricted 0 o 1 boolean El valor booleano IsDistricted se puede usar de varias maneras. No es estrictamente necesario porque es posible identificar los distritos por su subelemento Type. También puedes examinar el subelemento ElectoralDistrictId del elemento Contest, que vincula al distrito electoral asociado con la contienda. Sin embargo, si se define un distrito, pero no se vincula desde un concurso, o si el tipo de distrito se proporciona con OtherType, entonces IsDistricted es necesario para identificar GpUnit como distrito. El valor booleano IsDistricted<br> también se puede usar para indicar que un GpUnit definido como<br> jurisdicción, como una ciudad, también se usa como distrito, por ejemplo, para<br> concursos a nivel de la ciudad.
IsMailOnly 0 o 1 boolean Indica si la unidad de informes solo maneja elecciones por correo o con boletas de voto ausente. Si no está presente, el valor predeterminado es false.
SubUnitsReported 0 o 1 integer Cantidad de subunidades asociadas, como los distritos electorales, que completaron el informe.
TotalSubUnits 0 o 1 integer Es la cantidad total de subunidades asociadas, como los distritos electorales.
Type 1 ReportingUnitType

Es el tipo enumerado de la unidad de informes, como estado, ciudad, distrito o circunscripción electoral.

Si el tipo de unidad de informes no aparece en la enumeración ReportingUnitType, usa un Type de other y proporciona tu tipo de unidad de informes personalizado en OtherType.
OtherType 0 o 1 string Se usa para especificar el tipo de unidad geopolítica cuando el valor de ReportingUnitType es other.
VotersParticipated 0 o 1 integer Es la cantidad de votantes que participaron en la elección. Es decir, cuántas personas se presentaron en las urnas, incluidas las que no votaron.
VotersRegistered 0 o 1 integer Es la cantidad de votantes registrados que residen dentro de los límites de la unidad geopolítica.

Ejemplos

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