Tổng số

Counts không được sử dụng hoặc tham chiếu trực tiếp. Thay vào đó, nó chỉ được dùng làm cơ sở mở rộng cho các thực thể sau:

  • SummaryCounts: Dùng để báo cáo về số phiếu bầu tóm tắt của Contest và đơn vị địa chính trị (GpUnit).
  • VoteCounts: Dùng để báo cáo số phiếu bầu Contest.

Counts cho phép bạn lọc số phiếu bầu theo đặc điểm của thiết bị hoặc theo loại phiếu bầu hoặc phiếu ghi tên. Bạn cũng có thể liên kết số lượt truy cập với một thực thể GpUnit được xác định, chẳng hạn như một quốc gia.

Thành phần

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

Phần tử Số bội Loại Mô tả
GpUnitId 0 hoặc 1 IDREF Giá trị nhận dạng duy nhất cho một phần tử GpUnit. Được dùng để liên kết số lượng với một đơn vị địa chính trị, chẳng hạn như khu vực bầu cử, hạt hoặc thị trấn.
IsSuppressedForPrivacy 0 hoặc 1 boolean Cho biết liệu phiếu bầu có bị ẩn hay không để đảm bảo quyền riêng tư của cử tri. Nếu không có thuộc tính này, giá trị mặc định sẽ là false.
Type 0 hoặc 1 CountItemType

Loại số phiếu được dùng làm bộ lọc cho số phiếu bầu, chẳng hạn như ngày bầu cử hoặc bỏ phiếu sớm.

Nếu loại cho một mục Count không có trong phép liệt kê CountItemType, hãy đặt Type thành other và thêm loại tuỳ chỉnh vào OtherType.
OtherType 0 hoặc 1 string Được dùng khi Type là other để chỉ định nội dung đang được tính.

SummaryCounts

Sử dụng SummaryCounts để biểu thị số lượng tóm tắt trên toàn cuộc thi hoặc trên toàn đơn vị địa chính trị.

SummaryCounts bao gồm Counts làm cơ sở mở rộng và do đó kế thừa các phần tử từ Counts. Tuy nhiên, SummaryCounts không phải là một loại Counts, mà được đưa vào trực tiếp cho Contest và GpUnit.

Bạn có thể dùng SummaryCounts để cung cấp thông tin tóm tắt trên phạm vi địa lý về các số liệu khác liên quan đến Contest, chẳng hạn như tổng số phiếu bầu, tổng số phiếu bầu quá mức, phiếu bầu không hợp lệ và phiếu bầu viết tay. SummaryCounts có thể tuỳ ý tham chiếu đến các phần tử GpUnit được xác định cho các đơn vị báo cáo cấp thấp hơn. Nhờ đó, bạn có thể liên kết số lượng tóm tắt với các đơn vị báo cáo cấp thấp khác trong phạm vi của cuộc thi.

Bạn cũng có thể sử dụng SummaryCounts để cung cấp số lượng tóm tắt dành riêng cho một GpUnit. Ví dụ: GpUnit được xác định cho một quốc gia có thể bao gồm SummaryCounts để cung cấp số lượng tóm tắt. SummaryCounts, trong trường hợp này, không bao gồm phần tử GpUnitId trong Counts.

Trong Counts, nếu loại mục đếm không có trong quá trình liệt kê CountItemType, hãy sử dụng other và thêm loại tuỳ chỉnh vào OtherType.

Thành phần

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

Phần tử Số bội Loại Mô tả
BallotsCast 0 hoặc 1 integer Số lượng phiếu bầu đã bỏ.
BallotsOutstanding 0 hoặc 1 integer Số phiếu bầu chưa được kiểm.
BallotsRejected 0 hoặc 1 integer Số lượng phiếu bầu bị từ chối.
Overvotes 0 hoặc 1 integer Số lượt bỏ phiếu quá mức.
Undervotes 0 hoặc 1 integer Số phiếu bầu không hợp lệ.
WriteIns 0 hoặc 1 integer Số lượng phiếu bầu viết tay.

Ví dụ

XML

    <SummaryCounts>
      <BallotsCast>2089540</BallotsCast>
      <WriteIns>2087</WriteIns>
    </SummaryCounts>

JSON

    "SummaryCounts": [
      {
        "BallotsCast": "2089540",
        "WriteIns": "2087"
      }
    ]

VoteCounts

Dùng VoteCounts để mô tả số phiếu bầu cho BallotSelection trong Contest.

Thành phần

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

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

Số phiếu bầu đã bỏ trong cuộc thi, là một số từ 0 đến 100. Trong các trường hợp đặc biệt, số lượng có thể bao gồm một thành phần phân số. Ví dụ: báo cáo 14,2% dưới dạng 14.2 chứ không phải 0,142.

Để biết danh sách các loại số phiếu được hỗ trợ, hãy xem phần Các loại bảng kết quả.

Ví dụ

XML

    <VoteCounts>
      <GpUnitId>ru_001</GpUnitId>
      <Type>total</Type>
      <Count>6173433</Count>
    </VoteCounts>
    <VoteCounts>
      <GpUnitId>ru_001</GpUnitId>
      <Type>other</Type>
      <OtherType>projected-vote-percent</OtherType>
      <Count>22.3</Count>
    </VoteCounts>

JSON

    "VoteCounts": [
      {
        "GpUnitId": "ru_001",
        "Type": "total",
        "Count": "6173433"
      },
      {
        "GpUnitId": "ru_001",
        "Type": "other",
        "OtherType": "projected-vote-percent",
        "Count": "22.3"
      }
    ]