ข้อกำหนดในการจัดทำข้อมูลการเลือกตั้งของรัฐบาลกลาง

เอกสารนี้มีข้อกำหนดของข้อมูลที่จำเป็นสำหรับ Google จะเป็นผู้จัดหาสถานที่ลงคะแนนและข้อมูลผู้สมัคร การเลือกตั้งตามรหัสประจำตัวประชาชน เอกสารนี้เป็นข้อกำหนดฉบับร่าง มีจุดประสงค์เพื่อขอความคิดเห็นเป็นหลัก และอาจมีการเปลี่ยนแปลงในอนาคต

ตาราง

ควรให้ชุดตารางต่อไปนี้แยกต่างหาก คั่นด้วยแท็บ (TSV) แต่ละไฟล์ควรเริ่มต้นด้วยรายการเดียว บรรทัดส่วนหัวที่ระบุรายการฟิลด์สำหรับตารางนั้น ช่องส่วนหัวที่ไม่บังคับ ไม่จำเป็นต้องรวมไว้หากไม่มีข้อมูลสำหรับ ด้วย บรรทัดต่อมาในไฟล์จะมีแถวข้อมูลที่มี ตามลำดับเดียวกับที่ระบุไว้ในแถวส่วนหัว

ควรตั้งชื่อไฟล์อย่างเหมาะสมและรวมกลุ่มไว้ในไฟล์ ZIP ที่เก็บถาวร ควรตั้งชื่อไฟล์: votesrs.tsv, voteGroups.tsv, Districts.tsv, PollingLocations.tsv, ใส่บุคคล.tsv, office.tsv.

เว้นแต่จะระบุไว้เป็นอย่างอื่น แต่ละช่องที่ระบุไว้ในข้อกำหนดนี้คือ สตริง ไฟล์ TSV ไม่จำเป็นต้องใช้อักขระหลีกสำหรับเครื่องหมายจุลภาคหรือแบบพิเศษ อักขระอื่นที่ไม่ใช่แท็บ เนื่องจากแท็บไม่เหมาะสมกับ ช่องใดๆ ในตารางใดก็ได้ เราจะไม่อนุญาตอย่างชัดเจนให้ ทำงานภาคสนาม

* ใช้เพื่อระบุช่องที่ต้องกรอกในตาราง
** ใช้เพื่อระบุช่องที่ต้องกรอกซึ่งเป็นคีย์หลักสำหรับ ตารางนั้น (แถว 2 แถวต้องไม่มีค่าเดียวกันสำหรับช่องนี้)
โดย ^Æ จะระบุช่องที่ต้องทำให้เป็นสากล

การทำให้เป็นสากล

เพื่อให้ข้อมูลนำเสนอในภาษาที่ถูกต้อง บางช่องในแถวส่วนหัวต้องมีข้อกำหนดภาษา เนื่องจากบางประเทศอาจต้องใช้ข้อมูลภาษามากกว่า 1 ภาษา ที่ให้บริการมากกว่า 1 ภาษา สำหรับประเทศดังกล่าวอาจมีคอลัมน์ กล่าวซ้ำด้วยภาษาอื่นที่ต่อท้ายคอลัมน์ และคั่นด้วยเครื่องหมายขีดกลาง เช่น PartyAffiliation-en

หากต้องการสร้างภาษา โปรดดูหน้า Google APIs ใน ตัวระบุสำหรับภาษา ประเทศ สกุลเงิน และเขตเวลา ข้อกำหนดเหล่านี้อิงตาม แนวทางปฏิบัติแนะนำในปัจจุบัน 47 - แท็กสำหรับการระบุภาษา (BCP 47) ดูภาคผนวก A ของ BCP 47 สําหรับตัวอย่างแท็กภาษา

ตารางที่ 1 - ตารางผู้มีสิทธิเลือกตั้ง (ต้องระบุ)

NationalVoterId**, VoterGroupId

แถวในตารางผู้มีสิทธิเลือกตั้งแสดงถึงผู้มีสิทธิเลือกตั้ง 1 คน ผู้มีสิทธิเลือกตั้งแต่ละคนใน ประเทศดังกล่าวมีบัตรประจําตัวประชาชนหรือบัตรประจําตัวผู้มีสิทธิเลือกตั้ง ซึ่งจัดเก็บไว้ใน ช่อง NationalElectionrId VoterGroupId ระบุว่ากลุ่มลงคะแนนใด ผู้มีสิทธิเลือกตั้งเป็นของใคร

หมายเหตุ: ในประเทศที่ไม่มีกลุ่มผู้ลงคะแนนที่สมเหตุสมผล VoterGroupId สามารถใช้ซ้ำกับ NationalElectionrId ได้ ซึ่งในกรณีนี้ ตารางกลุ่มผู้ลงคะแนน (ตาราง 2) จะกำหนดผู้มีสิทธิเลือกตั้งโดยตรง รหัสเขตและรหัสสถานที่ลงคะแนน

ตารางที่ 2 - ตารางกลุ่มผู้มีสิทธิ์เลือกตั้ง (ต้องระบุ)

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

แถวในตารางนี้ระบุกลุ่มลงคะแนน โดยที่กลุ่มดังกล่าว คะแนน (ผ่าน PollingLocationId) และเขตใดที่กลุ่มผู้ลงคะแนนนี้ เป็นของ กลุ่มการโหวตแต่ละกลุ่มจะได้รับการระบุโดยไม่ซ้ำกัน รหัสกลุ่มผู้มีสิทธิเลือกตั้ง สามารถระบุรหัสเขตได้หลายรหัสตั้งแต่ กลุ่มผู้มีสิทธิ์เลือกตั้งอาจลงคะแนนให้เจ้าหน้าที่ในระดับต่างๆ ของรัฐบาล ตัวอย่างเช่น ในสหรัฐฯ คนหนึ่งอาจลงคะแนนเสียงให้ผู้ว่าการรัฐที่ ระดับรัฐ ผู้บริหารเทศมณฑลในระดับเคาน์ตี และนายกเทศมนตรี ในระดับเมือง

หมายเหตุ: สมาชิกทุกคนในกลุ่มลงคะแนนควร การลงคะแนนในห้องเดียวกันและ ณ สถานที่ลงคะแนนเดียวกัน ต ควรแบ่งกลุ่มผู้ลงคะแนนออกเป็นหลายๆ กลุ่ม หากกรณีนี้ ไม่ใช่กรณีนี้

ตารางที่ 3 - ตารางเขต (ต้องระบุ)

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

แต่ละแถวในตารางเขตมีข้อมูลเขตเลือกตั้ง ซึ่งรวมถึงข้อมูลเจ้าหน้าที่การเลือกตั้งท้องถิ่น ชื่อหน่วยงาน ควรมีชื่อของเขตตามความเหมาะสม เช่น ดิสตริกต์ออฟโคลัมเบีย

ตารางที่ 4 - สถานที่ลงคะแนน (ต้องระบุ)

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

สถานที่ลงคะแนนแต่ละแห่งจะแสดงเป็นแถวของหน่วยเลือกตั้ง ฟิลด์ที่อยู่ควรมีสตริงที่มี ที่อยู่ที่ระบุไว้ของสถานที่ลงคะแนน ที่อยู่อาจใช้เพื่อ ให้ลิงก์แผนที่เพื่อให้ที่อยู่บนแผนที่ที่แม่นยำบนเว็บไซต์ภูมิศาสตร์ เหมาะสมที่สุด ในกรณีที่ที่อยู่ที่แมปไม่ได้ ข้อมูลที่จะแสดงต่อผู้ใช้ในรูปแบบข้อความ ละติจูดและ ลองจิจูดเป็นฟิลด์ที่ไม่บังคับซึ่งมีละติจูดทางภูมิศาสตร์และ ลองจิจูด การระบุละติจูดและลองจิจูดให้ค่า สำหรับข้อผิดพลาดในการตรวจสอบผลของตำแหน่งการสำรวจ

ฟิลด์เพิ่มเติมเส้นทางเป็นตัวเลือกที่ไม่บังคับและอาจมีคำแนะนำเส้นทาง ที่จำเป็นต่อการหาสถานที่ลงคะแนน เช่น ภายในอาคาร ที่ระบุโดยที่อยู่ ฟิลด์ ContactInfo ควรมี ข้อมูลที่จำเป็นต่อการติดต่อเจ้าหน้าที่ที่รับผิดชอบเรื่องนี้ หน่วยเลือกตั้ง

ตารางที่ 5 - ตารางผู้สมัคร (ต้องระบุ)

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

แต่ละแถวในตารางผู้สมัครแสดงถึงผู้สมัคร CandidateId ระบุผู้สมัครโดยไม่ซ้ำกัน ฟิลด์สำนักงานมีชื่อ ของสำนักงานที่ผู้สมัครลงสมัคร ช่องอื่นๆ ใน ให้ข้อมูลเกี่ยวกับผู้สมัคร

ตาราง 6 - โต๊ะสำนักงาน

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

สำนักงานแต่ละแห่งจะมีแถวในตารางนี้ซึ่งระบุโดยไม่ซ้ำกัน รหัสสำนักงาน รวมถึงชื่อและคำอธิบายของสำนักงานด้วย ช่อง DistrictId ต้องระบุรหัสเขตแบบใดแบบหนึ่งที่แสดงใน ช่อง ProvinceDistrictId, CountyDistrictId หรือ LocalityDistrictId ในตารางกลุ่มโหวต สำหรับสำนักงานที่ได้รับการโหวตจากทั้งหมด ผู้มีสิทธิเลือกตั้ง ทั้งหมดควรใช้เป็นรหัสเขต

ตัวอย่าง

ตัวอย่างส่วนหัวของไฟล์ข้อมูลตำแหน่งแบบสำรวจ

ไฟล์: voters.tsv
ส่วนหัว:

NationalVoterId        VoterGroupId

ไฟล์: votesGroups.tsv
ส่วนหัว:

VoterGroupId        PollingLocationId

ไฟล์: PollingLocations.tsv
ส่วนหัว:

PollingLocationId        Address        HoursOfOperation

ตัวอย่างส่วนหัวของไฟล์หลายภาษา

ถ้าประเทศหนึ่งมีหลายภาษา ส่วนหัวของแต่ละไฟล์อาจมี ฟิลด์เพิ่มเติมที่ระบุภาษา/สถานที่ของข้อมูลที่รวมอยู่ ในฟิลด์ดังกล่าว เฉพาะฟิลด์ที่มีเครื่องหมายว่าใช้ได้ทั่วโลก นั่นคือ การใช้เครื่องหมาย ^Æ ในคำอธิบายตารางด้านบนควรมี เพิ่มภาษาต่อท้าย

ไฟล์: PollingLocations.tsv
ส่วนหัว:

PollingLocationId        Address        HoursOfOperation-en        HoursOfOperation-fr

ตัวอย่างง่ายๆ นี้จะแสดงเวลาทําการเป็นภาษาอังกฤษ และภาษาฝรั่งเศส