GpUnit e elementos relacionados

Uma unidade geopolítica, ou GpUnit, descreve qualquer unidade física ou virtual de representação ou agregação de votos/assentos. Use essa entidade para definir unidades geopolíticas, como cidades, distritos, jurisdições ou circunscrições, e associar concursos, escritórios, contagens de votos ou outras informações a essas regiões.

Observação: essa entidade é a mesma para todos os tipos de feed.

GpUnit

As seguintes entidades contêm referências a GpUnit:

• Election, Contest e Office contêm uma referência obrigatória a um elemento GpUnit, que define a jurisdição da eleição, da disputa ou do cargo, respectivamente.
• SummaryCounts e VoteCounts referenciam GpUnit para vincular o resumo do link ou a contagem de votos a elementos GpUnit definidos para distritos eleitorais ou outros tipos de unidades geopolíticas.

As relações entre parentesco de entidades GpUnit semelhantes precisam ser consistentes. Por exemplo, todos os distritos eleitorais precisam ter um único pai, que é um estado, mesmo que um distrito eleitoral específico esteja totalmente contido em um condado.

Atributos

A tabela a seguir descreve os atributos de GpUnit:

Atributo	Obrigatório?	Tipo	Descrição
objectId	Obrigatório	ID	Identificador interno exclusivo usado por outros elementos para fazer referência a este elemento.

Elementos

A tabela a seguir descreve os elementos de GpUnit:

Elemento	Multiplicidade	Tipo	Descrição
ComposingGpUnitIds	0 ou 1	IDREFS	Identificador exclusivo de um ou mais elementos GpUnit. Usado para referenciar outros elementos GpUnit e associá-los ao GpUnit principal. Cada elemento referenciado precisa ser definido para uma unidade geopolítica contida no elemento GpUnit principal. Use o elemento ComposingGpUnitIds para representar apenas filhos diretos desse GpUnit específico. Por exemplo, se as zonas eleitorais A e B estiverem na cidade M, e a cidade M estiver no condado X, liste as zonas eleitorais A e B como filhas da cidade M. Então, a cidade M é uma filha do condado X, mas não faça dos distritos A e B filhos do condado X.
ExternalIdentifiers	0 ou 1	ExternalIdentifiers	Associa um ID ao GpUnit, como o código de um distrito ou de uma cidade. Ao incluir ExternalIdentifiers, se o tipo não estiver listado na enumeração IdentifierType, use um Type de other e forneça seu tipo personalizado em OtherType.
Name	0 ou 1	string	Nome da unidade geopolítica.
SummaryCounts	0 ou mais	SummaryCounts	Resumo da contagem de cédulas, como votos em excesso, votos insuficientes e total de cédulas. Eles podem ser divididos por tipo de dispositivo e classe de cédula. O GpUnit inclui SummaryCounts para fornecer contagens de resumo da região geopolítica correspondente.

ReportingUnit

Use ReportingUnit para definir uma unidade geopolítica, como estado, cidade, município ou distrito, com a enumeração ReportingUnitType.

Observação: esse elemento é o mesmo para todos os tipos de feed.

Election faz referência a esse elemento para identificar o escopo geográfico da eleição. Nesse caso, o elemento ReportingUnit que define o escopo da eleição pode incluir ElectionAdministration para fornecer informações relacionadas à autoridade eleitoral.

Observação:o seguinte se aplica a qualquer ExternalIdentifiers de um ReportingUnit:

• Um identificador estável é obrigatório.
• É necessário um identificador canônico do Open Civic Data Identifiers. Forneça um Type de ocd-id e um Value extraído da lista de identificadores canônicos de dados cívicos abertos.

Um ReportingUnit pode ser filho de, no máximo, outro ReportingUnit. No entanto, se um ReportingUnit precisar de vários elementos pai porque se estende legitimamente por elementos pai ReportingUnit, entre em contato com seu ponto de contato do Google para receber orientação.

A sintaxe XML para ReportingUnit é <GpUnit xsi:type="ReportingUnit" ... />.

Elementos

A tabela a seguir descreve os elementos de ReportingUnit:

Elemento	Multiplicidade	Tipo	Descrição
AuthorityIds	0 ou 1	IDREFS	O objectId de um ou mais elementos Person que descrevem uma autoridade responsável pela unidade de relatórios.
ContactInformation	0 ou 1	ContactInformation	Associa informações de contato à unidade de relatório, como o endereço de um centro de votação.
CountStatus	0 ou mais	CountStatus	Fornece vários status de contagem para diferentes tipos de cédulas ou outros itens.
ElectionAdministration	0 ou 1	ElectionAdministration	Fornece informações sobre uma autoridade eleitoral. Use isso quando a unidade de relatórios for a autoridade na eleição.
InternationalizedName	1	InternationalizedText	O nome completo, localizado e canônico da unidade geopolítica, não uma abreviação. Por exemplo, "Alasca" ou "14º distrito congressional de Nova York".
IsDistricted	0 ou 1	boolean	O booleano IsDistricted pode ser usado de várias maneiras. Não é estritamente necessário porque é possível identificar distritos pelo subelemento Type. Também é possível examinar o subelemento ElectoralDistrictId do elemento Contest, que vincula ao distrito eleitoral associado ao concurso. No entanto, se um distrito for definido, mas não vinculado a uma disputa, ou se o tipo de distrito for fornecido com OtherType, IsDistricted será necessário para identificar o GpUnit como um distrito. O booleano IsDistricted também pode ser usado para indicar que um GpUnit definido como uma jurisdição, como uma cidade, também é usado como um distrito, por exemplo, em concursos em toda a cidade.
IsMailOnly	0 ou 1	boolean	Indica se a unidade de relatórios processa apenas eleições por voto por correio ou ausente. Se não estiver presente, o valor padrão será false.
SubUnitsReported	0 ou 1	integer	Número de subunidades associadas, como distritos eleitorais, que concluíram a geração de relatórios.
TotalSubUnits	0 ou 1	integer	Número total de subunidades associadas, como distritos eleitorais.
Type	1	ReportingUnitType	Tipo enumerado da unidade de relatório, como estado, cidade, distrito ou circunscrição. Se o tipo de unidade de relatórios não estiver listado na enumeração ReportingUnitType, use um Type de other e forneça seu tipo de unidade de relatórios personalizada em OtherType.
OtherType	0 ou 1	string	Usado para especificar o tipo de unidade geopolítica quando o valor de ReportingUnitType é other.
VotersParticipated	0 ou 1	integer	O número de eleitores que participaram da eleição. Ou seja, quantas pessoas compareceram às urnas, incluindo aquelas que não votaram.
VotersRegistered	0 ou 1	integer	O número de eleitores registrados que residem nos limites da unidade geopolítica.

Exemplos

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