Linee guida sui dati degli sviluppatori

Informazioni sul voto

L'API Google Civic Information restituisce agli utenti informazioni civiche, come seggi elettorali, sedi di voto anticipato, dettagli di contatto degli uffici elettorali locali e informazioni sui documenti elettorali per le elezioni supportate dal Voting Information Project.

Disponibilità dei dati

Linee guida per gli sviluppatori

Tutti gli sviluppatori sono tenuti a rispettare le seguenti linee guida:

  • Rispettare i Termini di servizio delle API.
  • Utilizzando l'API, gli sviluppatori accettano di rispettare eventuali intestazioni cache-control. In assenza di intestazioni cache-control, gli sviluppatori accettano di non memorizzare nella cache per più di 24 ore le informazioni sui seggi elettorali e sui concorsi e per più di 30 giorni per gli insediati e i distretti.
  • Gli sviluppatori che utilizzano l'API devono fare ogni sforzo per garantire a tutti gli utenti la stessa esperienza. Non sono consentiti blocchi, 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 sviluppatori. Il provisioning di una quota aggiuntiva è limitato ed è soggetto a una tolleranza massima.

    Nota: la procedura di approvazione richiede 1-2 mesi.Pianifica di conseguenza le richieste di aumento della quota. 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 Info è pensata solo per supportare i casi d'uso diretti agli utenti. Le richieste di aumento della quota non vengono concesse per altri casi d'uso.

Linee guida aggiuntive per i dati

Questi dati sono particolarmente difficili da gestire. Tieni presente quanto segue.

  • Gli ufficiali elettorali rivestono spesso questi dati nelle ultime settimane e persino negli ultimi giorni prima delle elezioni. È buona norma avvisare gli utenti di controllare di nuovo prima di votare.
  • La maggior parte dei feed ufficiali contiene tratti di strada, il che significa che i funzionari elettorali associano una serie di indirizzi a seggi e seggi elettorali. 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 registrati elettori potrebbe restituire un risultato positivo.
  • Per gli stati che non forniscono un feed ufficiale, verrà restituito il risultato positivo solo per gli indirizzi in cui è presente un elettore registrato.
  • A volte abbiamo più fonti per le stesse informazioni. Forniamo le informazioni di massima qualità disponibili per i dati di contatto ufficiali e le informazioni sui documenti elettorali locali. Non è possibile eseguire l'override di questo comportamento, a parte eliminare le origini non ufficiali tramite il parametro officialSourcesOnly. Per le informazioni sui seggi elettorali, diamo sempre la priorità alle origini 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 sia nessuno registrato per votare lì. Le applicazioni devono indirizzare gli utenti agli uffici elettorali locali per informazioni complete.
  • Le elezioni scadono automaticamente dopo il giorno delle elezioni. Dopo questa data 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, è tenuto a utilizzare una delle seguenti opzioni di linguaggio di attribuzione e la pagina web collegata di seguito:

  • "Basata sull'API Civic Information"
  • "Informazioni per il voto basate sull'API Civic Information"
  • "Informazioni sul voto basate sull'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 dei codici di errore. Tieni presente che le informazioni potrebbero essere restituite anche se è presente un codice di errore.

Stato Spiegazione
success L'indirizzo richiesto è riconosciuto dall'API come valido.
noStreetSegmentFound Al momento l'API non contiene informazioni sul seggio elettorale e/o sul distretto a cui appartiene questo indirizzo. È possibile che stiamo ancora acquisendo/elaborando nuovi dati o che non ci siano elettori che si sono registrati per votare a questo indirizzo.
addressUnparseable L'indirizzo richiesto non è formattato correttamente o non può essere geocodificato (ovvero l'API Google Maps non sa nulla di questo indirizzo).
noAddressParameter Non è stato fornito alcun indirizzo.
multipleStreetSegmentsFound L'API non riesce a trovare informazioni per l'indirizzo specificato, ma dispone di informazioni sugli indirizzi nelle vicinanze. L'utente deve contattare l'ufficio elettorale per ulteriori informazioni.
electionOver Le elezioni richieste sono terminate. I risultati dell'API per le elezioni non sono più disponibili. Crea un'electionQuery per trovare un ID per le prossime elezioni.
electionUnknown L'ID elezione richiesto non è valido. Esegui un'electionQuery per trovare un ID valido.
internalLookupFailure Si è verificato un errore non specificato durante l'elaborazione della richiesta.