Panduan Data Developer

Geografi Politik dan Perwakilan Terpilih

Google Civic Information API menawarkan informasi tentang pembagian geografis politik dan perwakilan terpilih untuk alamat AS dari tingkat federal hingga tingkat lokal. Saat ini, cakupan kami telah mendekati 100% untuk distrik negara bagian, county, dan Kongres, serta menargetkan cakupan melebihi 90% untuk distrik legislatif negara bagian. Tingkat yang lebih rendah, seperti dewan kota dan kabupaten, dilayani dengan upaya terbaik dan akan meningkat seiring waktu.

Kami berharap memiliki informasi terkini tentang semua pejabat terpilih di tingkat federal, negara bagian, dan kabupaten, serta pejabat kota untuk kota terbesar di setiap Negara Bagian AS serta kota dengan populasi lebih dari 250.000. Kami menggabungkan data ini dari berbagai sumber dan menyajikan informasi berkualitas tertinggi yang tersedia. Jika kami menemukan masalah kualitas data, kami dapat berhenti menampilkan data untuk divisi geografis, jabatan terpilih, atau pejabat terpilih tertentu.

Informasi pemungutan suara

Google Civic Information API menampilkan informasi sipil seperti tempat pemungutan suara, lokasi pemberian 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 pedoman berikut:

  • Patuhi persyaratan layanan API.
  • Dengan menggunakan API, developer setuju untuk mematuhi header kontrol cache jika ada. Karena tidak memiliki header kontrol cache, developer setuju untuk tidak menyimpan lokasi pemungutan suara dan informasi kontes dalam cache selama lebih dari 24 jam, serta lebih dari 30 hari untuk pemegang kantor dan distrik.
  • Developer yang menggunakan API ini harus berusaha semaksimal mungkin 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 Developer Console. Penyediaan kuota tambahan dibatasi dan bergantung pada tunjangan maksimum.

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

  • Kuota tambahan untuk Civic Info API hanya dimaksudkan untuk mendukung kasus penggunaan yang dilihat pengguna. Permintaan penambahan kuota tidak diizinkan untuk kasus penggunaan lainnya.

Panduan Data Tambahan

Data ini sangat sulit untuk dikerjakan. Harap perhatikan hal-hal berikut.

  • Pejabat 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 mengikat serangkaian alamat ke wilayah dan lokasi pemungutan suara. Rentang mungkin atau mungkin tidak memiliki pemilih yang terdaftar di alamat tersebut. Akibatnya, untuk negara bagian yang menyediakan feed resmi melalui Proyek Informasi Pemungutan Suara, alamat di mana tidak ada pemilih terdaftar dapat menunjukkan keberhasilan.
  • Untuk negara bagian yang tidak menyediakan feed resmi, hanya alamat tempat pemilih terdaftar yang akan menampilkan data yang berhasil.
  • Terkadang, kita akan memiliki beberapa sumber untuk informasi yang sama. Kami menyajikan informasi berkualitas terbaik yang tersedia untuk informasi kontak pejabat pemilu lokal dan informasi surat suara. Tidak ada cara untuk mengganti perilaku ini, selain menghapus sumber tidak resmi melalui parameter resmiSourcesOnly. Untuk informasi tempat pemungutan suara, kami selalu memprioritaskan sumber data resmi daripada sumber lain.
  • Jika kami menemukan masalah kualitas data, kami mungkin tidak akan menampilkan data untuk distrik pemilu tertentu hingga masalah tersebut diatasi.
  • Jika kami tidak memiliki data tentang sebuah alamat, itu bukan berarti bahwa tidak ada seorang pun yang terdaftar untuk memberikan suara di sana. Permohonan harus mengarahkan pengguna ke petugas pemilu lokal mereka untuk mendapatkan informasi yang lengkap.
  • Pemilu otomatis berakhir setelah hari pemilu mereka. Tidak ada data yang akan ditampilkan untuk pemilu setelah tanggal 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 balot yang didukung oleh Civic Information API”
  • “Informasi representatif yang 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 ini. 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 daerah pemilihan dan/atau distrik tempat alamat ini berada. Mungkin kami masih mencari/memproses data baru, atau tidak ada pemilih yang telah mendaftar untuk memberikan suara 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 Alamat tidak diberikan.
multipleStreetSegmentsFound API tidak dapat menemukan informasi untuk alamat yang ditentukan, tetapi memiliki informasi tentang alamat di sekitar. Pengguna harus menghubungi petugas pemilu mereka untuk informasi lebih lanjut.
electionOver Pemilu yang diminta sudah berakhir. Hasil API untuk pemilu tidak lagi tersedia. Buat electionQuery untuk menemukan ID untuk pemilu mendatang.
electionUnknown Id pemilu yang diminta tidak valid. Buat electionQuery untuk menemukan ID yang valid.
internalLookupFailure Terjadi error yang tidak ditentukan saat memproses permintaan.