Geliştirici Veri Yönergeleri

Oy kullanma bilgileri

Google Civic Information API, Voting Information Project tarafından desteklenen seçimler için kullanıcılara sandık yeri, erken oy kullanma yeri, yerel seçim yetkilisi iletişim bilgileri ve oy pusulası bilgileri gibi sivil bilgiler döndürür.

Veri Kullanılabilirliği

Geliştirici Yönergeleri

Tüm geliştiricilerin aşağıdaki yönergelere uyması gerekir:

  • API'lerin hizmet şartlarına uyun.
  • Geliştiriciler, API'yi kullanarak varsa tüm önbelleğe alma denetimi üstbilgilerine uymayı kabul eder. Önbelleğe alma denetimi üstbilgileri yoksa geliştiriciler, oy verme yerleri ve yarışma bilgileri için 24 saatten, görevdekiler ve ilçeler için 30 günden uzun süre önbelleğe almamayı kabul eder.
  • API'yi kullanan geliştiriciler, tüm kullanıcılara aynı deneyimi sunmak için her türlü çabayı göstermelidir. Askıya alma, A/B testi veya benzer denemelere izin verilmez.

  • Kullanım alanınızı etkinleştirmek için ek kotaya ihtiyacınız varsa Developer Console'da proje başına artış isteğinde bulunabilirsiniz. Ek kota tahsisi sınırlıdır ve maksimum izin verilen kotaya tabidir.

    Not: Onay süreci 1-2 ay sürer.Kota artışı taleplerinizi buna göre planlayın. 2024 başkanlık seçimleri için kota artışlarına hazırlanmak üzere Ağustos'a kadar kota isteği gönderin.

  • Civic Info API için ek kota yalnızca kullanıcılara yönelik kullanım alanlarını desteklemek için tasarlanmıştır. Kota artışı istekleri diğer kullanım alanları için kabul edilmez.

Ek Veri Kuralları

Bu verilerle çalışmak özellikle zordur. Lütfen aşağıdaki noktaları göz önünde bulundurun.

  • Seçim yetkilileri, bu verileri genellikle seçimden önceki son birkaç haftada ve hatta son birkaç günde gözden geçirir. Kullanıcıları oylama yapmadan önce tekrar kontrol etmeleri konusunda uyarmak iyi bir fikirdir.
  • Çoğu resmi feed'de sokak segmentleri bulunur. Bu, seçim görevlilerinin bir dizi adresi seçim bölgelerine ve oy verme yerlerine bağladığı anlamına gelir. Bu aralıklarda, bu adreste kayıtlı seçmenler olabilir veya olmayabilir. Sonuç olarak, Oy kullanma Bilgileri Projesi aracılığıyla resmi feed'ler sağlayan eyaletler için kayıtlı seçmen bulunmayan bir adreste başarı döndürülebilir.
  • Resmi feed sağlamayan eyaletler için yalnızca kayıtlı bir seçmenin bulunduğu adresler başarılı olarak döndürülür.
  • Bazen aynı bilgilere birden fazla kaynaktan ulaşabiliriz. Yerel seçim yetkilisi iletişim bilgileri ve oy pusulası bilgileri için en yüksek kaliteli bilgileri sunuyoruz. Bu davranışı geçersiz kılmak için officialSourcesOnly parametresini kullanarak resmi olmayan kaynakları ortadan kaldırmak dışında bir yöntem yoktur. Oy kullanma yeri bilgileri için her zaman resmi veri kaynaklarına diğer kaynaklara göre öncelik veririz.
  • Veri kalitesi sorunları tespit edersek sorun çözülene kadar belirli bir seçim bölgesi için veri döndürmeme seçeneği sunabiliriz.
  • Bir adresle ilgili verilerimiz yoksa bu, o adreste oy kullanmaya kayıtlı kimse olmadığı anlamına gelmez. Uygulamalar, kullanıcıları tam bilgi için yerel seçim yetkililerine yönlendirmelidir.
  • Seçimlerin geçerlilik süresi, seçim gününden sonra otomatik olarak dolar. Bu tarihten sonra seçimle ilgili veri döndürülmez.

İlişkilendirme

Civic Information API ile ilişkilendirme isteğe bağlıdır. Bir geliştirici, Civic Information API ile ilişkilendirmeyi ve kullanıcıları Civic Information API hakkında daha fazla bilgiye yönlendirmeyi seçerse geliştiricilerin aşağıdaki ilişkilendirme dili seçeneklerinden birini ve aşağıda bağlantısı verilen web sayfasını kullanması gerekir:

  • "Civic Information API tarafından desteklenmektedir"
  • "Civic Information API tarafından desteklenen oy kullanma bilgileri"
  • "Civic Information API tarafından desteklenen oy pusulası bilgileri"
  • "Daha fazla bilgi"

Durum Kodları

voterInfoQuery çağrıları, bir adres kabul edildiğinde success olarak ayarlanan bir status alanı içerir. Diğer durumlarda bir hata kodu döndürülür. Hata kodlarıyla ilgili yaygın açıklamalar aşağıda verilmiştir. Hata kodu olsa bile bilgi döndürülebileceğini unutmayın.

Durum Açıklama
success İstenen adres, API tarafından geçerli bir adres olarak tanınmalıdır.
noStreetSegmentFound API'de şu anda bu adresin hangi seçim bölgesine ve/veya ilçeye ait olduğuyla ilgili bilgi yok. Hâlâ yeni verileri kaynak olarak kullanıyor veya işliyor olabiliriz ya da bu adreste oy kullanmaya kaydolan seçmen yoktur.
addressUnparseable İstenen adres doğru biçimlendirilmemiş veya coğrafi kodlanamıyor (yani Google Haritalar API'si bu adres hakkında hiçbir şey bilmiyor).
noAddressParameter Adres sağlanmadı.
multipleStreetSegmentsFound API, belirtilen adresle ilgili bilgi bulamıyor ancak yakınlardaki adreslerle ilgili bilgi var. Kullanıcı, daha fazla bilgi için seçim yetkilisiyle iletişime geçmelidir.
electionOver İstenen seçim sona erdi. Seçim için API sonuçları artık kullanılamıyor. Yaklaşan bir seçimin kimliğini bulmak için electionQuery oluşturun.
electionUnknown İstenen seçim kimliği geçersiz. Geçerli bir kimlik bulmak için electionQuery oluşturun.
internalLookupFailure İstek işlenirken belirtilmemiş bir hata oluştu.