カウント

Counts は直接使用または参照されません。代わりに、次のエンティティの拡張ベースとしてのみ使用されます。

  • SummaryCounts: Contest と地政学的単位（GpUnit）の投票数の概要をレポートするために使用されます。
  • VoteCounts: Contest の投票数をレポートするために使用されます。

Counts を使用すると、デバイスの特性や投票用紙の種類、手書きの投票の種類で投票数をフィルタできます。また、国などの定義された GpUnit エンティティにカウントをリンクすることもできます。

要素

次の表に、Counts の要素を示します。

要素 重複 タイプ 説明
GpUnitId 0 または 1 IDREF GpUnit 要素の一意の識別子。カウントを地政学的な単位（区、郡、町など）に関連付けるために使用されます。
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

Contest で BallotSelection の投票数を記述するには、VoteCounts を使用します。

要素

次の表に、VoteCounts の要素を示します。

要素 重複 タイプ 説明
Count 0 または 1 float

コンテストの投票数（0 ～ 100 の数値）。特別なケースでは、カウントに小数部分を含めることができます。たとえば、14.2% を 0.142 ではなく 14.2 としてレポートします。

サポートされている投票数の種類の一覧については、結果集計タイプをご覧ください。

例

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