GpUnit と関連要素

地政学的単位（GpUnit）は、代表または投票/議席の集計の物理的または仮想的な単位を表します。このエンティティを使用して、都市、地区、管轄区域、選挙区などの地政学的な単位を定義し、コンテスト、オフィス、投票数、その他の情報をこれらの地域に関連付けます。

GpUnit

次のエンティティには GpUnit への参照が含まれています。

Election、Contest、Office には、それぞれ選挙、コンテスト、役職の管轄区域を定義する GpUnit 要素への必須の参照が含まれています。
SummaryCounts と VoteCounts は GpUnit を参照し、要約または投票数を、区または他の種類の地政学的単位に定義された GpUnit 要素にリンクします。

類似する GpUnit エンティティの親子関係は一貫している必要があります。たとえば、特定の選挙区が郡内に完全に含まれている場合でも、すべての選挙区には州という 1 つの親が必要です。

属性

次の表に、GpUnit の属性を示します。

属性	必須かどうか	型	説明
`objectId`	必須	`ID`	他の要素がこの要素を参照するために使用する一意の内部識別子。

要素

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

要素	重複	タイプ	説明
`ComposingGpUnitIds`	0 または 1	`IDREFS`	1 つ以上の `GpUnit` 要素の一意の識別子。他の `GpUnit` 要素を参照し、親 `GpUnit` に関連付けるために使用されます。参照される各要素は、親 `GpUnit` 要素に含まれる地政学的単位に対して定義する必要があります。 `ComposingGpUnitIds` 要素を使用して、特定の `GpUnit` の直接の子のみを表します。たとえば、区画 A と区画 B が市 M にあり、市 M が郡 X にある場合、区画 A と区画 B を市 M の子としてリストします。この場合、市 M は郡 X の子になりますが、区 A と区 B は郡 X の子にはなりません。
`ExternalIdentifiers`	0 または 1	`ExternalIdentifiers`	ID を `GpUnit`（地区や都市のコードなど）に関連付けます。 `ExternalIdentifiers` を含める場合、タイプが列挙型 `IdentifierType` にリストされていない場合は、`other` の `Type` を使用し、`OtherType` でカスタムタイプを指定します。
`Name`	0 または 1	`string`	地政学的な単位の名前。
`SummaryCounts`	0 以上	`SummaryCounts`	投票用紙の概要のカウント（超過投票、不足投票、投票用紙の合計など）。必要に応じて、デバイスタイプと投票クラスで分類できます。 `GpUnit` には、対応する地政学的な地理情報の概要カウントを提供する `SummaryCounts` が含まれています。

ReportingUnit

ReportingUnit を使用して、ReportingUnitType 列挙型で都道府県、市町村、区などの地政学的単位を定義します。

Election は、この要素を参照して選挙の地理的範囲を特定します。この場合、選挙の範囲を定義する ReportingUnit 要素に ElectionAdministration を含めて、選挙管理委員会関連の情報を提供できます。

ReportingUnit は、最大で 1 つの別の ReportingUnit の子にすることができます。ただし、ReportingUnit が親 ReportingUnit 要素にまたがっているため、複数の親が必要な場合は、Google の担当窓口にお問い合わせください。

ReportingUnit の XML 構文は <GpUnit xsi:type="ReportingUnit" ... /> です。

要素

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

要素	重複	タイプ	説明
`AuthorityIds`	0 または 1	`IDREFS`	報告単位を担当する機関を説明する 1 つ以上の `Person` 要素の `objectId`。
`ContactInformation`	0 または 1	`ContactInformation`	連絡先情報（投票所の住所など）を報告単位に関連付けます。
`CountStatus`	0 以上	`CountStatus`	さまざまな種類の投票用紙やその他のアイテムのさまざまなカウントステータスを提供します。
`ElectionAdministration`	0 または 1	`ElectionAdministration`	選挙管理委員会に関する情報を提供します。報告単位が選挙の権限として機能する場合に使用します。
`InternationalizedName`	1	`InternationalizedText`	地政学単位のローカライズされた完全な正規名。略称ではありません。たとえば、「アラスカ」や「ニューヨーク州第 14 連邦下院選挙区」などです。
`IsDistricted`	0 または 1	`boolean`	`IsDistricted` ブール値はさまざまな方法で使用できます。`Type` サブ要素で地区を識別できるため、厳密には必要ありません。`Contest` 要素の `ElectoralDistrictId` サブ要素を調べることもできます。このサブ要素は、コンテストに関連付けられた選挙区にリンクしています。ただし、地区が定義されているがコンテストからリンクされていない場合、または地区のタイプが `OtherType` で指定されている場合は、`GpUnit` を地区として識別するために `IsDistricted` が必要です。`IsDistricted` ブール値を使用して、市などの管轄区域として定義された `GpUnit` が、地区（市全体のコンテストなど）としても使用されることを示すこともできます。
`IsMailOnly`	0 または 1	`boolean`	報告単位が郵送投票または不在者投票のみを扱うかどうかを示します。指定されていない場合、デフォルト値は `false` です。
`SubUnitsReported`	0 または 1	`integer`	報告を完了した関連するサブユニット（区など）の数。
`TotalSubUnits`	0 または 1	`integer`	関連付けられたサブユニット（区など）の合計数。
`Type`	1	`ReportingUnitType`	州、市、区、選挙区などのレポート単位の列挙型。レポート単位のタイプが列挙型 `ReportingUnitType` にリストされていない場合は、`Type` に `other` を使用し、カスタムレポート単位のタイプを `OtherType` で指定します。
`OtherType`	0 または 1	`string`	`ReportingUnitType` の値が `other` の場合に、地政学的単位のタイプを指定するために使用されます。
`VotersParticipated`	0 または 1	`integer`	選挙に参加した投票者の数。つまり、投票所に現れた人の数です。これには、投票しなかった人も含まれます。
`VotersRegistered`	0 または 1	`integer`	地政学的単位の境界内に居住する登録有権者の数。

例

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