Geliştirici Veri Yönergeleri

Siyasi Coğrafya ve Seçilmiş Temsilciler

Google Civic Information API, federal düzeyden yerel düzeydeki ABD adresleri için siyasi coğrafi bölgeler ve seçilmiş temsilciler hakkında bilgi sunar. Şu anda eyalet, ilçe ve Kongre seçim bölgeleri için% 100'e yaklaşan bir kapsama sahibiz ve eyalet yasama bölgelerini% 90'ın üzerine çıkarmayı hedefliyoruz. Şehir ve ilçe meclileri gibi daha alt seviyelerde en iyi çaba esasına göre hizmet verilir ve bu seviye zamanla iyileşir.

Federal, eyalet ve ilçe düzeyindeki tüm seçilmiş yetkililer, her ABD Eyaleti'ndeki en büyük şehrin şehir yetkilileri ve 250.000'in üzerinde nüfusa sahip tüm şehirler hakkında güncel bilgilere sahip olmayı umuyoruz. Bu verileri birden çok kaynaktan toplar ve mevcut en kaliteli bilgileri sunarız. Veri kalitesiyle ilgili sorunlar tespit edersek belirli coğrafi bölgeler, seçilmiş makamlar veya seçilmiş görevliler için veri döndürmeyi durdurabiliriz.

Oy kullanma bilgileri

Google Civic Information API, Seçmen Bilgilendirme Projesi tarafından desteklenen seçimler için kullanıcılara oy verme yeri, erken oy verme yeri, yerel seçim görevlisinin iletişim bilgileri ve oy pusulası bilgileri gibi kentsel bilgiler sağlar.

Veri Kullanılabilirliği

Geliştirici Kuralları

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

  • API hizmet şartlarına uyun.
  • Geliştiriciler API'yı kullanarak, varsa önbellek denetimi başlıklarına uymayı kabul ederler. Önbellek kontrolü başlıkları bulunmayan geliştiriciler, oy verme yerleri ve yarışma bilgileri için 24 saatten, ofis sahipleri ve bölgeler için 30 günden fazla önbelleğe almamayı kabul eder.
  • API'yı kullanan geliştiriciler, tüm kullanıcılara aynı deneyimi sunmak için her türlü çabayı göstermelidir. Engellemelere, 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'dan proje başına artış isteğinde bulunabilirsiniz. Ek kota sağlama işlemleri sınırlıdır ve bu sınır belirli bir maksimum tutara tabidir.

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

  • Civic Info API için ek kota, yalnızca kullanıcılara yönelik kullanım alanlarını desteklemek üzere tasarlanmıştır. Diğer kullanım alanları için kota artışı isteklerine izin verilmez.

Ek Veri Yönergeleri

Özellikle bu verilerle çalışmak zordur. Lütfen aşağıdaki noktaları aklınızda bulundurun.

  • Seçim görevlileri son birkaç haftada, hatta seçimden önceki son birkaç gün içinde bu verileri sık sık gözden geçirir. Kullanıcıları oy vermeden önce tekrar kontrol etmeleri gerektiği konusunda uyarmak iyi bir fikirdir.
  • Çoğu resmi feed, sokak segmentleri içerir. Yani seçim görevlileri, çeşitli adresleri çevre ve oy kullanma yerleriyle ilişkilendirir. Aralıklarda, söz konusu adrese kayıtlı seçmen bulunabilir veya bulunmayabilir. Sonuç olarak, Oy Verme Bilgileri Projesi aracılığıyla resmi özet akışları sağlayan eyaletler için, kayıtlı seçmenlerin bulunmadığı bir adres başarılı olabilir.
  • Resmi feed sağlamayan eyaletlerde, yalnızca kayıtlı bir seçmenin bulunduğu adresler başarı getirecektir.
  • Bazen, aynı bilgiler için birden çok kaynağımız olabilir. Yerel seçim yetkilisinin iletişim bilgileri ve oy pusulası bilgileri için mümkün olan en kaliteli bilgileri sunuyoruz. Bu davranışı geçersiz kılmanın tek yolu, resmi olmayan kaynakları privateSourcesOnly parametresiyle elemektir. Oy kullanma yeri bilgileri için her zaman diğer kaynaklardan ziyade resmi veri kaynaklarına öncelik veririz.
  • Veri kalitesiyle ilgili sorunlar tespit edersek sorun çözülene kadar belirli bir seçim bölgesiyle ilgili veri sağlamayabiliriz.
  • Elimizde bir adresle ilgili veri yoksa bu, orada oy vermek üzere kayıtlı kimsenin olmadığı anlamına gelmez. Başvurular, tam bilgi almaları için kullanıcıları yerel seçim görevlilerine yönlendirmelidir.
  • Seçimlerin süresi, seçim gününden sonra otomatik olarak dolar. Bu tarihten sonra seçimle ilgili hiçbir veri döndürülmeyecektir.

İlişkilendirme

Civic Information API'sine atıfta bulunmak isteğe bağlıdır. Bir geliştirici, Civic Information API'sini kullanmayı ve kullanıcıları Civic Information API ile ilgili daha fazla bilgiye yönlendirmeyi seçerse geliştiricilerin aşağıdaki ilişkilendirme dili seçeneklerinden ve aşağıda bağlantısı verilen web sayfasından birini kullanmaları gerekir:

  • "Civic Information API tarafından desteklenmektedir"
  • "Civic Information API tarafından desteklenen oy bilgileri"
  • "Civic Information API tarafından desteklenen blok bilgileri"
  • "Civic Information API tarafından desteklenen temsil edici bilgiler"
  • "Daha fazla bilgi"

Durum Kodları

Bir adres kabul edildiğinde voterInfoQuery'ye yapılan çağrılar, success olarak ayarlanan bir status alanı içerir. Diğer durumlarda hata kodu döndürülür. Hata kodlarının genel açıklamaları aşağıda verilmiştir. Hata kodu bulunsa 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ır.
noStreetSegmentFound API'nin şu anda bu adresin hangi seçim bölgesine ve/veya ilçesine ait olduğu hakkında bilgi yok. Hâlâ yeni veriler tedarik ediyor/işliyor olabiliriz veya bu adresten oy kullanmak üzere kayıtlı seçmen olmayabilir.
addressUnparseable İstenen adres doğru biçimlendirilmemiş veya coğrafi kodlaması yapılamıyor (yani Google Haritalar API'sı bu adres hakkında hiçbir şey bilmiyor).
noAddressParameter Adres sağlanmadı.
multipleStreetSegmentsFound API, belirtilen adres için bilgi bulamıyor ancak yakındaki adreslerle ilgili bilgiler içeriyor. Kullanıcı, daha fazla bilgi edinmek için seçim yetkilisiyle iletişime geçmelidir.
electionOver İstenen seçim sona erdi. Seçimle ilgili API sonuçları artık mevcut değil. Yaklaşan bir seçimin kimliğini bulmak için bir 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.