GpUnit

Use this entity for defining geopolitical units such as cities, districts, jurisdictions, or precincts, for the purpose of associating contests, offices, vote counts, or other information with the geographies.

Election and Contest contain a required reference to a GpUnit element defined as the jurisdiction of the election or contest respectively; Office contains a similar reference that is optional. SummaryCounts and VoteCounts reference GpUnit to link vote or summary counts to GpUnit elements defined for precincts or other types of geopolitical units. BallotStyle references GpUnit to link a ballot style to its corresponding geopolitical unit.

GpUnit includes SummaryCounts so as to provide summary counts for the corresponding geopolitical geography. ComposingGpUnitIds is used to reference other GpUnit elements and associate them with the parent GpUnit, with the rule that each referenced element must be defined for a geopolitical unit that is contained within the parent GpUnit element.

When including ExternalIdentifiers, if the type is not listed in enumeration IdentifierType, use other and include the type (that is not listed in the enumeration) in OtherType.

The table below describes the attributes for GpUnit:

Attribute Required? Type Description
objectId required ID Unique internal identifier used by other elements to reference this element.

The table below describes the elements for GpUnit:

Element Multiplicity Type Description
ComposingGpUnitIds 0 or 1 IDREFS Unique identifier for one or more GpUnit elements. For creating a reference to another GpUnit that is contained with the parent GpUnit.
ExternalIdentifiers 0 or 1 ExternalIdentifiers For associating an ID with the GpUnit, for example, a district's or city's code.
Name 0 or 1 string Name of the geopolitical unit.
SummaryCounts 0 or more SummaryCounts Ballot summary counts (overvotes, undervotes, total ballots, etc.) optionally broken down by device type and ballot class.

ReportingUnit

For defining a geopolitical unit such as state, city, township, or precinct using the ReportingUnitType enumeration.

This element optionally references Person to associate one or more individuals, for example, authorities, for the reporting unit. It also includes ContactInformation to provide contact addresses for the reporting unit, such as an address of a vote center.

Election references this element so as to identify the geographical scope of the election. In this case, the GpUnit element defined for the scope of the election may include ElectionAdministration so as to include election authority-related information.

The Type sub-element uses the ReportingUnitType enumeration to specify the type of geopolitical geography being defined. ReportingUnitType contains the most common types of geographies, for example, state, city, precinct, and so forth. If the reporting unit type is not listed in enumeration ReportingUnitType, use other and include the reporting unit type (that is not listed in the enumeration) in OtherType.

The IsDistricted boolean can be used in a number of ways. It is not strictly necessary, as it is possible to identify districts by their Type sub-element or by examining the Contest element's ElectoralDistrictId sub-element, which links to the electoral district associated with the contest. However, if a district is defined but is not linked from a contest, or if the type of district is not listed in the ReportingUnitType enumeration and therefore OtherType is used, then IsDistricted is necessary to identify the GpUnit as a district. The IsDistricted boolean can also be used to signify that a GpUnit defined as a jurisdiction, for example, a city, is also used as a district for, for example, city-wide contests.

The table below describes the elements for ReportingUnit:

Element Multiplicity Type Description
AuthorityIds 0 or 1 IDREFS The objectId of one or more Person elements describing an authority responsible for the reporting unit.
ContactInformation 0 or 1 ContactInformation For associating contact information with the reporting unit.
CountStatus 0 or more CountStatus For providing various counting status on types of ballots or other items.
ElectionAdministration 0 or 1 ElectionAdministration For use when the reporting unit serves as the authority in the election.
IsMailOnly 0 or 1 boolean Boolean to indicate whether the reporting unit handles only mail-in or absentee ballot elections, assumed to be "no" if not present.
SubUnitsReported 0 or 1 integer Number of associated subunits such as precincts that have completed reporting.
TotalSubUnits 0 or 1 integer Total number of associated subunits such as precincts.
Type 1 ReportingUnitType Enumerated type of reporting unit, for example, state, city, district, precinct, etc.
OtherType 0 or 1 string For use when ReportingUnitType value is other.
VotersParticipated 0 or 1 integer Number of voters who have participated in the election, i.e., shown up at the polls, including those who did not cast ballots.
VotersRegistered 0 or 1 integer Number of registered voters residing within the boundaries of the geopolitical unit.

Its XML syntax is: <GpUnit xsi:type="ReportingUnit" ... />

Examples

XML

    <GpUnit objectId="ru0081" xsi:type="ReportingUnit">
      <ComposingGpUnitIds>ru_wahlkreis1 ru_wahlkreis2</ComposingGpUnitIds>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>ocd-id</Type>
          <Value>ocd-division/country:de/state:hb</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <Name>Bremen</Name>
      <Type>state</Type>
    </GpUnit>

JSON

    "GpUnit": [
      {
        "@type": "ReportingUnit",
        "objectId": "ru0081",
        "ComposingGpUnitIds": [
          "ru_wahlkreis1",
          "ru_wahlkreis2"
        ],
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "ocd-id",
              "Value": "ocd-division/country:de/state:hb"
            }
          ]
        },
        "Name": "Bremen",
        "Type": "state"
      }
    ]