Dokumen ini berisi spesifikasi untuk data yang diperlukan untuk Google untuk menyediakan informasi lokasi pemungutan suara dan kandidat Pemilu berbasis tanda pengenal nasional. Dokumen ini merupakan draf spesifikasi terutama ditujukan untuk mengumpulkan masukan dan dapat berubah di masa mendatang.
Tabel
Kumpulan tabel berikut harus disediakan secara terpisah dipisahkan tab value (TSV). Setiap file harus dimulai dengan satu {i>header <i}yang mencantumkan isian untuk tabel tersebut. Kolom header opsional tidak perlu disertakan jika tidak ada data untuk kolom tersebut. Baris berikutnya dalam file berisi baris data dengan kolom dalam urutan yang sama seperti yang ditentukan dalam baris {i>header<i}.
File-file tersebut harus diberi nama dengan tepat dan dibundel di dalam {i>zip<i} arsip. File harus diberi nama: pemilih.tsv, votingGroups.tsv, distriks.tsv, pollingLocations.tsv, kandidat.tsv, kantor.tsv.
Kecuali dinyatakan lain, setiap isian yang ditunjukkan dalam spesifikasi ini sebuah {i>string<i}. File TSV tidak memerlukan pengapian karakter untuk koma atau karakter selain tab. Karena tab tidak sesuai untuk {i>field<i} di salah satu tabel, kami secara eksplisit tidak mengizinkannya untuk berada di lapangan.
* digunakan untuk menunjukkan kolom yang wajib diisi dalam tabel
** digunakan untuk menunjukkan isian wajib
yang juga merupakan kunci utama untuk
tabel tersebut (dua baris tidak boleh memiliki nilai yang sama untuk kolom ini)
Æ menunjukkan kolom yang harus diinternasionalkan.
Internasionalisasi
Untuk memastikan bahwa data disajikan dalam bahasa yang benar beberapa isian di baris {i>header<i} perlu menyertakan spesifikasi lokalitas. Karena beberapa negara memiliki lebih dari satu data bahasa yang disediakan dalam lebih dari satu bahasa. Untuk negara-negara tersebut, kolom dapat berupa diulang dengan bahasa lokal yang berbeda yang ditambahkan ke akhir kolom dan dipisahkan dengan tanda hubung, misalnya PartyAffiliation-id.
Untuk membuat lokalitas, lihat halaman Google API di ID untuk Bahasa, Negara, Mata Uang, dan Zona Waktu. Spesifikasi ini bergantung pada Praktik Terbaik Saat Ini 47 - Tag untuk Mengidentifikasi Bahasa (BCP 47). Lihat Lampiran A dari BCP 47 untuk contoh tag bahasa.
Tabel 1 - Tabel Pemilih (Wajib)
NationalVoterId**, VoterGroupId
Baris dalam tabel pemilih mewakili satu pemilih. Setiap pemilih di negara memiliki Tanda Pengenal Nasional atau Kartu Pemilih, ini disimpan di NationalPemilihId. PemilihGroupId menunjukkan grup pemungutan suara mana pemilih.
Catatan: Di negara yang tidak memiliki kelompok pemungutan suara yang logis, PemilihGroupId dapat berupa nomor Pemilih Nasional, yang dalam hal ini tabel kelompok pemungutan suara (Tabel 2) akan secara langsung menugaskan pemilih ID distrik dan ID lokasi pemungutan suara.
Tabel 2 - Tabel Grup Pemungutan Suara (Wajib)
VoterGroupId**, PollingLocationId*, ProvinceDistrictId,
CountyDistrictId, LocalityDistrictId
Baris dalam tabel ini menunjukkan grup pemungutan suara, di mana grup tersebut suara (melalui PollingLocationId), dan distrik mana yang memberikan suara perusahaan tersebut. Setiap kelompok yang memberikan suara diidentifikasi secara unik oleh IDGrup Pemilih. Beberapa ID distrik dapat ditentukan sejak kelompok pemilih dapat memilih pejabat lain di tingkat yang berbeda pemerintah. Misalnya, di AS orang dapat memilih gubernur di tingkat negara bagian, eksekutif county di tingkat county, dan wali kota di tingkat kota.
Catatan: Setiap orang dalam kelompok yang memberikan suara harus memberi suara pada kontes yang sama dan di lokasi pemungutan suara yang sama. J kelompok pemungutan suara harus dibagi menjadi beberapa kelompok pemberian suara jika tidak demikian.
Tabel 3 - Tabel Distrik (Wajib)
DistrictId**, AuthorityName*, LocalElectionOfficialName*,
LocalElectionOfficialPhone*, LocalElectionUrl*,
LocalElectionOfficialEmail, LocalElectionOfficialAddress
Setiap baris dalam tabel distrik berisi data distrik pemungutan suara termasuk informasi petugas pemilu lokal. Nama otoritas harus menyertakan nama distrik jika sesuai, mis. Distrik Columbia.
Tabel 4 - Lokasi Pemungutan Suara (Wajib)
PollingLocationId**, Address*Æ, Latitude, Longitude,
HoursOfOperationÆ, AdditionalDirectionsÆ,
ContactInfoÆ
Setiap lokasi pemungutan suara diwakili oleh satu baris di lokasi pemungutan suara tabel sementara. Bidang alamat harus berisi string dengan alamat tertentu untuk lokasi pemungutan suara. Alamat dapat digunakan untuk memberikan link peta agar alamat yang dipetakan secara akurat di situs web geografis ideal. Jika alamat yang dapat dipetakan tidak memungkinkan, informasi akan diberikan kepada pengguna dalam bentuk teks. Lintang dan Bujur adalah kolom opsional yang berisi lintang geodetik dan bujur. Menyediakan lintang dan bujur memberikan informasi informasi untuk kesalahan saat memeriksa hasil lokasi pemungutan suara.
Kolom AdditionalDirections bersifat opsional dan dapat berisi rute yang diperlukan untuk menemukan tempat pemungutan suara, di dalam gedung yang ditentukan oleh alamat. Kolom ContactInfo harus berisi informasi yang diperlukan untuk menghubungi jabat yang bertanggung jawab atas hal ini lokasi pemungutan suara.
Tabel 5 - Tabel Kandidat (Wajib)
CandidateId**, CandidateName*Æ,
PartyAffiliationÆ, OfficeId*, Url,
CampaignAddressÆ, Photo, Phone, TwitterHandle,
FacebookUsername, Email, YoutubeChannel
Setiap baris dalam tabel kandidat mewakili seorang kandidat. CandidateId secara unik mengidentifikasi kandidat. Isian {i>office <i}berisi nama dari jabatan yang dilamar oleh kandidat ini. Kolom lain dalam yang menyediakan informasi tentang kandidat tersebut.
Tabel 6 - Meja Kantor
OfficeId**, DistrictId*, NameÆ, TermÆ,
DescriptionÆ
Setiap kantor memiliki baris dalam tabel ini yang diidentifikasi secara unik oleh ID kantor. Nama dan deskripsi kantor juga disertakan. Kolom DistrictId harus menentukan salah satu ID Distrik yang tercantum kolom ProvinceDistrictId, CountyDistrictId, atau LocalityDistrictId di tabel Grup Pemungutan Suara. Untuk jabatan yang dipilih oleh semua orang pemilih, ALL harus digunakan sebagai ID Distrik.
Contoh
Contoh Header File Data Lokasi Polling
File: pemilih.tsv
{i>Header<i}:
NationalVoterId VoterGroupId
File: votingGroups.tsv
{i>Header<i}:
VoterGroupId PollingLocationId
File: pollingLocations.tsv
{i>Header<i}:
PollingLocationId Address HoursOfOperation
Contoh Header File Multibahasa
Jika sebuah negara memiliki beberapa bahasa, {i>header<i} untuk setiap file mungkin memiliki kolom tambahan yang menunjukkan bahasa/lokalitas data yang disertakan di bidang tersebut. Hanya {i>field<i} yang ditandai dengan kemampuan internasionalisasi, yaitu, dengan penanda Æ, deskripsi tabel di atas harus memiliki lokalitas ditambahkan.
File: pollingLocations.tsv
{i>Header<i}:
PollingLocationId Address HoursOfOperation-en HoursOfOperation-fr
Contoh sederhana ini menunjukkan bidang jam operasional dalam bahasa Inggris dan Prancis.