GpUnit dan elemen terkait

Unit geopolitik, atau GpUnit, mendeskripsikan unit fisik atau virtual representasi atau agregasi suara/kursi. Gunakan entitas ini untuk menentukan unit geopolitik seperti kota, distrik, yurisdiksi, atau daerah pemilihan untuk mengaitkan kontes, kantor, jumlah suara, atau informasi lain dengan geografi tersebut.

GpUnit

Entitas berikut berisi referensi ke GpUnit:

  • Election, Contest, dan Office berisi referensi yang diperlukan ke elemen GpUnit, yang masing-masing menentukan yurisdiksi pemilu, kompetisi, atau jabatan.
  • SummaryCounts dan VoteCounts mereferensikan GpUnit untuk menautkan ringkasan atau jumlah suara ke elemen GpUnit yang ditentukan untuk distrik pemilu atau jenis unit geopolitik lainnya.

Hubungan induk-turunan untuk entity GpUnit serupa harus konsisten. Misalnya, semua distrik kongres harus memiliki satu induk, yaitu negara bagian, meskipun distrik kongres tertentu sepenuhnya tercakup dalam suatu county.

Atribut

Tabel berikut menjelaskan atribut untuk GpUnit:

Atribut Wajib? Jenis Deskripsi
objectId Wajib ID ID internal unik yang digunakan oleh elemen lain untuk merujuk elemen ini.

Elemen

Tabel berikut menjelaskan elemen untuk GpUnit:

Elemen Keanekaragaman Jenis Deskripsi
ComposingGpUnitIds 0 atau 1 IDREFS

ID unik untuk satu atau beberapa elemen GpUnit. Digunakan untuk mereferensikan elemen GpUnit lainnya dan mengaitkannya dengan GpUnit induk. Setiap elemen yang dirujuk harus ditentukan untuk unit geopolitik yang ada dalam elemen GpUnit induk.

Gunakan elemen ComposingGpUnitIds hanya untuk merepresentasikan turunan langsung dari GpUnit tertentu tersebut. Misalnya, jika Distrik A dan B berada di Kota M, dan Kota M berada di Kabupaten X, maka cantumkan Distrik A dan B sebagai turunan Kota M. Kemudian, Kota M adalah turunan Kabupaten X, tetapi jangan jadikan Distrik A dan B turunan Kabupaten X.
ExternalIdentifiers 0 atau 1 ExternalIdentifiers

Mengaitkan ID dengan GpUnit, seperti kode distrik atau kota.

Jika Anda menyertakan ExternalIdentifiers, dan jika jenisnya tidak tercantum dalam enumerasi IdentifierType, gunakan Type other dan berikan jenis kustom Anda di OtherType.

Name 0 atau 1 string Nama unit geopolitik.
SummaryCounts 0 atau lebih SummaryCounts

Jumlah ringkasan surat suara, seperti surat suara yang memiliki lebih dari satu pilihan, surat suara yang tidak memiliki pilihan, dan total surat suara. Secara opsional, data ini dapat dikelompokkan menurut jenis perangkat dan kelas surat suara.

GpUnit mencakup SummaryCounts untuk memberikan jumlah ringkasan untuk geografi geopolitik yang sesuai.

ReportingUnit

Gunakan ReportingUnit untuk menentukan unit geopolitik seperti negara bagian, kota, kotapraja, atau distrik dengan enumerasi ReportingUnitType.

Election merujuk elemen ini untuk mengidentifikasi cakupan geografis pemilu. Dalam hal ini, elemen ReportingUnit yang menentukan cakupan pemilu dapat menyertakan ElectionAdministration untuk memberikan informasi terkait otoritas pemilu.

ReportingUnit dapat menjadi turunan dari paling banyak satu ReportingUnit lainnya. Namun, jika ReportingUnit memerlukan beberapa orang tua karena secara sah mencakup beberapa elemen ReportingUnit induk, hubungi kontak Google Anda untuk mendapatkan panduan.

Sintaksis XML untuk ReportingUnit adalah <GpUnit xsi:type="ReportingUnit" ... />.

Elemen

Tabel berikut menjelaskan elemen untuk ReportingUnit:

Elemen Keanekaragaman Jenis Deskripsi
AuthorityIds 0 atau 1 IDREFS objectId dari satu atau beberapa elemen Person yang menjelaskan otoritas yang bertanggung jawab atas unit pelaporan.
ContactInformation 0 atau 1 ContactInformation Mengaitkan informasi kontak dengan unit pelaporan, seperti alamat pusat pemungutan suara.
CountStatus 0 atau lebih CountStatus Menyediakan berbagai status penghitungan untuk berbagai jenis surat suara atau item lainnya.
ElectionAdministration 0 atau 1 ElectionAdministration Memberikan informasi tentang otoritas pemilu. Gunakan ini jika unit pelaporan berfungsi sebagai otoritas dalam pemilu.
InternationalizedName 1 InternationalizedText Nama kanonis lengkap unit geopolitik yang dilokalkan, bukan singkatan. Misalnya, "Alaska" atau "daerah pemilihan ke-14 New York".
IsDistricted 0 atau 1 boolean Boolean IsDistricted dapat digunakan dalam beberapa cara. Hal ini tidak benar-benar diperlukan karena distrik dapat diidentifikasi berdasarkan sub-elemen Type-nya. Anda juga dapat memeriksa sub-elemen ElectoralDistrictId elemen Contest, yang ditautkan ke distrik pemilihan yang terkait dengan kontes. Namun, jika distrik ditentukan tetapi tidak ditautkan dari kontes, atau jika jenis distrik diberikan dengan OtherType, maka IsDistricted diperlukan untuk mengidentifikasi GpUnit sebagai distrik. Boolean IsDistricted juga dapat digunakan untuk menandakan bahwa GpUnit yang ditentukan sebagai yurisdiksi, seperti kota, juga digunakan sebagai distrik, misalnya untuk kontes di seluruh kota.
IsMailOnly 0 atau 1 boolean Menunjukkan apakah unit pelaporan hanya menangani pemilu dengan surat suara yang dikirim melalui pos atau pemilu dengan surat suara yang tidak hadir. Jika tidak ada, nilai defaultnya adalah false.
SubUnitsReported 0 atau 1 integer Jumlah subunit terkait, seperti distrik, yang telah menyelesaikan pelaporan.
TotalSubUnits 0 atau 1 integer Jumlah total subunit terkait seperti distrik.
Type 1 ReportingUnitType

Jenis unit pelaporan yang di-enum, seperti negara bagian, kota, distrik, atau daerah pemilihan.

Jika jenis unit pelaporan tidak tercantum dalam enumerasi ReportingUnitType, gunakan Type dari other, dan berikan jenis unit pelaporan kustom Anda di OtherType.
OtherType 0 atau 1 string Digunakan untuk menentukan jenis unit geopolitik saat nilai ReportingUnitType adalah other.
VotersParticipated 0 atau 1 integer Jumlah pemilih yang telah berpartisipasi dalam pemilu. Yaitu, berapa banyak orang yang hadir di TPS, termasuk mereka yang tidak mencoblos.
VotersRegistered 0 atau 1 integer Jumlah pemilih terdaftar yang tinggal di dalam batas unit geopolitik.

Contoh

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