Panduan Data Developer

Informasi pemungutan suara

Google Civic Information API menampilkan informasi kewarganegaraan seperti tempat pemungutan suara, lokasi pemungutan suara awal, informasi kontak pejabat pemilu setempat, dan informasi surat suara kepada pengguna untuk pemilu yang didukung oleh Voting Information Project.

Ketersediaan Data

Pedoman Developer

Kami mewajibkan semua developer mematuhi panduan berikut:

  • Patuhi persyaratan layanan API.
  • Dengan menggunakan API, developer setuju untuk mematuhi header cache-control jika ada. Tanpa header cache-control, developer setuju untuk tidak melakukan caching selama lebih dari 24 jam untuk lokasi pemungutan suara dan informasi kontes, serta lebih dari 30 hari untuk pemegang jabatan dan distrik.
  • Developer yang menggunakan API harus berupaya semaksimal mungkin untuk memastikan semua pengguna mendapatkan pengalaman yang sama. Kami tidak mengizinkan penahanan, pengujian A/B, atau eksperimen serupa.

  • Jika memerlukan kuota tambahan untuk mengaktifkan kasus penggunaan, Anda dapat meminta penambahan kuota per project di Konsol Developer. Penyediaan kuota tambahan terbatas dan tunduk pada alokasi maksimum.

    Catatan: Proses persetujuan memerlukan waktu 1-2 bulan.Rencanakan permintaan penambahan kuota Anda dengan tepat. Untuk bersiap menghadapi penambahan kuota pemilu presiden 2024,kirimkan permintaan kuota paling lambat bulan Agustus.

  • Kuota tambahan untuk Civic Info API hanya ditujukan untuk mendukung kasus penggunaan yang ditampilkan kepada pengguna. Permintaan penambahan kuota tidak diberikan untuk kasus penggunaan lainnya.

Panduan Data Tambahan

Data ini sangat sulit untuk dikerjakan. Perhatikan poin-poin berikut.

  • Pejabat pemilu sering merevisi data ini dalam beberapa minggu terakhir dan bahkan beberapa hari terakhir sebelum pemilu. Sebaiknya peringatkan pengguna bahwa mereka harus kembali memeriksa sebelum memberikan suara.
  • Sebagian besar feed resmi berisi segmen jalan, yang berarti petugas pemilu mengaitkan rentang alamat dengan distrik dan lokasi pemungutan suara. Rentang tersebut mungkin atau mungkin tidak memiliki pemilih yang terdaftar di alamat tersebut. Akibatnya, untuk negara bagian yang menyediakan feed resmi melalui Voting Information Project, alamat yang tidak memiliki pemilih terdaftar dapat menampilkan keberhasilan.
  • Untuk negara bagian yang tidak menyediakan feed resmi, hanya alamat yang memiliki pemilih terdaftar yang akan menampilkan keberhasilan.
  • Terkadang, kami akan memiliki beberapa sumber untuk informasi yang sama. Kami menyajikan informasi berkualitas tertinggi yang tersedia untuk informasi kontak petugas pemilu lokal dan informasi surat suara. Tidak ada cara untuk menggantikan perilaku ini, selain menghilangkan sumber tidak resmi melalui parameter officialSourcesOnly. Untuk informasi lokasi TPS, kami selalu memprioritaskan sumber data resmi daripada sumber lainnya.
  • Jika kami menemukan masalah kualitas data, kami mungkin tidak menampilkan data untuk distrik pemilihan tertentu hingga masalah tersebut diselesaikan.
  • Jika kami tidak memiliki data tentang suatu alamat, bukan berarti tidak ada orang yang terdaftar untuk memilih di sana. Aplikasi harus mengarahkan pengguna ke petugas pemilu setempat untuk mendapatkan informasi lengkap.
  • Pemilu akan otomatis berakhir setelah hari pemilu. Tidak ada data yang akan ditampilkan untuk pemilu setelah titik tersebut.

Atribusi

Atribusi ke Civic Information API bersifat opsional. Jika developer memilih untuk memberikan atribusi ke Civic Information API dan menautkan pengguna ke informasi selengkapnya tentang Civic Information API, kami mewajibkan developer menggunakan salah satu opsi bahasa atribusi dan halaman web yang ditautkan di bawah:

  • “Didukung oleh Civic Information API”
  • “Informasi pemilu didukung oleh Civic Information API”
  • “Informasi surat suara didukung oleh Civic Information API”
  • “Pelajari lebih lanjut”

Kode Status

Panggilan ke voterInfoQuery mencakup kolom status yang disetel ke success saat alamat diterima. Dalam kasus lain, kode error akan ditampilkan. Penjelasan umum untuk kode error diberikan di bawah. Perhatikan bahwa informasi dapat ditampilkan meskipun kode error ada.

Status Penjelasan
success Alamat yang diminta dikenali oleh API sebagai alamat yang valid.
noStreetSegmentFound Saat ini, API tidak memiliki informasi tentang daerah pemilihan dan/atau distrik yang menjadi bagian dari alamat ini. Mungkin kami masih mencari/memproses data baru, atau tidak ada pemilih yang telah mendaftar untuk memilih di alamat ini.
addressUnparseable Alamat yang diminta tidak diformat dengan benar atau tidak dapat di-geocode (yaitu, Google Maps API tidak mengetahui apa pun tentang alamat ini).
noAddressParameter Tidak ada alamat yang diberikan.
multipleStreetSegmentsFound API tidak dapat menemukan informasi untuk alamat yang ditentukan, tetapi memiliki informasi tentang alamat di sekitar. Pengguna harus menghubungi petugas pemilu setempat untuk mendapatkan informasi selengkapnya.
electionOver Pemilu yang diminta sudah berakhir. Hasil API untuk pemilu tidak lagi tersedia. Buat electionQuery untuk menemukan ID pemilu mendatang.
electionUnknown ID pemilu yang diminta tidak valid. Buat electionQuery untuk menemukan ID yang valid.
internalLookupFailure Terjadi error yang tidak dapat ditentukan saat memproses permintaan.