GpUnit 및 관련 요소

지정학적 단위(GpUnit)는 표현 또는 투표/의석 집계의 물리적 또는 가상 단위를 설명합니다. 이 엔티티를 사용하여 도시, 지역, 관할 구역 또는 선거구와 같은 지정학적 단위를 정의하여 선거, 사무실, 득표수 또는 기타 정보를 이러한 지리와 연결합니다.

GpUnit

다음 항목에는 GpUnit에 대한 참조가 포함되어 있습니다.

  • Election, Contest, Office에는 각각 선거, 경연, 직책의 관할권을 정의하는 GpUnit 요소에 대한 필수 참조가 포함됩니다.
  • SummaryCounts 및 VoteCounts은 GpUnit를 참조하여 요약 또는 투표 수를 선거구 또는 기타 유형의 지정학적 단위에 정의된 GpUnit 요소에 연결합니다.

유사한 GpUnit 항목의 상위-하위 관계는 일관되어야 합니다. 예를 들어 특정 하원 의원 선거구가 카운티 내에 완전히 포함되어 있더라도 모든 하원 의원 선거구에는 주라는 단일 상위 항목이 있어야 합니다.

속성

다음 표에서는 GpUnit의 속성을 설명합니다.

속성 필수 여부 유형 설명
objectId 필수 ID 다른 요소가 이 요소를 참조하는 데 사용하는 고유 내부 식별자입니다.

요소

다음 표에서는 GpUnit의 요소를 설명합니다.

요소 다중성 유형 설명
ComposingGpUnitIds 0 또는 1 IDREFS

하나 이상의 GpUnit 요소의 고유 식별자입니다. 다른 GpUnit 요소를 참조하고 상위 GpUnit와 연결하는 데 사용됩니다. 참조된 각 요소는 상위 GpUnit 요소 내에 포함된 지정학적 단위에 대해 정의되어야 합니다.

ComposingGpUnitIds 요소를 사용하여 특정 GpUnit의 직접 하위 요소만 나타냅니다. 예를 들어 선거구 A와 B가 도시 M에 있고 도시 M이 카운티 X에 있는 경우 선거구 A와 B를 도시 M의 하위 항목으로 나열합니다. 그러면 City M은 County X의 하위 요소가 되지만 Precincts A와 B는 County 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은(는) 최대 하나의 다른 ReportingUnit의 하위 요소일 수 있습니다. 하지만 ReportingUnit가 부모 ReportingUnit 요소에 걸쳐 있어 여러 부모가 필요한 경우 Google 담당자에게 문의하여 안내를 받으세요.

ReportingUnit의 XML 구문은 <GpUnit xsi:type="ReportingUnit" ... />입니다.

요소

다음 표에서는 ReportingUnit의 요소를 설명합니다.

요소 다중성 유형 설명
AuthorityIds 0 또는 1 IDREFS 보고 단위의 책임을 지는 기관을 설명하는 하나 이상의 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에 나열되지 않은 경우 other의 Type를 사용하고 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"
      }
    ]