GpUnit 및 관련 요소

지정학적 단위(GpUnit)는 실제 또는 가상 대표 또는 투표/의석 집계 단위를 설명합니다. 이 항목을 사용하여 시, 지구, 관할권 또는 구역과 같은 지정학적 단위를 정의하여 해당 지역과 대회, 사무실, 투표수 또는 기타 정보를 연결합니다.

GpUnit

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

  • Election, ContestOffice에는 각각 선거, 콘테스트 또는 공직의 관할권을 정의하는 GpUnit 요소의 필수 참조가 포함되어 있습니다.
  • SummaryCountsVoteCountsGpUnit를 참조하여 요약 또는 투표수를 관할구나 다른 유형의 지정학적 단위에 정의된 GpUnit 요소에 연결합니다.

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

특성

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

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

요소

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

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

하나 이상의 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에 나열되지 않으면 otherType를 사용하고 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에 나열되지 않은 경우 otherType를 사용하고 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"
      }
    ]