Linee guida sui dati degli sviluppatori

Informazioni sulle votazioni

L'API Civic Information di Google restituisce agli utenti informazioni civiche, come il seggio elettorale, il luogo di voto anticipato, i dati di contatto dei funzionari elettorali locali e le informazioni sulle votazioni 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 le intestazioni cache-control, se presenti. In assenza di intestazioni cache-control, gli sviluppatori accettano di non memorizzare nella cache per più di 24 ore le informazioni sui luoghi di voto e sulle competizioni e per più di 30 giorni le informazioni sui funzionari in carica e sui distretti.
  • Gli sviluppatori che utilizzano l'API devono fare ogni sforzo per garantire che tutti gli utenti abbiano la stessa esperienza. Non consentiamo 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 tua Developer Console. La fornitura di una quota aggiuntiva è limitata ed è soggetta a una dotazione massima.

    Nota: la procedura di approvazione richiede 1-2 mesi, pertanto consigliamo agli sviluppatori di pianificare di conseguenza le richieste di aumento della quota. Per gli aumenti della quota per le elezioni di novembre, consigliamo vivamente di inviare le richieste di quota entro la fine di agosto.

  • La quota aggiuntiva per l'API Civic Info è destinata esclusivamente a supportare i 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

Questi dati sono particolarmente difficili da gestire. Tieni presente i seguenti punti.

  • I funzionari elettorali rivedono spesso questi dati nelle ultime settimane e persino negli ultimi giorni prima delle elezioni. È una buona idea avvisare gli utenti di ricontrollare prima di votare.
  • La maggior parte dei feed ufficiali contiene segmenti di strade, il che significa che i funzionari elettorali collegano un intervallo di indirizzi a distretti e seggi elettorali. Gli intervalli possono 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, avremo più fonti per le stesse informazioni. Forniamo le informazioni di massima qualità disponibili per i dati di contatto dei funzionari elettorali locali e le informazioni sulle votazioni. Non è possibile ignorare 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 di qualità dei dati, potremmo non restituire dati per un determinato distretto 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 in quell'indirizzo. 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 all'API Civic Information e di collegare gli utenti a ulteriori informazioni sull'API Civic Information, gli sviluppatori sono tenuti a utilizzare una delle seguenti opzioni di linguaggio di attribuzione e la pagina web collegata di seguito:

  • "Fornito dall'API Civic Information"
  • "Informazioni sulle votazioni fornite dall'API Civic Information"
  • "Informazioni sulle votazioni fornite dall'API Civic Information"
  • "Scopri di più"

Codici di stato

Le chiamate a voterInfoQuery includono un campo status impostato su success quando un indirizzo viene accettato. In altri casi, verrà restituito un codice di errore. Di seguito sono riportate le spiegazioni 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 distretto elettorale e/o sul distretto a cui appartiene questo indirizzo. È possibile che stiamo ancora recuperando/elaborando nuovi dati o che non ci siano 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 dispone di informazioni sugli indirizzi nelle vicinanze. L'utente deve contattare il funzionario elettorale per ulteriori informazioni.
electionOver Le elezioni richieste sono terminate. I risultati dell'API per le elezioni non sono più disponibili. Esegui una electionQuery per trovare un ID per le prossime elezioni.
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.