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

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

GpUnit

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

  • Election, Contest và Office chứa một thông tin tham chiếu bắt buộc đến phần tử GpUnit. Phần tử này xác định phạm vi tài phán của cuộc bầu cử, cuộc tranh cử hoặc văn phòng tương ứng.
  • SummaryCounts và VoteCounts tham chiếu GpUnit để liên kết nội dung tóm tắt hoặc số phiếu bầu với các phần tử GpUnit được xác định cho các khu vực bầu cử hoặc các loại đơn vị địa chính trị khác.

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

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 Mã nhận dạng nội bộ duy nhất mà 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 riêng biệt của một hoặc nhiều phần tử GpUnit. Được dùng để tham chiếu đến các phần tử GpUnit khác và liên kết chúng với GpUnit mẹ. 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 phần tử GpUnit mẹ.

Chỉ sử dụng phần tử ComposingGpUnitIds để biểu thị các phần tử con trực tiếp của GpUnit cụ thể đó. Ví dụ: nếu Phường A và B nằm ở Thành phố M, còn Thành phố M nằm ở Quận X, thì hãy liệt kê Phường A và B là cấp dưới của Thành phố M. Sau đó, Thành phố M là thành phần con của Quận X, nhưng không tạo Khu vực bầu cử A và B làm thành phần con của Quận 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ư mã của quận hoặc thành phố.

Khi bạn thêm ExternalIdentifiers, nếu loại này không có trong danh sách liệt kê IdentifierType, hãy sử dụng Type của other và cung cấp loại tuỳ chỉnh của bạn trong OtherType.

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

Số liệu tóm tắt về phiếu bầu, chẳng hạn như số phiếu bầu hợp lệ, số phiếu bầu không hợp lệ và tổng số phiếu bầu. Bạn có thể chia nhỏ các chỉ số này theo loại thiết bị và loại phiếu bầu (không bắt buộc).

GpUnit bao gồm SummaryCounts để cung cấp số liệu thống kê tóm tắt cho khu vực địa lý đị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 bầu cử bằng phép liệt kê ReportingUnitType.

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

Một 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 nhiều phần tử mẹ vì phần tử đó trải rộng trên nhiều phần tử ReportingUnit mẹ, hãy liên hệ với đầu mối liên hệ của bạn tại Google để được hướng dẫn.

Cú pháp XML cho ReportingUnit là <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 phần tử Person mô tả một cơ quan chịu trách nhiệm về đơn vị báo cáo.
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 kiểm phiếu cho các 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 thông tin 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 đầy đủ, chuẩn hoá và đã bản địa hoá của đơn vị địa lý chính trị, không phải tên viết tắt. Ví dụ: "Alaska" hoặc "Quận bầu cử thứ 14 của New York".
IsDistricted 0 hoặc 1 boolean Bạn có thể sử dụng giá trị boolean IsDistricted theo nhiều cách. Không nhất thiết phải có vì bạn có thể xác định các quận bằng phần tử phụ Type. Bạn cũng có thể kiểm tra phần tử phụ ElectoralDistrictId của phần tử Contest. Phần tử này liên kết đến khu vực bầu cử liên quan đến cuộc thi. Tuy nhiên, nếu một quận đượ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 đưa ra bằng OtherType, thì bạn cần phải dùng IsDistricted để xác định GpUnit là một quận. Bạn cũng có thể dùng giá trị boolean IsDistricted để biểu thị rằng GpUnit được xác định là một 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ụ: đối với các cuộc thi 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ý các cuộc bầu cử bỏ phiếu qua thư hoặc bỏ phiếu vắng mặt hay không. Nếu không có, giá trị mặc định sẽ là false.
SubUnitsReported 0 hoặc 1 integer Số lượng đơn vị phụ có liên quan (chẳng hạn như khu vực bầu cử) đã hoàn tất báo cáo.
TotalSubUnits 0 hoặc 1 integer Tổng số đơn vị phụ được liên kết, chẳng hạn như khu vực bầu 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 bầu cử.

Nếu loại đơn vị báo cáo không có trong quá trình liệt kê ReportingUnitType, hãy 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 trong OtherType.
OtherType 0 hoặc 1 string Dùng để chỉ định loại đơn vị địa chính trị khi giá trị của ReportingUnitType là other.
VotersParticipated 0 hoặc 1 integer Số lượng cử tri đã tham gia bầu cử. Tức là số người đã đến điểm bỏ phiếu, bao gồm cả những người không bỏ phiếu.
VotersRegistered 0 hoặc 1 integer Số lượng cử tri đã đăng ký cư trú trong phạm vi 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"
      }
    ]