Panduan Data Developer

Informasi pemungutan suara

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

Ketersediaan Data

Panduan Developer

Kami mewajibkan semua developer untuk mematuhi panduan berikut:

  • Patuhi persyaratan layanan API.
  • Dengan menggunakan API, developer setuju untuk mematuhi header kontrol cache jika ada. Tanpa header cache-control, developer setuju untuk tidak menyimpan dalam cache 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 melakukan segala upaya untuk memastikan semua pengguna mendapatkan pengalaman yang sama. Kami tidak mengizinkan penangguhan, pengujian A/B, atau eksperimen serupa.

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

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

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

Panduan Data Tambahan

Data ini sangat sulit digunakan. Perhatikan hal-hal berikut.

  • Petugas pemilu sering merevisi data ini dalam beberapa minggu terakhir dan bahkan beberapa hari terakhir sebelum pemilu. Sebaiknya peringatkan pengguna bahwa mereka harus memeriksa kembali sebelum memberikan suara.
  • Sebagian besar feed resmi berisi segmen jalan, yang berarti petugas pemilu mengaitkan rentang alamat ke TPS dan lokasi pemungutan suara. Rentang tersebut mungkin memiliki atau 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 pesan berhasil.
  • Untuk negara bagian yang tidak menyediakan feed resmi, hanya alamat yang memiliki pemilih terdaftar yang akan menampilkan pesan berhasil.
  • Terkadang, kita akan memiliki beberapa sumber untuk informasi yang sama. Kami menyediakan informasi berkualitas tertinggi yang tersedia untuk informasi kontak resmi pemilu lokal dan informasi balot. Perilaku ini tidak dapat diganti, selain dengan menghapus sumber non-resmi melalui parameter officialSourcesOnly. Untuk informasi tempat pemungutan suara, kami selalu memprioritaskan sumber data resmi daripada sumber lain.
  • 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 memberikan suara di sana. Aplikasi harus mengarahkan pengguna ke pejabat pemilu setempat untuk mendapatkan informasi lengkap.
  • Masa berlaku 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 mengatribusikan ke Civic Information API dan menautkan pengguna ke informasi selengkapnya tentang Civic Information API, kami mewajibkan developer untuk menggunakan salah satu opsi bahasa atribusi dan halaman web berikut yang ditautkan di bawah:

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

Kode Status

Panggilan ke voterInfoQuery menyertakan 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 ada kode error.

Status Penjelasan
success Alamat yang diminta dikenali oleh API sebagai alamat yang valid.
noStreetSegmentFound API saat ini tidak memiliki informasi tentang wilayah pemilihan dan/atau distrik tempat alamat ini berada. Mungkin kami masih mencari/memproses data baru, atau tidak ada pemilih yang terdaftar untuk memberikan suara di alamat ini.
addressUnparseable Alamat yang diminta tidak diformat dengan benar atau tidak dapat digeocode (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 pejabat pemilu untuk mengetahui informasi selengkapnya.
electionOver Pemilu yang diminta telah 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.