Esta página foi traduzida pela API Cloud Translation.

Especificação dos dados eleitorais de identificação nacional

Este documento contém uma especificação dos dados necessários para que o Google forneça o local de votação e as informações do candidato para Eleições com base em identificação nacional. Este documento é um rascunho de especificação tem como objetivo principal solicitar feedback e pode mudar no futuro.

Tabelas

O seguinte conjunto de tabelas deve ser fornecido separadamente separado por tabulação value (TSV). Cada arquivo deve começar com um único de cabeçalho que lista os campos da tabela. Campos de cabeçalho opcionais não precisarão ser incluídos se não houver dados para o . As linhas seguintes no arquivo contêm as linhas de dados com campos na mesma ordem que os especificados na linha do cabeçalho.

Os arquivos devem ser nomeados de forma adequada e agrupados em um zip arquivado. Os arquivos devem ter os seguintes nomes: distritos.tsv, eleiçõesLocations.tsv, candidatas.tsv, escritórios.tsv.

Salvo indicação em contrário, cada campo indicado nesta especificação é uma string. Os arquivos TSV não exigem escape para vírgulas ou caracteres caracteres diferentes de tabulações. Como as guias não são apropriadas campos em qualquer uma das tabelas, nós proibimos explicitamente em um campo.

O * é usado para indicar um campo obrigatório na tabela.
** é usado para indicar um campo obrigatório que também é uma chave primária para essa tabela (duas linhas não podem ter o mesmo valor para esse campo)
^Æ indica um campo que deve ser internacionalizado.

Internacionalização

Para garantir que os dados sejam apresentados no idioma correto alguns campos na linha do cabeçalho precisam incluir uma especificação de localidade. Como alguns países têm mais de um idioma, pode ser necessário fornecidos em mais de um idioma. Para estes países, as colunas podem ser repetido com uma localidade diferente anexada ao final da coluna nome e separados por um traço, por exemplo, PartyAffiliation-en.

Para criar localidades, consulte a página de APIs do Google em Identificadores de idiomas, países, moedas e fusos horários. Essas especificações dependem Práticas recomendadas atuais 47 - Tags para identificação de idiomas (BCP 47, na sigla em inglês). Consulte o Apêndice A de BCP 47 para exemplos de tags de linguagem.

Tabela 1 – Tabela de votações (obrigatória)

NationalVoterId**, VoterGroupId

Uma linha na tabela de eleitores representa um único eleitor. Cada eleitor de o país tem um RG ou título de eleitor, ele será armazenado no NationalVoterId. VoterGroupId indica qual grupo de votação este a que o eleitor pertence.

Observações: Em países onde não existe um grupo de votação lógico, a VoterGroupId pode ser uma repetição de NationalVoterId. Nesse caso, a tabela do grupo de votação (Tabela 2) vai atribuir os eleitores diretamente códigos de distritos e de locais de votação.

Tabela 2: tabela do grupo de votação (obrigatório)

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

Uma linha nessa tabela identifica um grupo de votação, em que esse grupo votos (via PollingLocationId) e em quais distritos esse grupo de votação a que pertence. Cada grupo de votação é identificado de forma exclusiva por um VoterGroupId. IDs de vários distritos podem ser especificados, pois um determinado o grupo de votação pode votar em diferentes funcionários em diferentes níveis governo Por exemplo, nos EUA, é possível votar para um governador em estadual, um executivo do condado no nível do condado e um prefeito no nível de cidade.

Observações: todos os indivíduos de um grupo de votação devem votar nos mesmos concursos e no mesmo local de votação. Um o grupo de votação deve ser dividido em vários grupos de votação se isso for mas esse não é o caso.

Tabela 3 – Tabela de distritos (obrigatória)

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

Cada linha na tabela de distritos contém dados de um distrito eleitoral incluindo informações de funcionários eleitorais locais. O nome da autoridade deve incluir o nome do distrito, se apropriado, Por exemplo: Distrito de Colúmbia.

Tabela 4: local da enquete (obrigatório)

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

Cada local de votação é representado por uma linha no local de votação tabela. O campo de endereço deve conter uma string com o prefixo o endereço especificado para o local de votação. Os endereços podem ser usados para forneça links de mapas para que endereços sejam mapeados com precisão em sites geográficos. são ideais. Nos casos em que um endereço mapeável não é possível, o informações serão fornecidas ao usuário como texto. Latitude e Longitude são campos opcionais que contêm a latitude geodésica e longitude. Fornecer latitudes e longitudes fornece informações informações para verificar erros na verificação dos resultados do local de votação.

O campo "AdditionalDirections" é opcional e pode conter rotas necessário para encontrar um local de votação, por exemplo, no edifício especificado pelo endereço. O campo ContactInfo deve conter informações necessárias para entrar em contato com os funcionários responsáveis local de votação.

Tabela 5 - Tabela candidata (obrigatória)

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

Cada linha na tabela de candidatos representa um candidato. CandidateId que identifica exclusivamente um candidato. O campo do escritório contém o nome do cargo ao qual o candidato está concorrendo. Outros campos neste para fornecer informações sobre o candidato.

Tabela 6 - Mesa de escritório

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

Cada escritório possui uma linha nesta tabela identificada exclusivamente por um ID do escritório. O nome e a descrição do escritório também estão incluídos. O campo DistrictId deve especificar um dos IDs de distrito listados em os campos ProvínciaDistrictId, CountyDistrictId ou LocalityDistrictId na tabela "Grupo de votação". Para escritórios que são votados por todos eleitores, TODOS devem ser usados como o ID do distrito.

Amostras

Exemplos de cabeçalhos de arquivos de dados de local de enquete

Arquivo: voters.tsv
Cabeçalho:

NationalVoterId        VoterGroupId

Arquivo: votoGroups.tsv
Cabeçalho:

VoterGroupId        PollingLocationId

Arquivo: ApolloLocations.tsv
Cabeçalho:

PollingLocationId        Address        HoursOfOperation

Exemplo de cabeçalho de arquivo em vários idiomas

Se um país tiver vários idiomas, o cabeçalho de cada arquivo poderá ter campos adicionais indicando o idioma/local dos dados incluídos nesse campo. Somente os campos marcados como internacionalizáveis, ou seja, com o marcador ^Æ, as descrições da tabela acima devem conter localidade anexada.