本文档包含 Google 提供投票地点和候选人信息 基于国民身份证的选举。本文档是规范草案 主要用于征求反馈，将来可能会发生变化。
表
下面这组表格应作为单独的表格提供 制表符分隔 value (TSV) 文件。每个文件应以 标题行。可选标头字段 则不需要包含相应维度的数据。 字段。文件中的后续行包含带有 字段的顺序与标题行中指定的顺序相同。
这些文件应正确命名并捆绑在 zip 中 归档。文件应命名为：voters.tsv、voteGroups.tsv、 regions.tsv、pollingLocations.tsv、 person.tsv、offices.tsv。
除非另有说明，否则本规范中指明的每个字段均为 字符串。TSV 文件无需对英文逗号或特殊字符进行转义 制表符以外的字符。由于标签页不适用于 任何表中的字段，我们会明确禁止相应字段 应用场景
* 用于表示表格中的必填字段
** 用于表示必填字段，该字段同时也是
该表格（此字段的两行不能具有相同的值）
Æ 表示必须国际化的字段。
国际化
为了确保以正确的语言显示数据 标题行中的某些字段需要包含语言区域规范。 由于某些国家/地区具有多种语言的数据，因此可能需要 以多种语言提供。对于这类国家/地区，列可能是 在列末尾附加不同语言区域的重复项 并用短划线分隔，例如PartyAffiliation-en.
要构建语言区域，请参阅 <ph type="x-smartling-placeholder"></ph> 语言、国家/地区、货币和时区标识符。 这些规范依赖于 现行最佳做法 47 - 用于标识语言的标记 (BCP 47)。 详见附录 A 的 BCP 47 获取语言标记示例。
表 1 - 投票表（必填）
NationalVoterId**, VoterGroupId
投票者表格中的一行代表一位选民。的每位选民 有国民身份证或选民身份证件，则此信息会存储在 NationalvoterId 字段。voterGroupId 指明这是哪个投票小组 所有信息。
注意： 在没有逻辑投票组的国家/地区， voterGroupId 可以重复与 NationalvoterId 重复，在这种情况下 投票小组表格（表 2）会直接将投票者 选区 ID 和投票点 ID。
表 2 - 投票小组表（必填）
VoterGroupId**, PollingLocationId*, ProvinceDistrictId,
CountyDistrictId, LocalityDistrictId
此表中的行标识一个投票群体，该群体 投票（通过 PollingLocationId）以及该投票组的选区 所属的项目。每个投票群体都由一个唯一的 voterGroupId。由于给定 投票小组可以投票给不同级别的 政府。例如，在美国，人们可能会为 州长投票 州一级、县一级行政主管以及市长 在城市级别查看
备注： 投票小组中的每个人都应 在同一投票点在同一场选举中投票。答 如果采用这种方式，则应将投票组分成多个投票组， 事实并非如此。
表 3 - 区表（必填）
DistrictId**, AuthorityName*, LocalElectionOfficialName*,
LocalElectionOfficialPhone*, LocalElectionUrl*,
LocalElectionOfficialEmail, LocalElectionOfficialAddress
地区表中的每一行都包含投票选区的数据 包括当地选举官员信息。机构名称 字段中应包含相应地区的名称 例如哥伦比亚特区。
表 4 - 轮询位置（必需）
PollingLocationId**, Address*Æ, Latitude, Longitude,
HoursOfOperationÆ, AdditionalDirectionsÆ,
ContactInfoÆ
每个投票点都由该投票点中的一行表示 表格。地址字段应包含一个 。地址可能会用于 提供地图链接，以便在地理网站上准确映射地址 理想之选在无法映射地址的情况下， 信息将以文本形式提供给用户纬度和 经度是可选字段，其中包含大地纬度和 经度。提供纬度和经度可带来有价值的 有关检查轮询位置结果的错误的信息。
AdditionalDirections 字段是可选的，可能包含路线 （例如建筑物内部 由该地址指定ContactInfo 字段应包含 与负责此事宜的官员联系所需的必要信息 投票点。
表 5 - 候选表（必需）
CandidateId**, CandidateName*Æ,
PartyAffiliationÆ, OfficeId*, Url,
CampaignAddressÆ, Photo, Phone, TwitterHandle,
FacebookUsername, Email, YoutubeChannel
候选定位设置中的每一行代表一个候选定位设置。CandidateId 唯一标识候选人。Office 字段包含 该候选人竞选的办公室的职务。此 表提供了关于候选人的信息。
表 6 - 办公室桌
OfficeId**, DistrictId*, NameÆ, TermÆ,
DescriptionÆ
在此表中每个办事处都有一行，由 办事处 ID。资料中还会显示办事处的名称和说明。 地区 ID 字段必须指定 ProvinceDistrictId、CountryDistrictId 或 LocalityDistrictId 字段 。适用于所有投票的办公室 选民，则应使用 ALL 作为选区 ID。
示例
轮询位置数据文件标头示例
文件：voters.tsv
标题：
NationalVoterId VoterGroupId
文件：voteGroups.tsv
标题：
VoterGroupId PollingLocationId
文件：pollingLocations.tsv
标题：
PollingLocationId Address HoursOfOperation
多语言文件标头示例
如果一个国家/地区有多种语言，则每个文件的标题可能会包含 用于指明所包含数据的语言/语言区域的附加字段 。仅限标记为“可国际化”的字段 即，在上述表格说明中使用 Æ 标记时，则应使用 已附加语言区域。
文件：pollingLocations.tsv
标题：
PollingLocationId Address HoursOfOperation-en HoursOfOperation-fr
这个简单的示例显示了以英文显示的营业时间字段 和法语。