Cette page a été traduite par l'API Cloud Translation.

Spécification des données concernant les élections nationales

Ce document contient une spécification pour les données nécessaires à Google de fournir des informations sur les bureaux de vote et les candidats pour Élections nationales. Ce document est un brouillon de spécification vise principalement à solliciter des commentaires et est susceptible de changer à l'avenir.

Tables

L'ensemble de tables suivant doit être fourni séparément séparé par une tabulation value (TSV). Chaque fichier doit commencer par un seul d'en-tête listant les champs de ce tableau. Champs d'en-tête facultatifs ne doivent pas être incluses s'il n'existe aucune donnée pour . Les lignes suivantes du fichier contiennent les lignes de données avec dans le même ordre que ceux indiqués dans la ligne d'en-tête.

Les fichiers doivent avoir un nom approprié et être regroupés dans un fichier ZIP archiver. Ces fichiers doivent être nommés comme suit: votants.tsv, votesGroups.tsv, districts.tsv, pollingLocations.tsv, candidats.tsv, bureaux.tsv.

Sauf indication contraire, chaque champ indiqué dans cette spécification est une chaîne. Les fichiers TSV ne nécessitent pas d'échappement pour les virgules ou des caractères autres que des tabulations. Comme les onglets ne sont adaptés à aucune des les champs de tous les tableaux, nous les interdisons explicitement dans un domaine.

* indique un champ obligatoire du tableau.
** est utilisé pour indiquer un champ obligatoire qui est également une clé primaire pour ce tableau (deux lignes ne peuvent pas avoir la même valeur pour ce champ)
^Æ indique un champ qui doit être internationalisé.

Internationalisation

Afin de garantir que les données sont présentées dans la bonne langue certains champs de la ligne d'en-tête doivent inclure des spécifications de paramètres régionaux. Comme certains pays ont des données de plusieurs langues, il peut être nécessaire sont fournis dans plusieurs langues. Pour ces pays, les colonnes peuvent être répété avec un paramètre régional différent ajouté à la fin de la colonne et séparés par un tiret. Exemple : PartyAffiliation-fr.

Pour créer des paramètres régionaux, reportez-vous à la page <ph type="x-smartling-placeholder"></ph> Identifiants de langues, pays, devises et fuseaux horaires Ces spécifications s’appuient sur Bonnes pratiques actuelles 47 – Tags pour l'identification des langues (BCP 47). Voir l'annexe A de BCP 47 pour obtenir des exemples de tags de langue.

Tableau 1 : Tableau des électeurs (obligatoire)

NationalVoterId**, VoterGroupId

Une ligne du tableau sur les électeurs représente un seul votant. Chaque votant de le pays possède une carte d'identité nationale ou d'électeur, celle-ci est stockée dans le NationalVoterId. "VoterGroupId" indique le groupe de votant de l'électeur.

Remarque: Dans les pays où il n'existe aucun groupe votant logique, le "VoterGroupId" peut être un doublon de "NationalVoterId". le tableau des groupes de vote (Tableau 2) attribuera directement les électeurs à les identifiants de district et de bureau de vote.

Tableau 2 : tableau des groupes de vote (obligatoire)

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

Une ligne de ce tableau identifie un groupe votant, que ce groupe (via PollingLocationId), et dans quelle(s) circonscriptions ce groupe votant auquel appartient le projet. Chaque groupe votant est identifié de manière unique par un VoterGroupId. Étant donné qu'un même district un groupe votant peut voter pour différents représentants à différents niveaux de gouvernement. Aux États-Unis, par exemple, il est possible de voter pour un gouverneur au niveau de l'État, un responsable au niveau du comté et un maire au niveau d'une ville.

Remarque: Chaque membre d'un groupe votant doit être voter dans les mêmes scrutins et dans le même bureau de vote. A un groupe votant doit être divisé en plusieurs groupes votants s'il s'agit pas le cas.

Tableau 3 : Table des districts (obligatoire)

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

Chaque ligne du tableau des districts contient les données d'un district électoral. y compris les informations des agents électoraux locaux. Nom de l'autorité doit inclure le nom du district, le cas échéant, Ex. : dans le District de Columbia.

Tableau 4 : Bureau de vote (obligatoire)

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

Chaque bureau de vote est représenté par une ligne du bureau de vote. tableau. Le champ d'adresse doit contenir une chaîne avec le caractère l'adresse spécifiée pour le bureau de vote. Les adresses peuvent être utilisées pour Fournir des liens vers des cartes afin que les adresses soient correctement mappées sur les sites Web géographiques sont idéales. Lorsqu'il n'est pas possible d'obtenir une adresse cartographiable, le les informations seront fournies à l'utilisateur sous forme de texte. Latitude et "Longitude" est un champ facultatif contenant la latitude géodésique et et la longitude. Fournir des latitudes et des longitudes offre des des informations sur les erreurs de vérification des résultats des bureaux de vote.

Le champ AdditionalDirections est facultatif et peut contenir des instructions. nécessaire pour trouver un bureau de vote (ex. : dans le bâtiment spécifié par l'adresse. Le champ ContactInfo doit contenir les informations nécessaires pour contacter les responsables bureau de vote.

Tableau 5 : table des candidats (obligatoire)

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

Chaque ligne de la table des candidats représente un candidat. CandidateId identifie de façon unique un candidat. Le champ office contient le nom du bureau auquel se présente ce candidat. Autres champs dans ce fournissent des informations sur le candidat.

Tableau 6 – Table de bureau

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

Chaque bureau a une ligne dans ce tableau, identifiée de manière unique par un ID du bureau. Le nom et la description du bureau sont également inclus. Le champ DistrictId doit spécifier l'un des ID de district répertoriés dans les champs ProvinceDistrictId, CountyDistrictId ou LocalityDistrictId. dans le tableau "Vote Group". Pour les bureaux votés par tous votants, TOUS les éléments doivent être utilisés comme identifiant de district.

Exemples

Exemples d'en-têtes de fichier de données de localisation de sondage

Fichier: votants.tsv
En-tête:

NationalVoterId        VoterGroupId

Fichier: voteGroups.tsv
En-tête:

VoterGroupId        PollingLocationId

Fichier: pollingLocations.tsv
En-tête:

PollingLocationId        Address        HoursOfOperation

Exemple d'en-tête de fichier multilingue

Si un pays avait plusieurs langues, l’en-tête de chaque fichier peut avoir des champs supplémentaires indiquant la langue/les paramètres régionaux des données incluses dans ce domaine. Seuls les champs marqués comme internationalisables, Par exemple, avec le marqueur ^Æ, les valeurs indiquées dans les descriptions de tableaux ci-dessus doivent être paramètres régionaux ajoutés.