本頁面由 Cloud Translation API 翻譯而成。

國民身分證資料規格

本文件內含 Google 會負責提供投票地點和候選人資訊國民身分證選舉。本文件為草稿規格主要用於徵求意見回饋，日後可能會有所變動。

表格

下列資料表應分別提供定位點分隔值 (TSV) 檔案。每個檔案的開頭都必須是列出該表格欄位的標頭行。選填的標頭欄位不需要納入任何對應項目的資料 ] 欄位。檔案中的後續幾行會包含含有欄位的順序與標題列指定的順序相同。

請務必使用正確的檔案名稱，並組合成 ZIP 檔案封存。檔案名稱應命名為：voters.tsv、voteGroups.tsv、 Districts.tsv、voteingLocations.tsv、cans.tsv、Offices.tsv。

除非另有註明，否則這個規格中指定的每個欄位都是字串。TSV 檔案不需要逸出逗號或特殊符號字元。由於分頁不適合我們明確禁止這些欄位都是在野心中

* 用於表示資料表中的必填欄位
** 用於代表必填欄位，也是資料的主鍵。該表格 (這個欄位不能有兩列相同值)
^Æ 代表必須國際化的欄位。

國際化

為了確保資料以正確語言呈現標題列的部分欄位必須包含語言代碼規格。由於某些國家/地區可能會有多種語言資料並使用多種語言服務這類國家/地區的欄可能是重複，在資料欄結尾附加不同的語言代碼並以連字號分隔，例如：PartyAffiliation-en。

如要建構語言代碼，請參閱語言、國家/地區、貨幣和時區的 ID。根據這些規格現行最佳做法 47 - 識別語言的標記 (BCP 47)。請參閱附錄 BCP 47 中的語言標記範例。

表 1 - 選民表 (必填)

NationalVoterId**, VoterGroupId

投票者表格中的一列代表單一選民。以下國家/地區的每位選民：國家/地區擁有國民身分證或選民 ID，儲存後會儲存到 NationalvoterId 欄位。voterGroupId 代表這是哪個投票團體選民所屬的國家/地區

注意：在沒有邏輯投票團體的國家/地區，這時 voterGroupId 可以重複用於 NationalvoterId。投票群組表 (表 2) 會直接將選民指派到行政區 ID 和投票地點 ID。

表 2 - 投票群組表 (必填)

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

下表中的資料列代表投票群組 (也就是投票者) 票數 (透過 PollingLocationId)，以及此投票組別的選區所屬群組。每個投票群組都有專屬的 voterGroupId。可以指定多個選區 ID，因為投票小組可以投票給不同官員的投票政府。例如，美國有個政府投票給總長州級、郡/縣級行政以及市長城市層級

注意：投票小組的每個人都應該票據同好，並位於相同的投票地點。A 罩杯如果投票者而不是事實

表 3 - 區表 (必填)

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

學區表中的每一列都含有一個投票區的資料 (包括當地選舉官方資訊)發證機構名稱欄位應視情況加入行政區名稱例如：哥倫比亞特區。

表 4 - 輪詢位置 (必填)

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

每個投票地點都會在投票處以一列表示表格。位址欄位應包含完整的字串指定的投票地點。地址可能會用於提供地圖連結，讓地址在地理網站上能準確繪製是理想選擇如果無法對應地址，資訊會以文字形式提供給使用者。緯度和經度是選填欄位，當中含有測地緯度和經度提供經緯度資料查看投票位置結果的錯誤資訊。

「AdditionalDirections」欄位為選填，可能包含路線但為了尋找投票所所需，例如建築物內所指定的 IP 位址範圍ContactInfo 欄位應包含聯絡負責這項事宜的官員時所需的資訊投票地點。

表 5 - 候選表格 (必填)

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

候選人表格中的每一列都代表一個候選項目。CandidateId 每位候選人的專屬 IDOffice 欄位包含名稱為該候選人所要參加的辦公室。這個欄位中的其他欄位表格提供候選人的相關資訊。

表格 6 - Office 桌

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

這個表格列出了每間辦公室的一列， Office ID。也會顯示辦公室的名稱和說明。 DistrictId 欄位必須指定列名的其中一組行政區 ID ProvinceDistrictId、 CountyDistrictId 或 LocalityDistrictId 欄位。由所有人投票的辦公室和 ALL 等同行政區 ID 使用。

範例

意見調查位置資料檔案標頭範例

檔案：voters.tsv
標題：

NationalVoterId        VoterGroupId

檔案：voteGroups.tsv
標題：

VoterGroupId        PollingLocationId

檔案： PolingLocations.tsv
標題：

PollingLocationId        Address        HoursOfOperation

多語言檔案標頭範例

如果國家/地區有多種語言版本，每個檔案的標題可能會其他欄位，用於表示包含資料的語言/語言代碼。只有標示為「可國際化」的欄位換句話說，在上方表格說明中，^Æ 附加語言代碼。