GpUnit i powiązane elementy

Jednostka geopolityczna, czyli GpUnit, to dowolna fizyczna lub wirtualna jednostka reprezentacji albo agregacji głosów lub mandatów. Użyj tego elementu, aby zdefiniować jednostki geopolityczne, takie jak miasta, okręgi, jurysdykcje lub obwody, i powiązać z nimi konkursy, urzędy, liczbę głosów lub inne informacje.

GpUnit

Te podmioty zawierają odniesienia do GpUnit:

  • Elementy Election, Contest i Office zawierają wymagane odwołanie do elementu GpUnit, który określa odpowiednio jurysdykcję wyborów, konkursu lub urzędu.
  • SummaryCounts i VoteCounts odwołują się do GpUnitpodsumowania linków lub liczby głosów w przypadku GpUnitelementów zdefiniowanych dla okręgów wyborczych lub innych typów jednostek geopolitycznych.

Relacje nadrzędności i podrzędności podobnych GpUnit podmiotów muszą być spójne. Na przykład wszystkie okręgi wyborcze muszą mieć jednego elementu nadrzędnego, czyli stan, nawet jeśli dany okręg wyborczy w całości znajduje się w hrabstwie.

Atrybuty

W tabeli poniżej opisano atrybuty GpUnit:

Atrybut Wymagany? Typ Opis
objectId Wymagane ID Unikalny identyfikator wewnętrzny używany przez inne elementy do odwoływania się do tego elementu.

Elementy

W tabeli poniżej opisano elementy GpUnit:

Element Mnogość Typ Opis
ComposingGpUnitIds 0 lub 1 IDREFS

Unikalny identyfikator co najmniej jednego elementu GpUnit. Używany do odwoływania się do innych elementów GpUnit i powiązywania ich z elementem nadrzędnym GpUnit. Każdy element, do którego się odwołujesz, musi być zdefiniowany dla jednostki geopolitycznej zawartej w nadrzędnym elemencie GpUnit.

Używaj elementu ComposingGpUnitIds tylko do reprezentowania bezpośrednich elementów podrzędnych danego elementu GpUnit. Na przykład jeśli okręgi A i B znajdują się w mieście M, a miasto M znajduje się w hrabstwie X, to okręgi A i B są podrzędne względem miasta M. Miasto M jest wtedy elementem podrzędnym wobec hrabstwa X, ale nie przypisuj okręgów A i B jako elementów podrzędnych hrabstwa X.
ExternalIdentifiers 0 lub 1 ExternalIdentifiers

Łączy identyfikator z GpUnit, np. kodem okręgu lub miasta.

Jeśli podasz ExternalIdentifiers, a rodzaj nie jest wymieniony w wyliczeniu IdentifierType, użyj wartości Type równej other i podaj własny rodzaj w atrybucie OtherType.

Name 0 lub 1 string Nazwa jednostki geopolitycznej.
SummaryCounts 0 lub więcej SummaryCounts

Podsumowanie głosów, np. liczba głosów nieważnych, głosów nieoddanych i łączna liczba głosów. Opcjonalnie można je podzielić według typu urządzenia i klasy karty do głosowania.

GpUnit zawiera SummaryCounts, aby podać podsumowanie liczby dla odpowiedniego obszaru geopolitycznego.

ReportingUnit

Użyj elementu ReportingUnit, aby zdefiniować jednostkę geopolityczną, np. stan, miasto, gminę lub okręg, za pomocą wyliczenia ReportingUnitType.

Element Election odnosi się do tego elementu, aby określić zasięg geograficzny wyborów. W tym przypadku element ReportingUnit, który określa zakres wyborów, może zawierać element ElectionAdministration, aby podawać informacje związane z organem wyborczym.

Element ReportingUnit może być elementem podrzędnym co najwyżej jednego innego elementu ReportingUnit. Jeśli jednak element ReportingUnit wymaga wielu elementów nadrzędnych, ponieważ faktycznie obejmuje elementy nadrzędne ReportingUnit, skontaktuj się z osobą kontaktową w Google, aby uzyskać wskazówki.

Składnia XML dla ReportingUnit to <GpUnit xsi:type="ReportingUnit" ... />.

Elementy

W tabeli poniżej opisano elementy ReportingUnit:

Element Mnogość Typ Opis
AuthorityIds 0 lub 1 IDREFS objectId co najmniej 1 elementu Person, który opisuje organ odpowiedzialny za jednostkę raportującą.
ContactInformation 0 lub 1 ContactInformation Powiązanie informacji kontaktowych z jednostką raportującą, np. adresu lokalu wyborczego.
CountStatus 0 lub więcej CountStatus Zawiera różne stany zliczania dla różnych typów kart do głosowania lub innych elementów.
ElectionAdministration 0 lub 1 ElectionAdministration Zawiera informacje o organie wyborczym. Użyj tej opcji, gdy jednostka raportująca jest organem odpowiedzialnym za wybory.
InternationalizedName 1 InternationalizedText Zlokalizowana, pełna, kanoniczna nazwa jednostki geopolitycznej, a nie skrót. Na przykład „Alaska” lub „14 okręg wyborczy w Nowym Jorku”.
IsDistricted 0 lub 1 boolean Wartość logiczną IsDistricted można wykorzystać na wiele sposobów. Nie jest to bezwzględnie konieczne, ponieważ dzielnice można zidentyfikować za pomocą elementu podrzędnego Type. Możesz też sprawdzić element Contest, a w nim element podrzędny ElectoralDistrictId, który zawiera link do okręgu wyborczego powiązanego z wyborami. Jeśli jednak okręg jest zdefiniowany, ale nie jest połączony z konkursem, lub jeśli typ okręgu jest podany z wartością OtherType, wówczas wartość IsDistricted jest niezbędna do zidentyfikowania wartości GpUnit jako okręgu. Wartość logiczna IsDistricted może też oznaczać, że GpUnit zdefiniowany jako jurysdykcja, np. miasto, jest też używany jako okręg, np. w przypadku konkursów miejskich.
IsMailOnly 0 lub 1 boolean Wskazuje, czy jednostka raportująca obsługuje tylko wybory korespondencyjne lub wybory z możliwością głosowania przedterminowego. Jeśli nie podasz żadnej opcji, domyślną wartością będzie false.
SubUnitsReported 0 lub 1 integer Liczba powiązanych podjednostek, np. okręgów, które przesłały raport.
TotalSubUnits 0 lub 1 integer Łączna liczba powiązanych podjednostek, np. okręgów.
Type 1 ReportingUnitType

Typ jednostki raportującej, np. stan, miasto, okręg lub obwód.

Jeśli typ jednostki raportowania nie jest wymieniony w wyliczeniu ReportingUnitType, użyj Type other i podaj niestandardowy typ jednostki raportowania w OtherType.
OtherType 0 lub 1 string Służy do określania typu jednostki geopolitycznej, gdy wartość atrybutu ReportingUnitType to other.
VotersParticipated 0 lub 1 integer Liczba wyborców, którzy wzięli udział w wyborach. Oznacza to, że podana jest liczba osób, które pojawiły się w lokalach wyborczych, w tym tych, które nie oddały głosu.
VotersRegistered 0 lub 1 integer Liczba zarejestrowanych wyborców mieszkających na obszarze jednostki geopolitycznej.

Przykłady

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