Linee guida sui dati degli sviluppatori

Informazioni sulle votazioni

L'API Google Civic Information restituisce agli utenti informazioni civiche come il seggio elettorale, il luogo di voto anticipato, i dati di contatto del funzionario elettorale locale e le informazioni sulle votazioni per le elezioni supportate dal Voting Information Project.

Disponibilità dei dati

Linee guida per gli sviluppatori

Richiediamo a tutti gli sviluppatori di rispettare le seguenti linee guida:

  • Rispetta i Termini di servizio delle API.
  • Utilizzando l'API, gli sviluppatori accettano di rispettare le intestazioni di controllo della cache, se presenti. In assenza di intestazioni cache-control, gli sviluppatori accettano di non memorizzare nella cache per più di 24 ore le sedi di voto e le informazioni sui concorsi e per più di 30 giorni i funzionari e i distretti.
  • Gli sviluppatori che utilizzano l'API devono fare ogni sforzo per garantire che tutti gli utenti abbiano la stessa esperienza. Non sono consentiti holdback, test A/B o esperimenti simili.

  • Se hai bisogno di una quota aggiuntiva per abilitare il tuo caso d'uso, puoi richiedere un aumento per progetto nella console per gli sviluppatori. Il provisioning di una quota aggiuntiva è limitato ed è soggetto a un'assegnazione massima.

    Nota: la procedura di approvazione richiede 1-2 mesi.Pianifica le richieste di aumento della quota di conseguenza. Per prepararti agli aumenti delle quote per le elezioni presidenziali del 2024,invia le richieste di quota entro agosto.

  • La quota aggiuntiva per l'API Civic Information è destinata solo a supportare casi d'uso rivolti agli utenti. Le richieste di aumento della quota non vengono concesse per altri casi d'uso.

Linee guida aggiuntive per i dati

Lavorare con questi dati è particolarmente difficile. Tieni presente quanto segue.

  • I funzionari elettorali rivedono spesso questi dati nelle ultime settimane e persino negli ultimi giorni prima delle elezioni. È consigliabile avvisare gli utenti di controllare di nuovo prima di votare.
  • La maggior parte dei feed ufficiali contiene segmenti di strade, il che significa che i funzionari elettorali collegano una serie di indirizzi a sezioni elettorali e seggi. Gli intervalli potrebbero o meno avere elettori registrati a questi indirizzi. Di conseguenza, per gli stati che forniscono feed ufficiali tramite il Voting Information Project, un indirizzo in cui non sono presenti elettori registrati potrebbe restituire un risultato positivo.
  • Per gli stati che non forniscono un feed ufficiale, solo gli indirizzi in cui è presente un elettore registrato restituiranno un risultato positivo.
  • A volte, abbiamo più fonti per le stesse informazioni. Forniamo informazioni di altissima qualità sui dati di contatto dei funzionari elettorali locali e sulle votazioni. Non è possibile eseguire l'override di questo comportamento, se non eliminando le fonti non ufficiali tramite il parametro officialSourcesOnly. Per le informazioni sui seggi elettorali, diamo sempre la priorità alle fonti di dati ufficiali rispetto ad altre fonti.
  • Se rileviamo problemi relativi alla qualità dei dati, potremmo non restituire dati per un determinato collegio elettorale finché il problema non viene risolto.
  • Se non disponiamo di dati su un indirizzo, non significa necessariamente che non ci siano persone registrate per votare. Le applicazioni devono indirizzare gli utenti ai funzionari elettorali locali per informazioni complete.
  • Le elezioni scadono automaticamente dopo il giorno delle elezioni. Dopo questo punto, non verranno restituiti dati per le elezioni.

Attribuzione

L'attribuzione all'API Civic Information è facoltativa. Se uno sviluppatore sceglie di attribuire l'API Civic Information e di indirizzare gli utenti a ulteriori informazioni sull'API Civic Information, gli sviluppatori devono utilizzare una delle seguenti opzioni di linguaggio di attribuzione e la pagina web collegata di seguito:

  • "Powered by the Civic Information API"
  • "Informazioni sulle elezioni fornite dall'API Civic Information"
  • "Informazioni sulle schede elettorali fornite dall'API Civic Information"
  • "Scopri di più"

Codici di stato

Le chiamate a voterInfoQuery includono un campo status impostato su success quando viene accettato un indirizzo. In altri casi, verrà restituito un codice di errore. Di seguito sono riportate le spiegazioni più comuni per i codici di errore. Tieni presente che le informazioni potrebbero essere restituite anche se è presente un codice di errore.

Stato Spiegazione
success L'indirizzo richiesto viene riconosciuto dall'API come indirizzo valido.
noStreetSegmentFound Al momento, l'API non dispone di informazioni sul collegio elettorale e/o sul distretto a cui appartiene questo indirizzo. Potremmo essere ancora in fase di reperimento/elaborazione di nuovi dati o non ci sono elettori registrati per votare a questo indirizzo.
addressUnparseable L'indirizzo richiesto non è formattato correttamente o non può essere geocodificato (ovvero l'API Google Maps non conosce questo indirizzo).
noAddressParameter Non è stato fornito alcun indirizzo.
multipleStreetSegmentsFound L'API non riesce a trovare informazioni per l'indirizzo specificato, ma ha informazioni sugli indirizzi nelle vicinanze. L'utente deve contattare il responsabile delle elezioni per ulteriori informazioni.
electionOver L'elezione richiesta è terminata. I risultati dell'API per le elezioni non sono più disponibili. Esegui una electionQuery per trovare l'ID di una prossima elezione.
electionUnknown L'ID elezione richiesto non è valido. Esegui una electionQuery per trovare un ID valido.
internalLookupFailure Si è verificato un errore non specificato durante l'elaborazione della richiesta.