Specifica dei dati sulle elezioni della carta di identità nazionale

Questo documento contiene una specifica per i dati necessari per: Google di fornire informazioni sul seggio elettorale e sui candidati per Elezioni basate sulla carta d'identità. Questo documento è una bozza di specifica il loro scopo principale è sollecitare feedback e potrebbero cambiare in futuro.

Tabelle

Il seguente insieme di tabelle deve essere fornito come separato separato da tabulazioni standard (TSV). Ogni file deve iniziare con una singola riga di intestazione che elenca i campi della tabella. Campi intestazione facoltativi non devono essere inclusi se non esistono dati per l'attributo . Le righe successive del file contengono le righe di dati con nello stesso ordine di quelli specificati nella riga di intestazione.

I file devono essere denominati correttamente e raggruppati all'interno di un file ZIP . I file devono essere denominati: votes.tsv, votesGroups.tsv, distretti.tsv, pollingLocations.tsv, candidati.tsv, office.tsv.

Se non diversamente indicato, ogni campo indicato in questa specifica una stringa. I file TSV non richiedono l'utilizzo di caratteri di escape per virgole o caratteri speciali diversi dalle tabulazioni. Poiché le schede non sono appropriate per nessuno campi in qualsiasi tabella, li vietiamo esplicitamente in un campo.

* viene utilizzato per indicare un campo obbligatorio nella tabella
** viene utilizzato per indicare un campo obbligatorio che è anche una chiave primaria per la tabella (due righe non possono avere lo stesso valore per questo campo)
Æ indica un campo che deve essere internazionalizzato.

Internazionalizzazione

Per garantire che i dati siano presentati nella lingua corretta alcuni campi nella riga di intestazione devono includere le specifiche delle impostazioni internazionali. Poiché alcuni paesi hanno più di una lingua, potrebbe essere necessario disponibili in più di una lingua. Per questi paesi le colonne possono essere ripetuto con impostazioni internazionali diverse aggiunte alla fine della colonna nome e separate da un trattino, ad esempio PartyAffiliation

Per creare le impostazioni internazionali, fai riferimento alla pagina delle API di Google su Identificatori per lingue, paesi, valute e fusi orari. Queste specifiche si basano Best practice attuali 47 - Tag per l'identificazione delle lingue (BCP 47). Vedi Appendice A di BCP 47 per esempi di tag di lingua.

Tabella 1 - Tavolo degli elettori (obbligatorio)

NationalVoterId**, VoterGroupId

Una riga nella tabella degli elettori rappresenta un singolo elettore. Ogni elettore in il paese dispone di una carta di identità o di un documento di identità nazionale, che viene memorizzata nel campo NationalVotarId. VoterGroupId indica quale gruppo di votazione fa parte elettore appartiene.

Note: nei paesi in cui non esiste un gruppo di voto logico, il VoterGroupId può essere una ripetizione del NationalVotarId nel qual caso la tabella del gruppo di votazione (Tabella 2) assegnerà direttamente gli elettori ID distretti e ID delle sedi elettorali.

Tabella 2 - Tabella del gruppo di votazione (obbligatoria)

VoterGroupId**, PollingLocationId*, ProvinceDistrictId, CountyDistrictId, LocalityDistrictId

Una riga di questa tabella identifica un gruppo di votazione, in cui tale gruppo voti (tramite PollingLocationId) e i distretti di questo gruppo di votazione a cui appartiene. Ogni gruppo di voto è identificato in modo univoco da una VoterGroupId. Gli ID multidistretti possono essere specificati poiché gruppo di voto può votare per diversi funzionari di diversi livelli di pubblica amministrazione. Ad esempio, negli Stati Uniti si potrebbe votare per un governatore a livello statale, un dirigente di contea a livello di contea e un sindaco a livello di città.

Note: ogni individuo di un gruppo di votazione deve votare nelle stesse competizioni e nello stesso seggio elettorale. R il gruppo di votazione deve essere suddiviso in più gruppi di votazione, se questo è anche se non è così.

Tabella 3 - Tabella distrettuale (obbligatoria)

DistrictId**, AuthorityName*, LocalElectionOfficialName*, LocalElectionOfficialPhone*, LocalElectionUrl*, LocalElectionOfficialEmail, LocalElectionOfficialAddress

Ogni riga della tabella dei distretti contiene i dati relativi a un distretto elettorale comprese informazioni sui funzionari elettorali locali. Il nome dell'autorità deve includere il nome del distretto, se appropriato, ad es. District of Columbia.

Tabella 4 - Sede elettorale (obbligatorio)

PollingLocationId**, Address*Æ, Latitude, Longitude, HoursOfOperationÆ, AdditionalDirectionsÆ, ContactInfoÆ

Ogni seggio elettorale è rappresentato da una riga nel seggio elettorale . Il campo dell'indirizzo deve contenere una stringa con il valore all'indirizzo specificato per il seggio elettorale. Gli indirizzi possono essere utilizzati per fornire link alle mappe in modo che gli indirizzi vengano mappati in modo preciso sui siti web geografici sono ideali. Nei casi in cui non è possibile un indirizzo mappabile, che verranno fornite all'utente sotto forma di testo. Latitudine e I campi relativi alla longitudine sono campi facoltativi contenenti la latitudine geodetica e e longitudine. Fornire latitudine e longitudini fornisce un'ottima informazioni per l'errore durante la verifica dei risultati del seggio elettorale.

Il campo "Ulteriori indicazioni stradali" è facoltativo e può contenere indicazioni stradali necessarie per trovare un seggio elettorale, ad es. all'interno dell'edificio specificato dall'indirizzo. Il campo ContactInfo deve contenere le informazioni necessarie per contattare i funzionari responsabili seggio elettorale.

Tabella 5 – Tabella dei candidati (obbligatoria)

CandidateId**, CandidateName*Æ, PartyAffiliationÆ, OfficeId*, Url, CampaignAddressÆ, Photo, Phone, TwitterHandle, FacebookUsername, Email, YoutubeChannel

Ogni riga nella tabella dei candidati rappresenta un candidato. CandidateId identifica in modo univoco un candidato. Il campo Office contiene il nome della carica per cui si candida questo candidato. Altri campi in questo che fornisce informazioni sul candidato.

Tabella 6 - Tavolo da ufficio

OfficeId**, DistrictId*, NameÆ, TermÆ, DescriptionÆ

Ogni ufficio ha una riga in questa tabella identificata in modo univoco da un ufficio. Sono inclusi anche il nome e la descrizione dell'ufficio. Il campo DistrictId deve specificare uno degli ID distretto elencati in i campi ProvinceDistrictId, CountyDistrictId o LocalityDistrictId nella tabella Gruppo di voto. Per gli uffici che vengono votati da tutti elettori, come ID distretto deve essere utilizzato TUTTI.

Esempi

Esempi di intestazioni dei file di dati delle località di polling

File: elettori.tsv
Titolo:

NationalVoterId        VoterGroupId

File: votareGroups.tsv
Titolo:

VoterGroupId        PollingLocationId

File: pollingLocations.tsv
Titolo:

PollingLocationId        Address        HoursOfOperation

Intestazione del file multilingue di esempio

Se un paese ha più lingue, l'intestazione di ogni file potrebbe essere campi aggiuntivi indicanti la lingua/l'area geografica dei dati inclusi in questo campo. Solo i campi contrassegnati come internazionalizzabili, ovvero con l'indicatore Æ, le descrizioni della tabella riportate sopra devono avere impostazioni internazionali aggiunte.

File: pollingLocations.tsv
Titolo:

PollingLocationId        Address        HoursOfOperation-en        HoursOfOperation-fr

Questo semplice esempio mostra il campo dell'orario di apertura in inglese e francese.