GpUnit dan elemen terkait

Unit geopolitik, atau GpUnit, menjelaskan setiap unit representasi fisik atau virtual atau agregasi suara/tempat. Gunakan entitas ini untuk menentukan unit geopolitik seperti kota, distrik, wilayah hukum, atau kawasan untuk mengaitkan kontes, kantor, jumlah suara, atau informasi lainnya dengan wilayah geografis tersebut.

GpUnit

Entitas berikut berisi referensi ke GpUnit:

  • Election, Contest, dan Office berisi referensi yang diperlukan ke elemen GpUnit, yang menentukan wilayah hukum pemilu, kontes, atau jabatan.
  • SummaryCounts dan VoteCounts mereferensikan GpUnit untuk menautkan ringkasan atau jumlah suara ke elemen GpUnit yang ditentukan untuk wilayah atau jenis unit geopolitik lainnya.

Hubungan induk-turunan untuk entity GpUnit yang serupa harus konsisten. Misalnya, semua distrik kongres harus memiliki satu induk, yang merupakan negara bagian, meskipun distrik kongres tertentu sepenuhnya berada dalam satu wilayah.

Atribut

Tabel berikut menjelaskan atribut untuk GpUnit:

Atribut Wajib diisi? Jenis Deskripsi
objectId Wajib ID ID internal unik yang digunakan oleh elemen lain untuk mereferensikan 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 direferensikan harus ditentukan untuk unit geopolitik yang berada dalam elemen GpUnit induk.

Gunakan elemen ComposingGpUnitIds untuk hanya merepresentasikan turunan langsung dari GpUnit khusus tersebut. Misalnya, jika Kawasan A dan B berada di Kota M, dan Kota M berada di Wilayah X, maka cantumkan Kawasan A dan B sebagai turunan dari Kota M. Maka, Kota M adalah turunan dari County X, tetapi jangan menjadikan Precincts A dan B sebagai turunan dari County X.
ExternalIdentifiers 0 atau 1 ExternalIdentifiers

Mengaitkan ID dengan GpUnit, seperti kode distrik atau kota.

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

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

Jumlah ringkasan balot, seperti suara berlebih, kurang suara, dan total surat suara. Persyaratan tersebut dapat dikelompokkan berdasarkan jenis perangkat dan kelas surat suara.

GpUnit menyertakan SummaryCounts guna memberikan jumlah ringkasan untuk geografi geopolitik yang sesuai.

ReportingUnit

Gunakan ReportingUnit untuk menentukan unit geopolitik seperti negara bagian, kota besar, kota kecil, atau kawasan dengan enumerasi ReportingUnitType.

Election mereferensikan 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 berupa turunan dari, maksimal, satu ReportingUnit lainnya. Namun, jika ReportingUnit memerlukan beberapa induk karena secara sah bentang di seluruh elemen ReportingUnit induk, hubungi kontak (POC) 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 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 saat unit pelaporan berfungsi sebagai otoritas dalam pemilu.
InternationalizedName 1 InternationalizedText Nama kanonis yang dilokalkan, lengkap, dan kanonis dari unit geopolitik, bukan singkatan. Misalnya, "Alaska" atau "Distrik kongres ke-14 New York".
IsDistricted 0 atau 1 boolean Boolean IsDistricted dapat digunakan dalam beberapa cara. Hal ini tidak terlalu diperlukan karena distrik dapat diidentifikasi berdasarkan sub-elemen Type-nya. Anda juga dapat memeriksa sub-elemen ElectoralDistrictId dari elemen Contest, yang tertaut ke daerah pemilihan yang terkait dengan kontes. Namun, jika distrik ditentukan tetapi tidak ditautkan dari kontes, atau jika jenis distrik diberikan dengan OtherType, IsDistricted diperlukan untuk mengidentifikasi GpUnit sebagai distrik. Boolean IsDistricted juga dapat digunakan untuk menandakan bahwa GpUnit yang didefinisikan sebagai wilayah hukum, seperti kota, juga digunakan sebagai distrik, misalnya untuk kontes tingkat kota.
IsMailOnly 0 atau 1 boolean Menunjukkan apakah unit pelaporan hanya menangani pemilu surat suara melalui pengiriman atau ketidakhadiran. Jika tidak ada, nilai defaultnya adalah false.
SubUnitsReported 0 atau 1 integer Jumlah subunit terkait, seperti kawasan, yang telah menyelesaikan pelaporan.
TotalSubUnits 0 atau 1 integer Jumlah total subunit terkait, seperti kawasan.
Type 1 ReportingUnitType

Jenis unit pelaporan yang dihitung, seperti negara bagian, kota, distrik, atau kawasan.

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. Artinya, jumlah yang hadir di polling, termasuk mereka yang tidak memberikan suara.
VotersRegistered 0 atau 1 integer Jumlah pemilih terdaftar yang tinggal dalam batas-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"
      }
    ]