GpUnit und zugehörige Elemente

Eine geopolitische Einheit oder GpUnit beschreibt eine physische oder virtuelle Einheit der Darstellung oder der Aggregation von Stimmen/Sitzen. Mit dieser Entität können Sie geopolitische Einheiten wie Städte, Bezirke, Gerichtsbarkeiten oder Wahlbezirke definieren, um Wahlen, Ämter, Stimmenzahlen oder andere Informationen mit diesen geografischen Einheiten zu verknüpfen.

GpUnit

Die folgenden Einheiten enthalten Verweise auf GpUnit:

  • Election, Contest und Office enthalten einen erforderlichen Verweis auf ein GpUnit-Element, das die Gerichtsbarkeit der Wahl, des Wettbewerbs oder des Amtes definiert.
  • SummaryCounts und VoteCounts verweisen auf GpUnit, um Zusammenfassungen oder Stimmenzahlen mit GpUnit-Elementen zu verknüpfen, die für Wahlbezirke oder andere Arten von geopolitischen Einheiten definiert sind.

Die Beziehungen zwischen übergeordneten und untergeordneten GpUnit-Einheiten müssen konsistent sein. Beispielsweise müssen alle Kongresswahlbezirke ein einzelnes übergeordnetes Element haben, nämlich einen Bundesstaat, auch wenn ein bestimmter Kongresswahlbezirk vollständig in einem County liegt.

Attribute

In der folgenden Tabelle werden die Attribute für GpUnit beschrieben:

Attribut Erforderlich? Typ Beschreibung
objectId Erforderlich ID Eindeutige interne Kennung, die von anderen Elementen verwendet wird, um auf dieses Element zu verweisen.

Elemente

In der folgenden Tabelle werden die Elemente für GpUnit beschrieben:

Element Multiplizität Typ Beschreibung
ComposingGpUnitIds 0 oder 1 IDREFS

Eindeutige Kennung für ein oder mehrere GpUnit-Elemente. Wird verwendet, um auf andere GpUnit-Elemente zu verweisen und sie dem übergeordneten GpUnit-Element zuzuordnen. Jedes referenzierte Element muss für eine geopolitische Einheit definiert werden, die im übergeordneten GpUnit-Element enthalten ist.

Verwenden Sie das ComposingGpUnitIds-Element, um nur direkte untergeordnete Elemente des jeweiligen GpUnit darzustellen. Wenn beispielsweise die Wahlbezirke A und B in der Stadt M liegen und die Stadt M im Bezirk X liegt, listen Sie die Wahlbezirke A und B als untergeordnete Elemente der Stadt M auf. Dann ist City M ein untergeordnetes Element von County X, aber Precincts A und B sind nicht untergeordnete Elemente von County X.
ExternalIdentifiers 0 oder 1 ExternalIdentifiers

Verknüpft eine ID mit der GpUnit, z. B. den Code eines Bezirks oder einer Stadt.

Wenn Sie ExternalIdentifiers einfügen und der Typ nicht in der Aufzählung IdentifierType aufgeführt ist, verwenden Sie Type mit dem Wert other und geben Sie Ihren benutzerdefinierten Typ in OtherType an.

Name 0 oder 1 string Name der geopolitischen Einheit.
SummaryCounts 0 oder mehr SummaryCounts

Zusammenfassungszahlen für Stimmzettel, z. B. zu viele Stimmen, zu wenige Stimmen und Gesamtzahl der Stimmzettel. Sie können optional nach Gerätetyp und Wahlzettelklasse aufgeschlüsselt werden.

GpUnit enthält SummaryCounts, um zusammenfassende Anzahlwerte für die entsprechende geopolitische geografische Einheit bereitzustellen.

ReportingUnit

Verwenden Sie ReportingUnit, um eine geopolitische Einheit wie Bundesstaat, Stadt, Gemeinde oder Bezirk mit der Aufzählung ReportingUnitType zu definieren.

Election verweist auf dieses Element, um den geografischen Umfang der Wahl zu ermitteln. In diesem Fall kann das ReportingUnit-Element, das den Umfang der Wahl definiert, ElectionAdministration enthalten, um Informationen zur Wahlbehörde bereitzustellen.

Ein ReportingUnit kann höchstens ein untergeordnetes Element eines anderen ReportingUnit sein. Wenn ein ReportingUnit jedoch mehrere Eltern benötigt, weil es sich tatsächlich über mehrere übergeordnete ReportingUnit-Elemente erstreckt, wenden Sie sich an Ihren Google-Ansprechpartner.

Die XML-Syntax für ReportingUnit ist <GpUnit xsi:type="ReportingUnit" ... />.

Elemente

In der folgenden Tabelle werden die Elemente für ReportingUnit beschrieben:

Element Multiplizität Typ Beschreibung
AuthorityIds 0 oder 1 IDREFS Die objectId eines oder mehrerer Person-Elemente, die eine für die Meldeeinheit zuständige Behörde beschreiben.
ContactInformation 0 oder 1 ContactInformation Ordnet der Meldeeinheit Kontaktdaten zu, z. B. die Adresse eines Wahllokals.
CountStatus 0 oder mehr CountStatus Bietet verschiedene Zählstatus für unterschiedliche Arten von Stimmzetteln oder anderen Elementen.
ElectionAdministration 0 oder 1 ElectionAdministration Bietet Informationen zu einer Wahlbehörde. Verwenden Sie diese Option, wenn die Berichtseinheit als Autorität bei der Wahl fungiert.
InternationalizedName 1 InternationalizedText Der lokalisierte, vollständige, kanonische Name der geopolitischen Einheit, nicht eine Abkürzung. Beispiele: „Alaska“ oder „14. Kongresswahlbezirk von New York“.
IsDistricted 0 oder 1 boolean Der boolesche Wert IsDistricted kann auf verschiedene Arten verwendet werden. Es ist nicht unbedingt erforderlich, da Bezirke anhand ihres Type-Unterelements identifiziert werden können. Sie können auch das Unterelement ElectoralDistrictId des Elements Contest untersuchen, das mit dem Wahlbezirk verknüpft ist, der mit dem Wettbewerb in Verbindung steht. Wenn jedoch ein Bezirk definiert, aber nicht mit einem Wettbewerb verknüpft ist oder der Typ des Bezirks mit OtherType angegeben wird, ist IsDistricted erforderlich, um GpUnit als Bezirk zu identifizieren. Mit dem booleschen Wert IsDistricted kann auch angegeben werden, dass eine GpUnit, die als Gerichtsbarkeit wie eine Stadt definiert ist, auch als Bezirk verwendet wird, z. B. für stadtweite Wettbewerbe.
IsMailOnly 0 oder 1 boolean Gibt an, ob die Berichtseinheit nur Wahlen mit Briefwahl oder Abwesenheitswahl durchführt. Wenn nicht vorhanden, ist der Standardwert false.
SubUnitsReported 0 oder 1 integer Anzahl der zugehörigen Untereinheiten, z. B. Wahlbezirke, für die Berichte erstellt wurden.
TotalSubUnits 0 oder 1 integer Gesamtzahl der zugehörigen Untereinheiten wie Bezirke.
Type 1 ReportingUnitType

Aufzählbarer Typ der Berichtseinheit, z. B. Bundesstaat, Stadt, Bezirk oder Wahlbezirk.

Wenn der Typ der Berichtseinheit nicht in der Aufzählung ReportingUnitType aufgeführt ist, verwenden Sie Type mit dem Wert other und geben Sie den benutzerdefinierten Typ der Berichtseinheit in OtherType an.
OtherType 0 oder 1 string Wird verwendet, um den Typ der geopolitischen Einheit anzugeben, wenn der Wert von ReportingUnitType other ist.
VotersParticipated 0 oder 1 integer Die Anzahl der Wähler, die an der Wahl teilgenommen haben. Das heißt, wie viele Personen an den Wahlen teilgenommen haben, einschließlich derjenigen, die keine Stimmzettel abgegeben haben.
VotersRegistered 0 oder 1 integer Die Anzahl der registrierten Wähler, die innerhalb der Grenzen der geopolitischen Einheit leben.

Beispiele

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