GpUnit và các phần tử liên quan

Một đơn vị địa chính trị, hoặc GpUnit, mô tả bất kỳ đơn vị thực hoặc ảo nào của số phiếu đại diện hoặc phiếu bầu/tổng hợp ghế ngồi. Sử dụng thực thể này để xác định địa chính trị như thành phố, quận, khu vực tài phán hoặc khu vực để liên kết cuộc tranh cử, chức vụ, số phiếu bầu hoặc thông tin khác về các khu vực địa lý đó.

GpUnit

Các thực thể sau chứa thông tin tham chiếu đến GpUnit:

  • Election! ContestOffice chứa tệp tham chiếu bắt buộc thành phần tử GpUnit, xác định khu vực tài phán của cuộc bầu cử, cuộc thi hoặc văn phòng tương ứng.
  • SummaryCountsVoteCounts tham khảo GpUnit để liên kết bản tóm tắt hoặc số phiếu bầu cho GpUnit phần tử được xác định cho khu vực hoặc các loại đơn vị địa chính trị khác.

Mối quan hệ mẹ con cho các thực thể GpUnit tương tự cần phải là nhất quán. Ví dụ: tất cả các địa hạt bầu cử đều phải có một cha/mẹ, là một tiểu bang, ngay cả khi một hạt bầu cử cụ thể là hoàn toàn nằm trong hạt.

Thuộc tính

Bảng sau đây mô tả các thuộc tính của GpUnit:

Thuộc tính Bắt buộc? Loại Mô tả
objectId Bắt buộc ID Giá trị nhận dạng nội bộ duy nhất được các phần tử khác dùng để tham chiếu phần tử này.

Thành phần

Bảng sau đây mô tả các phần tử cho GpUnit:

Phần tử Số bội Loại Mô tả
ComposingGpUnitIds 0 hoặc 1 IDREFS

Giá trị nhận dạng duy nhất của một hoặc nhiều phần tử GpUnit. Đã dùng để tham chiếu đến các phần tử GpUnit khác và liên kết chúng với phần tử mẹ GpUnit. Bạn phải xác định từng phần tử được tham chiếu cho một đơn vị địa chính trị nằm trong thư mục mẹ Phần tử GpUnit.

Sử dụng phần tử ComposingGpUnitIds để chỉ biểu thị phần tử con trực tiếp của GpUnit cụ thể đó. Ví dụ: nếu các Khu vực A và B nằm trong Thành phố M và Thành phố M thuộc Hạt X, thì liệt kê các Khu A và B là con của Thành phố M. Khi đó Thành phố M là con thuộc Hạt X, nhưng không lấy các Khu vực A và B là con của Hạt X.

ExternalIdentifiers 0 hoặc 1 ExternalIdentifiers

Liên kết một mã nhận dạng với GpUnit, chẳng hạn như của một học khu hoặc mã thành phố.

Khi bạn bao gồm ExternalIdentifiers, nếu loại không được được liệt kê trong bản liệt kê IdentifierType, sử dụng Typeother và cung cấp tuỳ chỉnh nhập vào OtherType.

Name 0 hoặc 1 string Tên của đơn vị địa chính trị.
SummaryCounts 0 trở lên SummaryCounts

Số phiếu tóm tắt phiếu bầu, chẳng hạn như số phiếu bầu cao, số phiếu không ủng hộ và tổng số phiếu phiếu bầu. Các thiết bị/phụ kiện này có thể được chia nhỏ theo loại thiết bị và phiếu bầu .

GpUnit bao gồm SummaryCounts để cung cấp số liệu tóm tắt cho khu vực địa chính trị tương ứng.

ReportingUnit

Sử dụng ReportingUnit để xác định một đơn vị địa chính trị như tiểu bang, thành phố, thị trấn, hoặc khu vực có ReportingUnitType liệt kê.

Election tham chiếu phần tử này đến xác định phạm vi địa lý của cuộc bầu cử. Trong trường hợp này, Thành phần ReportingUnit xác định phạm vi bầu cử có thể bao gồm ElectionAdministration để cung cấp thông tin liên quan đến cơ quan bầu cử.

ReportingUnit có thể là phần tử con của tối đa một ReportingUnit khác. Tuy nhiên, nếu một ReportingUnit cần có nhiều phần tử mẹ vì điều này là hợp pháp trải rộng trên các phần tử ReportingUnit mẹ, hãy liên hệ với điểm liên hệ để được hướng dẫn.

Cú pháp XML cho ReportingUnit<GpUnit xsi:type="ReportingUnit" ... />.

Thành phần

Bảng sau đây mô tả các phần tử cho ReportingUnit:

Phần tử Số bội Loại Mô tả
AuthorityIds 0 hoặc 1 IDREFS objectId của một hoặc nhiều Person các yếu tố mô tả một cơ quan có thẩm quyền chịu trách nhiệm về việc báo cáo đơn vị.
ContactInformation 0 hoặc 1 ContactInformation Liên kết thông tin liên hệ với đơn vị báo cáo, chẳng hạn như địa chỉ của một trung tâm bỏ phiếu.
CountStatus 0 trở lên CountStatus Cung cấp nhiều trạng thái đếm cho nhiều loại phiếu bầu hoặc các mục khác.
ElectionAdministration 0 hoặc 1 ElectionAdministration Cung cấp thông tin về một cơ quan bầu cử. Sử dụng phương thức này khi đơn vị báo cáo đóng vai trò là cơ quan có thẩm quyền trong cuộc bầu cử.
InternationalizedName 1 InternationalizedText Tên chính tắc, đầy đủ, đã được bản địa hoá của đơn vị địa chính trị, không phải là từ viết tắt. Ví dụ: "Alaska" hoặc "bầu cử Quốc hội lần thứ 14 của New York quận".
IsDistricted 0 hoặc 1 boolean Bạn có thể sử dụng boolean IsDistricted theo nhiều cách. Không cần thiết lắm vì có thể xác định các quận theo phần tử phụ Type. Bạn cũng có thể kiểm tra Contest là phần tử phụ ElectoralDistrictId của phần tử, liên kết cho khu vực bầu cử liên quan đến cuộc thi. Tuy nhiên, nếu một địa hạt được xác định nhưng không được liên kết từ một cuộc thi hoặc nếu loại quận được cung cấp với OtherType, sau đó IsDistricted là cần thiết để xác định GpUnit dưới dạng một quận. Giá trị boolean IsDistricted cũng có thể được dùng để biểu thị rằng GpUnit được định nghĩa là khu vực tài phán, chẳng hạn như thành phố, cũng được dùng làm quận, ví dụ: các cuộc tranh cử trên toàn thành phố.
IsMailOnly 0 hoặc 1 boolean Cho biết liệu đơn vị báo cáo chỉ xử lý qua đường bưu điện hay bầu cử bỏ phiếu vắng mặt. Nếu không có, giá trị mặc định là false.
SubUnitsReported 0 hoặc 1 integer Số lượng tiểu đơn vị được liên kết, chẳng hạn như khu, đã hoàn thành báo cáo.
TotalSubUnits 0 hoặc 1 integer Tổng số tiểu đơn vị được liên kết, chẳng hạn như khu vực.
Type 1 ReportingUnitType

Loại được liệt kê của đơn vị báo cáo, chẳng hạn như tiểu bang, thành phố, quận, hoặc khu vực.

Nếu loại đơn vị báo cáo không có trong bản liệt kê ReportingUnitType, sử dụng Type của other và cung cấp loại đơn vị báo cáo tuỳ chỉnh của bạn bằng OtherType.

OtherType 0 hoặc 1 string Dùng để chỉ định loại đơn vị địa chính trị khi giá trị của ReportingUnitTypeother.
VotersParticipated 0 hoặc 1 integer Số lượng cử tri đã tham gia bầu cử. Tức là số người đã xuất hiện tại cuộc thăm dò ý kiến, bao gồm cả những người không tham gia bỏ phiếu.
VotersRegistered 0 hoặc 1 integer Số lượng cử tri đã đăng ký cư trú trong ranh giới của đơn vị địa chính trị.

Ví dụ

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