Se usó la API de Cloud Translation para traducir esta página.

Especificación de datos de elecciones de identificación nacional

Este documento contiene una especificación de los datos necesarios para Google proporcione la ubicación de votación y la información de los candidatos a Elecciones nacionales basadas en IDs. Este documento es un borrador de la especificación cuyo objetivo principal es solicitar retroalimentación, y esto podría cambiar en el futuro.

Tablas

El siguiente conjunto de tablas se debe proporcionar como un delimitado por tabulaciones value (TSV). Cada archivo debe comenzar con un solo con una lista de los campos de esa tabla. Campos de encabezado opcionales no deben incluirse si no existen datos de los valores de . Las líneas subsiguientes del archivo contienen las filas de datos con en el mismo orden que los especificados en la fila de encabezado.

Los archivos deben tener el nombre adecuado y agruparse en un archivo ZIP. o para archivar. Los archivos deben tener los nombres votantes.tsv, voteGroups.tsv, distritos.tsv, pollingLocations.tsv, candidate.tsv, office.tsv.

Salvo que se indique lo contrario, cada campo indicado en esta especificación una cadena. Los archivos TSV no requieren el escape para comas o errores caracteres distintos de las pestañas. Como las pestañas no son apropiadas para ninguno de en los campos de ninguna de las tablas, los desautorizamos explícitamente estar en un campo.

* se usa para indicar un campo obligatorio en la tabla
** se utiliza para indicar un campo obligatorio que también es una clave primaria para esa tabla (dos filas no pueden tener el mismo valor para este campo)
^Æ indica un campo que debe internacionalizarse.

Internacionalización

Para garantizar que los datos se presenten en el lenguaje correcto algunos campos en la fila de encabezado deben incluir una especificación de configuración regional. Debido a que algunos países tienen más de un idioma, es posible que los datos están disponibles en más de un idioma. Para esos países, las columnas pueden ser repetido con una configuración regional diferente anexada al final de la columna y separándolas con un guion, p.ej., PartyAffiliation-es-419.

Para crear configuraciones regionales, consulta la página de las APIs de Google en Identificadores de idiomas, países, monedas y zonas horarias. Estas especificaciones se basan en Prácticas recomendadas actuales 47 - Etiquetas para identificar idiomas (BCP 47). Ver Apéndice A de BCP 47 para ejemplos de etiquetas de idioma.

Tabla 1: Tabla de votantes (obligatoria)

NationalVoterId**, VoterGroupId

Una fila en la tabla de votantes representa a un solo votante. Cada votante de el país tiene un ID nacional o de votante, el cual se almacena en el NationalVorId. El ID del grupo votante indica a qué grupo de votación un votante.

Nota: En los países donde no existe un grupo de votación lógico, se VotarGroupId puede ser una repetición del NationalVorId. En ese caso, la tabla del grupo de votación (Tabla 2) asignará votantes directamente a IDs de distritos y centros de votación.

Tabla 2: Tabla del grupo de votación (obligatorio)

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

Una fila de esta tabla identifica un grupo de votación, en el que ese grupo votos (a través de PollingLocationId) y en qué distritos este grupo de votación le pertenece. Cada grupo de votación se identifica de forma única con un ID del grupo votante. Pueden especificarse varios ID de distritos, ya que un determinado grupo de votación puede votar por distintos funcionarios de distintos niveles de el Gobierno. Por ejemplo, en EE. UU. se podría votar por un gobernador en a nivel estatal, un ejecutivo del condado a nivel del condado y un alcalde a nivel de ciudad.

Notas: Cada miembro de un grupo de votación debe ser votar en los mismos concursos y en el mismo centro de votación. R el grupo de votación debe dividirse en varios grupos de votación si lo hace pero no es el caso.

Tabla 3: Tabla de distritos (obligatorio)

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

Cada fila de la tabla de distritos contiene datos de un distrito electoral incluida la información de funcionarios electorales locales. El nombre de la autoridad este campo debe incluir el nombre del distrito, si corresponde. p.ej., Distrito de Columbia.

Tabla 4: Centro de votación (obligatorio)

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

Cada centro de votación está representado por una fila en el centro de votación. desde una tabla de particiones. El campo de dirección debe contener una cadena con el nombre específica de la ubicación de votación. Las direcciones se pueden usar para Proporcionar vínculos a mapas para que las direcciones que se asignen con precisión en sitios web geográficos son ideales. En los casos en que una dirección asignable no es posible, el la información se proporcionará al usuario como texto. Latitud y La longitud es un campo opcional que contiene la latitud geodésica y de longitud. Brindar información de latitudes y longitudes información sobre errores al comprobar los resultados de las ubicaciones de sondeo.

El campo AdditionalDirections es opcional y puede contener instrucciones sobre cómo llegar. necesarias para encontrar un centro de votación, p.ej., dentro del edificio especificadas por la dirección. El campo ContactInfo debe contener información necesaria para contactar a los funcionarios responsables de esta lugar de votación.

Tabla 5: Tabla de candidatos (obligatoria)

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

Cada fila de la tabla de candidatos representa un candidato. CandidateId identifique de manera inequívoca a un candidato. El campo de la oficina contiene el nombre del cargo al que se postula este candidato. Otros campos en este de búsqueda proporcionan información sobre el candidato.

Tabla 6: Mesa de oficina

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

Cada oficina tiene una fila en esta tabla que se identifica de forma única con un ID de la oficina También se incluye el nombre y la descripción de la oficina. El campo DistrictId debe especificar uno de los IDs de distrito que aparecen en los campos ProvinceDistrictId, CountyDistrictId o LocalityDistrictId en la tabla Grupo de votación. Para oficinas en las que todos votantes, TODO se debe usar como el ID del distrito.

Ejemplos

Ejemplos de encabezados de archivos de datos de ubicaciones de votación

Archivo: votantes.tsv
Encabezado:

NationalVoterId        VoterGroupId

Archivo: votesGroups.tsv
Encabezado:

VoterGroupId        PollingLocationId

Archivo: sondeoingLocations.tsv
Encabezado:

PollingLocationId        Address        HoursOfOperation

Ejemplo de encabezado de archivo en varios idiomas

Si un país tiene varios idiomas, es posible que el encabezado de cada archivo tenga campos adicionales que indican el idioma o la configuración regional de los datos incluidos en ese campo. Solo los campos que estén marcados como internacionalizables, es decir, con el marcador ^Æ, en las descripciones de la tabla anteriores deben tener configuración regional agregada.