Geliştirici Veri Yönergeleri

Oy verme bilgileri

Google Civic Information API, Voting Information Project tarafından desteklenen seçimlerde kullanıcılara sandık yeri, erken oy kullanma yeri, yerel seçim yetkilisi iletişim bilgileri ve oy pusulası bilgileri gibi kamu hizmetiyle ilgili 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'ler Hizmet Şartları'na uymak
  • Geliştiriciler, API'yi kullanarak varsa tüm cache-control üstbilgilerine uymayı kabul eder. Önbellek kontrolü üstbilgileri yoksa geliştiriciler, oylama yerleri ve yarışma bilgileri için 24 saatten, görevliler ve bölgeler için ise 30 günden uzun süre önbelleğe almamayı kabul eder.
  • API'yi kullanan geliştiriciler, tüm kullanıcılara aynı deneyimin sunulması için her türlü çabayı göstermelidir. Ödemelerin bekletilmesine, A/B testlerine 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 kota artışı isteğinde bulunabilirsiniz. Ek kota sağlama işlemi sınırlıdır ve maksimum izin verilen miktara tabidir.

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

  • Civic Info API için ek kota yalnızca kullanıcıya yönelik kullanım alanlarını desteklemek amacıyla sağlanır. Diğer kullanım alanları için kota artışı istekleri 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, seçimden önceki son birkaç hafta ve hatta son birkaç gün içinde bu verileri sık sık revize eder. Kullanıcıları oylama yapmadan önce tekrar kontrol etmeleri konusunda uyarmak iyi bir fikirdir.
  • Resmi feed'lerin çoğunda sokak segmentleri bulunur. Bu, seçim yetkililerinin bir dizi adresi seçim bölgelerine ve sandık yerlerine bağladığı anlamına gelir. Bu adreslerde kayıtlı seçmenler olabilir veya olmayabilir. Bu nedenle, Voting Information Project aracılığıyla resmi feed'ler sağlayan eyaletlerde, kayıtlı seçmenlerin olmadığı bir adres başarıyla sonuçlanabilir.
  • Resmi feed sağlamayan eyaletlerde yalnızca kayıtlı seçmenlerin bulunduğu adresler başarılı sonuç verir.
  • Zaman zaman aynı bilgi için birden fazla kaynağımız olur. Yerel seçim yetkililerinin iletişim bilgileri ve oy pusulası bilgileri için mevcut en kaliteli bilgileri sunarız. Bu davranışı geçersiz kılmanın tek yolu, officialSourcesOnly parametresi aracılığıyla resmi olmayan kaynakları ortadan kaldırmaktır. Sandık yeri bilgileri için her zaman resmi veri kaynaklarına diğer kaynaklardan daha fazla öncelik veririz.
  • Veri kalitesi sorunları tespit edersek sorun çözülene kadar belirli bir seçim bölgesi için veri döndürmeyebiliriz.
  • Bir adresle ilgili verimiz yoksa bu, o adreste kayıtlı seçmen olmadığı anlamına gelmez. Uygulamalar, kullanıcıları eksiksiz 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 noktadan sonra seçimle ilgili veri döndürülmez.

İlişkilendirme

Civic Information API'ye atıfta bulunmak isteğe bağlıdır. Bir geliştirici, Civic Information API'ye atıfta bulunmayı ve kullanıcıları Civic Information API hakkında daha fazla bilgiye yönlendirmeyi seçerse geliştiricilerin aşağıdaki atıf dili seçeneklerinden ve aşağıda bağlantısı verilen web sayfasından birini kullanması gerekir:

  • "Civic Information API tarafından desteklenmektedir"
  • "Seçim bilgileri Civic Information API tarafından sağlanır."
  • "Seçim pusulası bilgileri Civic Information API tarafından sağlanır."
  • "Daha fazla bilgi"

Durum Kodları

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

Durum Açıklama
success İstenen adres, API tarafından geçerli bir adres olarak tanınıyor.
noStreetSegmentFound API'de şu anda bu adresin hangi seçim bölgesine ve/veya ilçeye ait olduğu hakkında bilgi bulunmuyor. Yeni veriler hâlâ kaynaklandırılıyor/işleniyor olabilir veya bu adreste oy kullanmak için kayıtlı seçmen olmayabilir.
addressUnparseable İstenen adres doğru biçimlendirilmemiş veya coğrafi olarak kodlanamıyor (ör. Google Haritalar API'si bu adres hakkında herhangi bir bilgiye sahip değil).
noAddressParameter Adres belirtilmedi.
multipleStreetSegmentsFound API, belirtilen adresle ilgili bilgi bulamıyor ancak yakındaki adreslerle ilgili bilgiye sahip. Daha fazla bilgi için kullanıcının seçim yetkilisiyle iletişime geçmesi gerekir.
electionOver İstenen seçim sona erdi. Seçimle ilgili 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 belirtilmeyen bir hata oluştu.