Tài liệu này chứa thông số kỹ thuật về dữ liệu cần thiết cho Google cung cấp địa điểm bỏ phiếu và thông tin về ứng cử viên Các cuộc bầu cử dựa trên số căn cước công dân. Tài liệu này là bản quy cách nháp nhằm mục đích chính là thu thập ý kiến phản hồi và có thể thay đổi trong tương lai.
Bảng
Tập hợp bảng sau đây phải được cung cấp riêng biệt được phân tách bằng ký tự tab (TSV). Mỗi tệp phải bắt đầu bằng một dòng tiêu đề liệt kê các trường cho bảng đó. Trường tiêu đề không bắt buộc Nếu không có dữ liệu cho thuộc tính . Các dòng tiếp theo trong tệp chứa các hàng dữ liệu với theo thứ tự như các trường được chỉ định trong hàng tiêu đề.
Các tệp phải được đặt tên phù hợp và được nhóm bên trong một tệp zip lưu trữ. Các tệp này phải được đặt tên là: coupons.tsv, votesGroups.tsv, quậns.tsv, chấm dứt điểm.tsv, ứng viên.tsv, văn phòng.tsv.
Trừ phi có quy định khác, mỗi trường được nêu trong quy cách này một chuỗi. Tệp TSV không yêu cầu thoát bằng dấu phẩy hoặc dấu phẩy đặc biệt ký tự không phải là tab. Vì các tab không thích hợp cho bất kỳ các trường trong bất kỳ bảng nào, chúng tôi không cho phép chúng một cách rõ ràng ở trong một lĩnh vực.
* dùng để biểu thị trường bắt buộc trong bảng
** dùng để cho biết trường bắt buộc cũng là khoá chính
bảng đó (hai hàng không thể có cùng giá trị cho trường này)
Æ biểu thị một trường phải được quốc tế hoá.
Quốc tế hoá
Để đảm bảo rằng dữ liệu được trình bày bằng đúng ngôn ngữ một số trường trong hàng tiêu đề cần bao gồm thông số ngôn ngữ. Vì một số quốc gia có thể cần phải sử dụng nhiều dữ liệu ngôn ngữ được cung cấp bằng nhiều ngôn ngữ. Đối với các quốc gia đó, các cột có thể là lặp lại với một ngôn ngữ khác được thêm vào cuối cột tên và phân tách bằng một dấu gạch ngang, ví dụ: PartyAffiliation-en.
Để tạo ngôn ngữ, hãy tham khảo trang API của Google trên Giá trị nhận dạng cho ngôn ngữ, quốc gia, đơn vị tiền tệ và múi giờ. Các thông số kỹ thuật này dựa trên Các phương pháp hay nhất hiện nay (Câu 47) Thẻ để nhận dạng ngôn ngữ (BCP 47). Xem Phụ lục A của BCP 47 để xem ví dụ về thẻ ngôn ngữ.
Bảng 1 – Bảng cử tri (Bắt buộc)
NationalVoterId**, VoterGroupId
Một hàng trong bảng cử tri đại diện cho một người bỏ phiếu. Mỗi cử tri trong quốc gia có số căn cước hoặc mã cử tri, thông tin này được lưu trữ trong trường NationalVoterId. VoterGroupId cho biết nhóm bỏ phiếu nào của người bỏ phiếu.
Lưu ý: Ở các quốc gia không tồn tại nhóm bỏ phiếu hợp lý, VoterGroupId có thể là trường hợp lặp lại của NationalVoterId bảng nhóm bỏ phiếu (Bảng 2) sẽ trực tiếp chỉ định cử tri cho mã địa hạt và mã địa điểm bỏ phiếu.
Bảng 2 – Bảng nhóm bỏ phiếu (Bắt buộc)
VoterGroupId**, PollingLocationId*, ProvinceDistrictId,
CountyDistrictId, LocalityDistrictId
Một hàng trong bảng này xác định nhóm bỏ phiếu mà nhóm đó phiếu bầu (thông qua SurveyingLocationId) và(các) học khu mà nhóm bỏ phiếu này thuộc về. Mỗi nhóm bỏ phiếu được xác định duy nhất bằng một Mã nhóm cử tri. Bạn có thể chỉ định nhiều mã địa hạt do một giá trị nhất định nhóm bỏ phiếu có thể bỏ phiếu cho các quan chức khác nhau ở các cấp khác nhau chính phủ. Ví dụ: ở Hoa Kỳ, người dùng có thể bỏ phiếu cho thống đốc tại cấp tiểu bang, một cán bộ điều hành cấp hạt và thị trưởng ở cấp thành phố.
Lưu ý: Mọi cá nhân trong nhóm bỏ phiếu đều phải bỏ phiếu cho cùng một cuộc tranh cử và tại cùng một địa điểm bỏ phiếu. Đáp nhóm bỏ phiếu nên được chia thành nhiều nhóm bỏ phiếu nếu đây là không phải vậy.
Bảng 3 – Bảng học khu (Bắt buộc)
DistrictId**, AuthorityName*, LocalElectionOfficialName*,
LocalElectionOfficialPhone*, LocalElectionUrl*,
LocalElectionOfficialEmail, LocalElectionOfficialAddress
Mỗi hàng trong bảng khu vực bầu cử chứa dữ liệu của một khu vực bỏ phiếu bao gồm cả thông tin chính thức về cuộc bầu cử địa phương. Tên cơ quan quản lý trường phải bao gồm tên của học khu nếu thích hợp, ví dụ: Đặc khu Columbia.
Bảng 4 – Vị trí thăm dò ý kiến (Bắt buộc)
PollingLocationId**, Address*Æ, Latitude, Longitude,
HoursOfOperationÆ, AdditionalDirectionsÆ,
ContactInfoÆ
Mỗi địa điểm bỏ phiếu sẽ được biểu thị bằng một hàng trong địa điểm bỏ phiếu bảng. Trường địa chỉ phải chứa chuỗi với đầy đủ địa chỉ đã chỉ định cho vị trí bỏ phiếu. Địa chỉ có thể được dùng để cung cấp đường liên kết đến bản đồ để các địa chỉ hiển thị chính xác trên các trang web địa lý đều rất lý tưởng. Trong trường hợp không thể ánh xạ được một địa chỉ, thông tin sẽ được cung cấp cho người dùng dưới dạng văn bản. Vĩ độ và Kinh độ là các trường không bắt buộc chứa vĩ độ trắc địa và kinh độ. Việc cung cấp vĩ độ và kinh độ mang lại giá trị để báo lỗi khi kiểm tra kết quả địa điểm bỏ phiếu.
Trường AdditionalDirection là trường không bắt buộc và có thể chứa các hướng dẫn cần thiết để tìm địa điểm bỏ phiếu, ví dụ: bên trong toà nhà được chỉ định theo địa chỉ. Trường ContactInfo phải chứa thông tin cần thiết để liên hệ với quan chức chịu trách nhiệm về vấn đề này địa điểm bỏ phiếu.
Bảng 5 - Bảng ứng viên (Bắt buộc)
CandidateId**, CandidateName*Æ,
PartyAffiliationÆ, OfficeId*, Url,
CampaignAddressÆ, Photo, Phone, TwitterHandle,
FacebookUsername, Email, YoutubeChannel
Mỗi hàng trong bảng ứng viên đại diện cho một ứng viên. CandidateId xác định duy nhất một ứng cử viên. Trường văn phòng có chứa tên của chức vụ mà ứng cử viên này đang tranh cử. Các trường khác trong phần này bảng cung cấp thông tin về ứng cử viên.
Bảng 6 – Bàn văn phòng
OfficeId**, DistrictId*, NameÆ, TermÆ,
DescriptionÆ
Mỗi văn phòng có một hàng trong bảng này được xác định duy nhất bằng một mã văn phòng. Tên và nội dung mô tả của văn phòng cũng được đính kèm. Trường Mã quận phải chỉ định một trong các Mã khu vực được nêu trong các trường TỉnhTỉnhId, HạtQuậnId hoặc Thành phố trong bảng Nhóm bỏ phiếu. Đối với các chức vụ được tất cả mọi người bỏ phiếu cử tri, TẤT CẢ sẽ được sử dụng làm Id Quận.
Mẫu
Ví dụ về tiêu đề của tệp dữ liệu vị trí thăm dò ý kiến
Tệp: votess.tsv
Tiêu đề:
NationalVoterId VoterGroupId
Tệp: votesGroups.tsv
Tiêu đề:
VoterGroupId PollingLocationId
Tệp: alertsLocations.tsv
Tiêu đề:
PollingLocationId Address HoursOfOperation
Tiêu đề tệp đa ngôn ngữ mẫu
Nếu một quốc gia có nhiều ngôn ngữ thì tiêu đề cho mỗi tệp có thể có các trường bổ sung cho biết ngôn ngữ/khu vực của dữ liệu được đưa vào trong trường đó. Chỉ những trường được đánh dấu là có thể quốc tế hoá, tức là với điểm đánh dấu Æ, trong các mô tả bảng ở trên sẽ có ngôn ngữ được thêm vào.
Tệp: alertsLocations.tsv
Tiêu đề:
PollingLocationId Address HoursOfOperation-en HoursOfOperation-fr
Ví dụ đơn giản này hiển thị trường giờ hoạt động bằng tiếng Anh và tiếng Pháp.