GpUnit 和相關元素

地緣政治單位 (或 GpUnit) 是指任何實體或虛擬的代表單位，或是選票/席次彙整單位。使用這個實體定義城市、區、管轄區或選區等地緣政治單位，將競選、辦公室、票數或其他資訊與這些地理位置建立關聯。

GpUnit

下列實體包含對 GpUnit 的參照：

  • Election、Contest 和 Office 必須參照 GpUnit 元素，分別定義選舉、競選或職位的管轄範圍。
  • SummaryCounts 和 VoteCounts 參照 GpUnit，將摘要或票數連結至為選區或其他地緣政治單位定義的 GpUnit 元素。

類似 GpUnit 實體的父子關係必須一致。舉例來說，即使特定國會選區完全位於某個郡內，所有國會選區都必須有單一上層，也就是州。

屬性

下表說明 GpUnit 的屬性：

屬性 是否必要？ 類型 說明
objectId 必填 ID 其他元素用來參照這個元素的專屬內部 ID。

元素

下表說明 GpUnit 的元素：

元素 多重性 類型 說明
ComposingGpUnitIds 0 或 1 IDREFS

一或多個 GpUnit 元素的專屬 ID。用於參照其他 GpUnit 元素，並將這些元素與父項 GpUnit 建立關聯。每個參照元素都必須為母項 GpUnit 元素所含的地緣政治單元定義。

使用 ComposingGpUnitIds 元素，只代表特定 GpUnit 的直接子項。舉例來說，如果 A 和 B 區位於 M 市，而 M 市位於 X 縣，請將 A 和 B 區列為 M 市的子項。然後城市 M 是郡 X 的子項，但不要將選區 A 和 B 設為郡 X 的子項。
ExternalIdentifiers 0 或 1 ExternalIdentifiers

將 ID 與 GpUnit 建立關聯，例如區或市的代碼。

如果加入 ExternalIdentifiers，但類型未列於列舉 IdentifierType 中，請使用 Type 的 other，並在 OtherType 中提供自訂類型。
Name 0 或 1 string 地緣政治單位的名稱。
SummaryCounts 0 個以上 SummaryCounts

選票摘要計數，例如多餘票數、不足票數和選票總數。您也可以選擇依裝置類型和選票類別細分資料。

GpUnit 包含 SummaryCounts，可提供相應地緣政治地理區域的摘要計數。

ReportingUnit

使用 ReportingUnit 定義地緣政治單位，例如州、城市、鄉鎮或選區，並搭配 ReportingUnitType 列舉。

Election 會參照這個元素，以識別選舉的地理範圍。在本例中，定義選舉範圍的 ReportingUnit 元素可以包含 ElectionAdministration，以提供選舉主管機關相關資訊。

一個 ReportingUnit 最多只能是另一個 ReportingUnit 的子項。 不過，如果 ReportingUnit 確實需要多個父項，因為它跨越多個父項 ReportingUnit 元素，請與 Google 聯絡窗口聯絡以取得指引。

ReportingUnit 的 XML 語法為 <GpUnit xsi:type="ReportingUnit" ... />。

元素

下表說明 ReportingUnit 的元素：

元素 多重性 類型 說明
AuthorityIds 0 或 1 IDREFS 一或多個 Person 元素的 objectId，用於說明負責回報單位的授權。
ContactInformation 0 或 1 ContactInformation 將聯絡資訊與回報單位建立關聯，例如投票所地址。
CountStatus 0 個以上 CountStatus 提供不同類型選票或其他項目的各種計票狀態。
ElectionAdministration 0 或 1 ElectionAdministration 提供選舉主管機關的相關資訊。如果報表單位是選舉的主管機關，請使用這個選項。
InternationalizedName 1 InternationalizedText 地緣政治單位的完整正規名稱 (本地化)，不得使用縮寫。例如「阿拉斯加」或「紐約州第 14 國會選區」。
IsDistricted 0 或 1 boolean IsDistricted 布林值有多種用途。 這並非嚴格必要，因為可以透過 Type 子元素識別區域。您也可以檢查 Contest 元素的 ElectoralDistrictId 子元素，該元素會連結至與競選活動相關的選區。不過，如果已定義行政區，但未從競賽連結，或如果行政區類型是透過 OtherType 提供，則必須使用 IsDistricted 將 GpUnit 識別為行政區。IsDistricted 布林值也可表示定義為管轄區 (例如城市) 的 GpUnit 也用做區域，例如全市競賽。
IsMailOnly 0 或 1 boolean 指出回報單位是否只處理郵寄或缺席選票選舉。如未提供，則預設值為 false。
SubUnitsReported 0 或 1 integer 已完成回報的相關子單位 (例如選區) 數量。
TotalSubUnits 0 或 1 integer 相關子單位的總數，例如選區。
Type 1 ReportingUnitType

列舉的報告單位類型，例如州、城市、區或選區。

如果列舉 ReportingUnitType 中未列出報表單位類型，請使用 Type 的 other，並在 OtherType 中提供自訂報表單位類型。
OtherType 0 或 1 string 當 ReportingUnitType 的值為 other 時，用來指定地緣政治單位的類型。
VotersParticipated 0 或 1 integer 參與選舉的選民人數。也就是說，有多少人前往投票所，包括未投票者。
VotersRegistered 0 或 1 integer 居住在該地緣政治單元境內的登記選民人數。

範例

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