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

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

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

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

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

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

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

  • หากต้องการโควต้าเพิ่มเติมเพื่อเปิดใช้ Use Case ของคุณ คุณสามารถขอเพิ่มโควต้าต่อโปรเจ็กต์ใน 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 เกิดข้อผิดพลาดที่ไม่ทราบสาเหตุขณะประมวลผลคำขอ