GpUnit dan elemen terkait

Unit geopolitik, atau GpUnit, menjelaskan unit fisik atau virtual dari representasi atau penggabungan suara/jabatan. Gunakan entity ini untuk mendefinisikan geopolitik unit seperti kota, distrik, wilayah hukum, atau kawasan untuk dikaitkan kontes, kantor, jumlah suara, atau informasi lain dengan wilayah geografis tersebut.

GpUnit

Entity berikut berisi referensi ke GpUnit:

  • Election, Contest, dan Office berisi referensi yang diperlukan ke elemen GpUnit, yang mendefinisikan wilayah hukum pemilu, kontes, atau jabatan.
  • SummaryCounts dan VoteCounts merujuk 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 seluruhnya yang ada 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 sebagai referensi 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. Bekas untuk mereferensikan elemen GpUnit lainnya dan mengaitkannya dengan GpUnit induk. Setiap elemen yang direferensikan harus ditentukan untuk unit geopolitik yang tercakup dalam induk Elemen GpUnit.

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 County X, maka mencantumkan Presinct A dan B sebagai turunan Kota M. Maka Kota M adalah turunan dari County X, tetapi tidak menjadikan Precinct A dan B sebagai turunan dari County X

ExternalIdentifiers 0 atau 1 ExternalIdentifiers

Mengaitkan ID dengan GpUnit, seperti distrik atau kode kota.

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

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

Jumlah ringkasan balot, seperti suara berlebih, suara kurang, dan total surat suara. Opsi ini dapat dikelompokkan berdasarkan jenis perangkat dan balot .

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

ReportingUnit

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

Election mereferensikan elemen ini ke mengidentifikasi ruang lingkup geografis pemilu. Dalam hal ini, Elemen ReportingUnit yang menentukan cakupan pemilu dapat mencakup ElectionAdministration untuk memberikan informasi terkait otoritas pemilu.

ReportingUnit dapat berupa turunan dari, maksimum, satu ReportingUnit lainnya. Namun, jika ReportingUnit memerlukan beberapa induk karena hal tersebut sah mencakup di seluruh elemen ReportingUnit induk, jangkau titik Google Anda kontak 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 Person elemen yang mendeskripsikan otoritas yang bertanggung jawab atas pelaporan unit iklan.
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 metode ini saat unit pelaporan berfungsi sebagai otoritas dalam pemilu.
InternationalizedName 1 InternationalizedText Nama kanonis yang dilokalkan, lengkap, dan resmi dari unit geopolitik, bukan nama singkatan. Misalnya, "Alaska" atau "kongres ke-14 New York distrik sekolah".
IsDistricted 0 atau 1 boolean Boolean IsDistricted dapat digunakan dalam beberapa cara. Hal ini tidak mutlak diperlukan karena memungkinkan identifikasi distrik oleh sub-elemen Type. Anda juga dapat memeriksa Contest sub-elemen ElectoralDistrictId elemen, yang menautkan di wilayah pemilu yang terkait dengan kontes tersebut. Namun, jika distrik ditentukan tetapi tidak terkait dengan kontes, atau jika jenis distrik diberikan dengan OtherType, lalu 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 pengiriman atau ketidakhadiran surat suara. Jika tidak ada, nilai defaultnya adalah false.
SubUnitsReported 0 atau 1 integer Jumlah subunit terkait, seperti kawasan, yang telah selesai 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 di OtherType.

OtherType 0 atau 1 string Digunakan untuk menentukan jenis satuan geopolitik ketika nilai ReportingUnitType adalah other.
VotersParticipated 0 atau 1 integer Jumlah pemilih yang telah berpartisipasi dalam pemilu. Yaitu, berapa banyak yang telah hadir di pemungutan suara, termasuk yang tidak memberikan suara.
VotersRegistered 0 atau 1 integer Jumlah pemilih terdaftar yang bertempat tinggal di dalam wilayah 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"
      }
    ]