GpUnit 和相关元素

地缘政治单位（简称 GpUnit）是指任何实体或虚拟的代表单位或选票/席位汇总单位。使用此实体可定义地缘政治单位（例如城市、区、管辖区或选区），以便将竞选、职位、票数或其他信息与这些地理位置相关联。

GpUnit

以下实体包含对 GpUnit 的引用：

Election、Contest 和 Office 包含对 GpUnit 元素的必需引用，该元素分别定义了选举、竞选或职位的管辖范围。
SummaryCounts 和 VoteCounts 引用 GpUnit，以将摘要或投票数与为选区或其他类型的地缘政治单位定义的 GpUnit 元素相关联。

类似 GpUnit 实体的父子关系需要保持一致。例如，所有国会选区都必须有一个父级，即州，即使某个国会选区完全位于某个县内也是如此。

属性

下表介绍了 GpUnit 的属性：

属性	是否必需？	类型	说明
`objectId`	必需	`ID`	供其他元素引用此元素的唯一内部标识符。

元素

下表介绍了 GpUnit 的元素：

元素	多样性	类型	说明
`ComposingGpUnitIds`	0 或 1	`IDREFS`	一个或多个 `GpUnit` 元素的唯一标识符。用于引用其他 `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` 中未列出报告单位类型，请使用 `other` 的 `Type`，并在 `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"
      }
    ]