หลักเกณฑ์ข้อมูลสําหรับนักพัฒนาซอฟต์แวร์

ข้อมูลการลงคะแนนเสียง

Google Civic Information API จะแสดงข้อมูลพลเมือง เช่น สถานที่ลงคะแนน สถานที่ลงคะแนนล่วงหน้า ข้อมูลติดต่อของเจ้าหน้าที่การเลือกตั้งในท้องถิ่น และข้อมูลบัตรลงคะแนนแก่ผู้ใช้สำหรับการเลือกตั้ง ที่ได้รับการสนับสนุนจาก Voting Information Project

ความพร้อมของข้อมูล

หลักเกณฑ์สำหรับนักพัฒนาแอป

เรากำหนดให้นักพัฒนาแอปทุกรายปฏิบัติตามหลักเกณฑ์ต่อไปนี้

  • ปฏิบัติตามข้อกำหนดในการให้บริการของ API
  • การใช้ API แสดงว่านักพัฒนาแอปตกลงที่จะปฏิบัติตามส่วนหัว Cache-Control หากมี หากไม่มีส่วนหัว Cache-Control นักพัฒนาแอปตกลงที่จะไม่แคชข้อมูลสถานที่ลงคะแนนและข้อมูลการแข่งขันนานเกิน 24 ชั่วโมง และจะไม่แคชข้อมูลผู้ดำรงตำแหน่งและเขตเลือกตั้งนานเกิน 30 วัน
  • นักพัฒนาแอปที่ใช้ API ควรพยายามอย่างเต็มที่เพื่อให้ผู้ใช้ทุกคนได้รับประสบการณ์การใช้งานเดียวกัน เราไม่อนุญาตการทดสอบแบบ Holdback, การทดสอบ A/B หรือการทดสอบที่คล้ายกัน

  • หากต้องการโควต้าเพิ่มเติมเพื่อเปิดใช้กรณีการใช้งาน คุณสามารถขอเพิ่มโควต้าต่อโปรเจ็กต์ใน Developer Console การจัดสรรโควต้าเพิ่มเติมมีจำนวนจำกัดและขึ้นอยู่กับโควต้าสูงสุดที่อนุญาต

    หมายเหตุ: กระบวนการอนุมัติใช้เวลา 1-2 เดือน โปรดวางแผนคำขอเพิ่มโควต้าตามนั้น หากต้องการเตรียมพร้อมสำหรับการเพิ่มโควต้าการเลือกตั้งประธานาธิบดีปี 2024 โปรดส่งคำขอโควต้าภายในเดือนสิงหาคม

  • โควต้าเพิ่มเติมสำหรับ Civic Info API มีไว้เพื่อรองรับกรณีการใช้งานที่ผู้ใช้มองเห็นเท่านั้น คำขอเพิ่มโควต้าสำหรับ Use Case อื่นๆ จะไม่ได้รับอนุมัติ

หลักเกณฑ์เพิ่มเติมเกี่ยวกับข้อมูล

ข้อมูลนี้เป็นข้อมูลที่จัดการได้ยากเป็นพิเศษ โปรดคำนึงถึงประเด็นต่อไปนี้

  • เจ้าหน้าที่การเลือกตั้งจะแก้ไขข้อมูลนี้บ่อยครั้งในช่วง 2-3 สัปดาห์สุดท้ายและแม้แต่ในช่วง 2-3 วันสุดท้ายก่อนการเลือกตั้ง คุณควรเตือนผู้ใช้ให้กลับมาตรวจสอบก่อนโหวต
  • ฟีดอย่างเป็นทางการส่วนใหญ่จะมีกลุ่มถนน ซึ่งหมายความว่าเจ้าหน้าที่การเลือกตั้งจะเชื่อมโยงช่วงที่อยู่กับเขตเลือกตั้งและสถานที่เลือกตั้ง ช่วงดังกล่าวอาจมีหรือไม่มีผู้มีสิทธิ์เลือกตั้งที่ลงทะเบียนในที่อยู่เหล่านั้นก็ได้ ดังนั้น สำหรับรัฐที่ให้ฟีดอย่างเป็นทางการผ่านโครงการข้อมูลการลงคะแนนเสียง ที่อยู่ซึ่งไม่มีผู้มีสิทธิ์ลงคะแนนเสียงที่ลงทะเบียนอาจแสดงผลเป็นสำเร็จ
  • สำหรับรัฐที่ไม่ได้ให้ฟีดอย่างเป็นทางการ เฉพาะที่อยู่ที่ผู้มีสิทธิ์เลือกตั้งที่ลงทะเบียนไว้เท่านั้นที่จะแสดงผลสำเร็จ
  • บางครั้งเราจะมีแหล่งข้อมูลหลายแห่งสำหรับข้อมูลเดียวกัน เราแสดงข้อมูลที่มีคุณภาพสูงสุดเท่าที่จะเป็นไปได้สำหรับข้อมูลติดต่อของเจ้าหน้าที่การเลือกตั้งในท้องถิ่นและข้อมูลบัตรลงคะแนน คุณไม่สามารถลบล้างลักษณะการทำงานนี้ได้ นอกจากการกำจัดแหล่งที่มาที่ไม่เป็นทางการผ่านพารามิเตอร์ officialSourcesOnly สำหรับข้อมูลสถานที่เลือกตั้ง เราจะให้ความสำคัญกับแหล่งข้อมูลอย่างเป็นทางการมากกว่าแหล่งข้อมูลอื่นๆ เสมอ
  • หากพบปัญหาด้านคุณภาพของข้อมูล เราอาจไม่แสดงข้อมูลสำหรับเขตเลือกตั้งใดเขตเลือกตั้งหนึ่งจนกว่าปัญหาจะได้รับการแก้ไข
  • หากเราไม่มีข้อมูลเกี่ยวกับที่อยู่ ก็ไม่ได้หมายความว่าไม่มีผู้ลงทะเบียนใช้สิทธิเลือกตั้งในที่อยู่นั้น แอปพลิเคชันควรนำผู้ใช้ไปยังเจ้าหน้าที่การเลือกตั้งในพื้นที่เพื่อดูข้อมูลที่ครบถ้วน
  • การเลือกตั้งจะหมดอายุโดยอัตโนมัติหลังจากวันเลือกตั้ง ระบบจะไม่แสดงข้อมูลสำหรับการเลือกตั้งหลังจากนั้น

การระบุแหล่งที่มา

คุณจะระบุแหล่งที่มาของ Civic Information API หรือไม่ก็ได้ หากนักพัฒนาแอปเลือกที่จะระบุแหล่งที่มาของ Civic Information API และลิงก์ผู้ใช้ไปยังข้อมูลเพิ่มเติมเกี่ยวกับ Civic Information API เรากำหนดให้นักพัฒนาแอปใช้ตัวเลือกภาษาการระบุแหล่งที่มาและหน้าเว็บที่ลิงก์ไว้ด้านล่างนี้

  • "ขับเคลื่อนโดย Civic Information API"
  • "ข้อมูลการเลือกตั้งที่ขับเคลื่อนโดย Civic Information API"
  • "ข้อมูลบัตรเลือกตั้งที่ขับเคลื่อนโดย Civic Information API"
  • "ดูข้อมูลเพิ่มเติม"

รหัสสถานะ

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

สถานะ คำอธิบาย
success API จะจดจำที่อยู่ที่ขอเป็นที่อยู่ที่ถูกต้อง
noStreetSegmentFound ปัจจุบัน API ยังไม่มีข้อมูลเกี่ยวกับเขตเลือกตั้งและ/หรือเขตที่อยู่นี้สังกัด อาจเป็นเพราะเรายังคงรวบรวม/ประมวลผลข้อมูลใหม่ หรือไม่มีผู้มีสิทธิเลือกตั้งที่ลงทะเบียนเพื่อใช้สิทธิเลือกตั้งที่ที่อยู่นี้
addressUnparseable ที่อยู่ที่ขอมีรูปแบบไม่ถูกต้องหรือทำการเข้ารหัสพิกัดภูมิศาสตร์ไม่ได้ (เช่น Google Maps API ไม่รู้จักที่อยู่นี้)
noAddressParameter ไม่ได้ระบุที่อยู่
multipleStreetSegmentsFound API ไม่พบข้อมูลสำหรับที่อยู่ที่ระบุ แต่มีข้อมูลเกี่ยวกับที่อยู่ใกล้เคียง ผู้ใช้ควรติดต่อเจ้าหน้าที่การเลือกตั้งเพื่อขอข้อมูลเพิ่มเติม
electionOver การเลือกตั้งที่ขอสิ้นสุดแล้ว ผลลัพธ์ API สำหรับการเลือกตั้งไม่มีให้บริการอีกต่อไป สร้าง electionQuery เพื่อค้นหารหัสสำหรับการเลือกตั้งที่กำลังจะมาถึง
electionUnknown รหัสการเลือกตั้งที่ขอไม่ถูกต้อง ส่ง electionQuery เพื่อค้นหารหัสที่ถูกต้อง
internalLookupFailure เกิดข้อผิดพลาดที่ไม่ระบุขณะประมวลผลคำขอ