計數

Counts 不會直接使用或參照。而是僅做為下列實體的擴充功能基礎：

Counts 可依裝置特性、選票類型或手寫票篩選票數。您也可以將計數連結至已定義的GpUnit實體，例如國家/地區。

元素

下表說明 Counts 的元素：

元素 多重性 類型 說明
GpUnitId 0 或 1 IDREF GpUnit 元素的專屬 ID。用於將計數與地緣政治單位建立關聯，例如選區、縣/市或鄉鎮。
IsSuppressedForPrivacy 0 或 1 boolean 指出是否為了保護投票者隱私而隱藏票數。如未提供，則預設值為 false。
Type 0 或 1 CountItemType

用來篩選票數的計票類型，例如選舉當天或提早投票。

如果 Count 項目的類型未列於 CountItemType 列舉中，請將 Type 設為 other，並在 OtherType 中加入自訂類型。
OtherType 0 或 1 string 當 Type 為 other 時，用來指定要計算的項目。

SummaryCounts

使用 SummaryCounts 代表整個競賽或地緣政治單位的摘要計數。

SummaryCounts 包含 Counts 做為擴充功能基礎，因此會從 Counts 繼承元素。不過，SummaryCounts 並非 Counts 的類型，而是直接包含在 Contest 和 GpUnit 中。

SummaryCounts 可用於提供與 Contest 相關聯的各種計數的地理範圍摘要，例如總票數、總過度投票數、總未投票數和手寫票數。SummaryCounts 可視需要參照為較低層級報表單元定義的 GpUnit 元素。這樣一來，您就能將摘要計數與競賽範圍內的其他低層級報表單位建立關聯。

SummaryCounts 也可用來提供特定 GpUnit 的摘要計數。舉例來說，為國家/地區定義的 GpUnit 可以包含 SummaryCounts，以提供摘要計數。SummaryCounts (本例) 不包含 Counts 中的 GpUnitId 元素。

在 Counts 中，如果計數項目的類型未列於列舉 CountItemType 中，請使用 other，並在 OtherType 中加入自訂類型。

元素

下表說明 SummaryCounts 的元素：

元素 多重性 類型 說明
BallotsCast 0 或 1 integer 投票數。
BallotsOutstanding 0 或 1 integer 尚未計票的選票數量。
BallotsRejected 0 或 1 integer 遭拒的選票數。
Overvotes 0 或 1 integer 過度投票次數。
Undervotes 0 或 1 integer 不喜歡票數。
WriteIns 0 或 1 integer 手寫票數。

範例

XML

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

JSON

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

VoteCounts

使用 VoteCounts 說明 BallotSelection 在 Contest 中的得票數。

元素

下表說明 VoteCounts 的元素：

元素 多重性 類型 說明
Count 0 或 1 float

投票數，介於 0 到 100 之間。在特殊情況下，計數可能包含分數成分。舉例來說，請將 14.2% 報表為 14.2，而非 0.142。

如需支援的票數類型清單，請參閱「結果製表類型」。

範例

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