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

ภูมิศาสตร์ทางการเมืองและตัวแทนที่ได้รับเลือกตั้ง

Google Civic Information API ให้ข้อมูลเกี่ยวกับเขตทางภูมิศาสตร์ทางการเมืองและตัวแทนที่ได้รับเลือกตั้งสำหรับที่อยู่ในสหรัฐอเมริกา ตั้งแต่ระดับรัฐบาลกลางไปจนถึงท้องถิ่น ปัจจุบัน เราครอบคลุมพื้นที่เกือบ 100% สำหรับเขตรัฐ เขต และเขตการเลือกตั้งสส. และตั้งเป้าให้ครอบคลุมเขตนิติบัญญัติของรัฐเกิน 90% สภาเทศบาลระดับล่างๆ เช่น สภาเมืองและเคาน์ตี จะได้รับบริการอย่างดีที่สุดและจะปรับปรุงอย่างต่อเนื่อง

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

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

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

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

หลักเกณฑ์สำหรับนักพัฒนาซอฟต์แวร์

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

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

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

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

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

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

ข้อมูลนี้ยากมากเป็นพิเศษ โปรดจดจำประเด็นต่อไปนี้ไว้

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

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

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

  • "ขับเคลื่อนโดย Civic Information API"
  • "ข้อมูลการลงคะแนนเสียงที่ขับเคลื่อนโดย Civic Information API"
  • "ข้อมูล Ballot ที่ขับเคลื่อนโดย 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 เกิดข้อผิดพลาดที่ไม่ได้ระบุขณะประมวลผลคำขอ