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

ข้อมูลการเลือกตั้ง

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

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

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

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

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

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

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

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

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

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

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