Elections: voterInfoQuery

ค้นหาข้อมูลที่เกี่ยวข้องกับผู้มีสิทธิเลือกตั้งตามที่อยู่จดทะเบียนของผู้มีสิทธิเลือกตั้ง ลองเลย

ข้อมูลที่ส่งกลับมาอาจรวมถึง
  • สถานที่ลงคะแนน (รวมถึงหน่วยเลือกตั้งล่วงหน้า) สำหรับที่อยู่ที่พักอาศัยที่ระบุ
  • ข้อมูลการแข่งขันและผู้สมัคร
  • ข้อมูลเจ้าหน้าที่การเลือกตั้ง

ส่งคำขอ

คำขอ HTTP

GET https://www.googleapis.com/civicinfo/v2/voterinfo

พารามิเตอร์

ชื่อพารามิเตอร์ ค่า คำอธิบาย
พารามิเตอร์การค้นหาที่จำเป็น
address string ที่อยู่จดทะเบียนของผู้มีสิทธิเลือกตั้งที่ต้องการค้นหา
พารามิเตอร์การค้นหาที่ไม่บังคับ
electionId long

รหัสที่ไม่ซ้ำกันของการเลือกตั้งที่ต้องการค้นหา สามารถดูรายการบัตรประจำตัวการเลือกตั้งได้ที่ https://www.googleapis.com/civicinfo/{version}/elections

หากไม่มีการระบุรหัสการเลือกตั้งในการค้นหาและมีข้อมูลเกี่ยวกับการเลือกตั้งมากกว่า 1 รายการสำหรับผู้มีสิทธิเลือกตั้งที่ระบุ ระบบจะระบุการเลือกตั้งเพิ่มเติมไว้ในช่องคำตอบของ otherElections

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

ในกรณีนี้ เราขอแนะนำว่าเครื่องมือใดๆ ที่ออกคำค้นหาครั้งที่ 2 ด้วยรหัสการเลือกตั้งที่ระบุไว้ เพื่อให้แน่ใจว่าผู้ใช้จะใช้หน่วยเลือกตั้ง ข้อมูลการเลือกตั้ง และข้อมูลอย่างเป็นทางการที่ถูกต้องได้ (หากมี)
officialOnly boolean หากตั้งค่าเป็น "จริง" ระบบจะส่งคืนเฉพาะข้อมูลจากแหล่งที่มาของรัฐเท่านั้น (ค่าเริ่มต้น: false)

เนื้อหาของคำขอ

อย่าแสดงเนื้อหาของคำขอด้วยวิธีนี้

คำตอบ

หากทำสำเร็จ เมธอดนี้จะแสดงเนื้อหาการตอบสนองที่มีโครงสร้างต่อไปนี้

{
  "kind": "civicinfo#voterInfoResponse",
  "election": elections Resource,
  "otherElections": [
    elections Resource
  ],
  "normalizedInput": {
    "locationName": string,
    "line1": string,
    "line2": string,
    "line3": string,
    "city": string,
    "state": string,
    "zip": string
  },
  "pollingLocations": [
    {
      "address": {
        "locationName": string,
        "line1": string,
        "line2": string,
        "line3": string,
        "city": string,
        "state": string,
        "zip": string
      },
      "notes": string,
      "pollingHours": string,
      "name": string,
      "voterServices": string,
      "startDate": string,
      "endDate": string,
      "latitude": double,
      "longitude": double,
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ]
    }
  ],
  "earlyVoteSites": [
    {
      "address": {
        "locationName": string,
        "line1": string,
        "line2": string,
        "line3": string,
        "city": string,
        "state": string,
        "zip": string
      },
      "notes": string,
      "pollingHours": string,
      "name": string,
      "voterServices": string,
      "startDate": string,
      "endDate": string,
      "latitude": double,
      "longitude": double,
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ]
    }
  ],
  "dropOffLocations": [
    {
      "address": {
        "locationName": string,
        "line1": string,
        "line2": string,
        "line3": string,
        "city": string,
        "state": string,
        "zip": string
      },
      "notes": string,
      "pollingHours": string,
      "name": string,
      "voterServices": string,
      "startDate": string,
      "endDate": string,
      "latitude": double,
      "longitude": double,
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ]
    }
  ],
  "contests": [
    {
      "type": string,
      "primaryParty": string,
      "electorateSpecifications": string,
      "special": string,
      "ballotTitle": string,
      "office": string,
      "level": [
        string
      ],
      "roles": [
        string
      ],
      "district": {
        "name": string,
        "scope": string,
        "id": string
      },
      "numberElected": long,
      "numberVotingFor": long,
      "ballotPlacement": long,
      "candidates": [
        {
          "name": string,
          "party": string,
          "candidateUrl": string,
          "phone": string,
          "photoUrl": string,
          "email": string,
          "orderOnBallot": long,
          "channels": [
            {
              "type": string,
              "id": string
            }
          ]
        }
      ],
      "referendumTitle": string,
      "referendumSubtitle": string,
      "referendumUrl": string,
      "referendumBrief": string,
      "referendumText": string,
      "referendumProStatement": string,
      "referendumConStatement": string,
      "referendumPassageThreshold": string,
      "referendumEffectOfAbstain": string,
      "referendumBallotResponses": [
        string
      ],
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ]
    }
  ],
  "state": [
    {
      "name": string,
      "electionAdministrationBody": {
        "name": string,
        "electionInfoUrl": string,
        "electionRegistrationUrl": string,
        "electionRegistrationConfirmationUrl": string,
        "electionNoticeText": string,
        "electionNoticeUrl": string,
        "absenteeVotingInfoUrl": string,
        "votingLocationFinderUrl": string,
        "ballotInfoUrl": string,
        "electionRulesUrl": string,
        "voter_services": [
          string
        ],
        "hoursOfOperation": string,
        "correspondenceAddress": {
          "locationName": string,
          "line1": string,
          "line2": string,
          "line3": string,
          "city": string,
          "state": string,
          "zip": string
        },
        "physicalAddress": {
          "locationName": string,
          "line1": string,
          "line2": string,
          "line3": string,
          "city": string,
          "state": string,
          "zip": string
        },
        "electionOfficials": [
          {
            "name": string,
            "title": string,
            "officePhoneNumber": string,
            "faxNumber": string,
            "emailAddress": string
          }
        ]
      },
      "local_jurisdiction": (AdministrationRegion),
      "sources": [
        {
          "name": string,
          "official": boolean
        }
      ]
    }
  ],
  "mailOnly": boolean
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย Notes
kind string ระบุประเภทของทรัพยากร ค่า: สตริงคงที่ "civicinfo#voterInfoResponse"
election nested object การเลือกตั้งที่ค้นหา
otherElections[] list เมื่อมีการเลือกตั้งหลายรายการสำหรับที่อยู่ของผู้มีสิทธิเลือกตั้ง ระบบจะป้อนข้อมูลในช่อง otherElections ในการตอบกลับของ API ซึ่งมีความเป็นไปได้ 2 ประการดังนี้

1. หากการเลือกตั้งเหล่านี้เกิดขึ้นคนละวันกัน API จะแสดงข้อมูลการลงคะแนนเสียงของการเลือกตั้งครั้งแรก/ครั้งแรก หากการเลือกตั้งแรกสุดไม่ใช่การเลือกตั้งที่ต้องการ ให้ระบุรหัสการเลือกตั้งที่ต้องการในคำขอ API รายการที่ 2 โดยใช้ช่อง electionId

2. หากการเลือกตั้งเหล่านี้เกิดขึ้นในวันเดียวกัน API จะไม่แสดงผลคูหาเลือกตั้ง การแข่งขัน หรือข้อมูลจากเจ้าหน้าที่การเลือกตั้ง เพื่อให้แน่ใจว่ามีการค้นหาเพิ่มเติม สำหรับแอปพลิเคชันที่ผู้ใช้เห็น เราขอแนะนำให้แสดงการเลือกตั้งเหล่านี้ให้ผู้ใช้เห็นเพื่อให้ชัดเจน ควรมีการสร้างคำขอ API รายการที่ 2 ที่ใช้ช่อง electionId สำหรับการเลือกตั้งที่เกี่ยวข้องกับผู้ใช้
normalizedInput nested object ที่อยู่ที่ขอในเวอร์ชันปกติ
normalizedInput.locationName string ชื่อของสถานที่ตั้ง
normalizedInput.line1 string ชื่อถนนและเลขที่ของที่อยู่นี้
normalizedInput.line2 string บรรทัดที่ 2 คือที่อยู่ หากจำเป็น
normalizedInput.line3 string บรรทัดที่ 3 ของที่อยู่ หากจำเป็น
normalizedInput.city string เมืองสำหรับที่อยู่
normalizedInput.state string อักษรย่อรัฐ 2 ตัวของสหรัฐอเมริกาของที่อยู่
normalizedInput.zip string รหัสไปรษณีย์ของสหรัฐอเมริกาของที่อยู่
mailOnly boolean ระบุว่าผู้มีสิทธิเลือกตั้งในเขตเลือกตั้งจะต้องส่งบัตรลงคะแนนทางไปรษณีย์เท่านั้น (โดยมีตัวเลือกให้ทิ้งบัตรลงคะแนนด้วย)

สถานที่ลงคะแนน สถานที่ลงคะแนนล่วงหน้า และสถานที่ส่งคืน

ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย Notes
pollingLocations[] list ประเทศที่ผู้มีสิทธิเลือกตั้งมีสิทธิ์ลงคะแนนเสียงในวันเลือกตั้ง
pollingLocations[].address nested object ที่อยู่ของสถานที่ตั้ง
pollingLocations[].address.locationName string ชื่อของสถานที่ตั้ง
pollingLocations[].address.line1 string ชื่อถนนและเลขที่ของที่อยู่นี้
pollingLocations[].address.line2 string บรรทัดที่ 2 คือที่อยู่ หากจำเป็น
pollingLocations[].address.line3 string บรรทัดที่ 3 ของที่อยู่ หากจำเป็น
pollingLocations[].address.city string เมืองสำหรับที่อยู่
pollingLocations[].address.state string อักษรย่อรัฐ 2 ตัวของสหรัฐอเมริกาของที่อยู่
pollingLocations[].address.zip string รหัสไปรษณีย์ของสหรัฐอเมริกาของที่อยู่
pollingLocations[].notes string หมายเหตุเกี่ยวกับตำแหน่งนี้ (เช่น ทางลาดเพื่อการช่วยเหลือพิเศษหรือทางเข้าเพื่อการใช้งาน)
pollingLocations[].pollingHours string คำอธิบายว่าสถานที่นี้เปิดทำการเมื่อใด
pollingLocations[].name string ชื่อของสถานที่ลงคะแนนล่วงหน้าหรือสถานที่ที่ส่งคืน ช่องนี้ไม่มีข้อมูลสำหรับสถานที่ลงคะแนน
pollingLocations[].voterServices string บริการที่มาจากเว็บไซต์หรือสถานที่ลงคะแนนล่วงหน้านี้ ช่องนี้ไม่มีข้อมูลสำหรับสถานที่ลงคะแนน
pollingLocations[].startDate string วันแรกที่อาจใช้เว็บไซต์หรือสถานที่ส่งของก่อนลงคะแนนนี้ ช่องนี้ไม่มีข้อมูลสำหรับสถานที่ลงคะแนน
pollingLocations[].endDate string วันสุดท้ายที่อาจใช้เว็บไซต์หรือสถานที่ส่งของก่อนลงคะแนนล่วงหน้านี้ ช่องนี้ไม่มีข้อมูลสำหรับสถานที่ลงคะแนน
pollingLocations[].latitude string ละติจูดของตำแหน่งเป็นองศาทางเหนือของเส้นศูนย์สูตร โปรดทราบว่าฟิลด์นี้อาจไม่พร้อมใช้งานในบางสถานที่
pollingLocations[].longitude string ลองจิจูดของตำแหน่งในหน่วยองศาทางตะวันออกของเส้นเมริเดียนหลัก โปรดทราบว่าฟิลด์นี้อาจไม่พร้อมใช้งานในบางสถานที่
pollingLocations[].sources[] list รายการแหล่งที่มาของสถานที่นี้ หากมีการแสดงรายการแหล่งที่มาหลายแหล่ง แสดงว่าข้อมูลที่รวบรวมมาจากแหล่งที่มาเหล่านั้น
pollingLocations[].sources[].name string ชื่อของแหล่งข้อมูล
pollingLocations[].sources[].official boolean ข้อมูลนี้มาจากแหล่งที่มาอย่างเป็นทางการของรัฐบาลหรือไม่
earlyVoteSites[] list ประเทศที่ผู้มีสิทธิเลือกตั้งมีสิทธิ์ลงคะแนนเสียงล่วงหน้าก่อนวันเลือกตั้ง
earlyVoteSites[].address nested object ที่อยู่ของสถานที่ตั้ง
earlyVoteSites[].address.locationName string ชื่อของสถานที่ตั้ง
earlyVoteSites[].address.line1 string ชื่อถนนและเลขที่ของที่อยู่นี้
earlyVoteSites[].address.line2 string บรรทัดที่ 2 คือที่อยู่ หากจำเป็น
earlyVoteSites[].address.line3 string บรรทัดที่ 3 ของที่อยู่ หากจำเป็น
earlyVoteSites[].address.city string เมืองสำหรับที่อยู่
earlyVoteSites[].address.state string อักษรย่อรัฐ 2 ตัวของสหรัฐอเมริกาของที่อยู่
earlyVoteSites[].address.zip string รหัสไปรษณีย์ของสหรัฐอเมริกาของที่อยู่
earlyVoteSites[].notes string หมายเหตุเกี่ยวกับตำแหน่งนี้ (เช่น ทางลาดเพื่อการช่วยเหลือพิเศษหรือทางเข้าเพื่อการใช้งาน)
earlyVoteSites[].pollingHours string คำอธิบายว่าสถานที่นี้เปิดทำการเมื่อใด
earlyVoteSites[].name string ชื่อของสถานที่ลงคะแนนล่วงหน้าหรือสถานที่ที่ส่งคืน ช่องนี้ไม่มีข้อมูลสำหรับสถานที่ลงคะแนน
earlyVoteSites[].voterServices string บริการที่มาจากเว็บไซต์หรือสถานที่ลงคะแนนล่วงหน้านี้ ช่องนี้ไม่มีข้อมูลสำหรับสถานที่ลงคะแนน
earlyVoteSites[].startDate string วันแรกที่อาจใช้เว็บไซต์หรือสถานที่ส่งของก่อนลงคะแนนนี้ ช่องนี้ไม่มีข้อมูลสำหรับสถานที่ลงคะแนน
earlyVoteSites[].endDate string วันสุดท้ายที่อาจใช้เว็บไซต์หรือสถานที่ส่งของก่อนลงคะแนนล่วงหน้านี้ ช่องนี้ไม่มีข้อมูลสำหรับสถานที่ลงคะแนน
earlyVoteSites[].latitude string ละติจูดของตำแหน่งเป็นองศาทางเหนือของเส้นศูนย์สูตร โปรดทราบว่าฟิลด์นี้อาจไม่พร้อมใช้งานในบางสถานที่
earlyVoteSites[].longitude string ลองจิจูดของตำแหน่งในหน่วยองศาทางตะวันออกของเส้นเมริเดียนหลัก โปรดทราบว่าฟิลด์นี้อาจไม่พร้อมใช้งานในบางสถานที่
earlyVoteSites[].sources[] list รายการแหล่งที่มาของสถานที่นี้ หากมีการแสดงรายการแหล่งที่มาหลายแหล่ง แสดงว่าข้อมูลที่รวบรวมมาจากแหล่งที่มาเหล่านั้น
earlyVoteSites[].sources[].name string ชื่อของแหล่งข้อมูล
earlyVoteSites[].sources[].official boolean ข้อมูลนี้มาจากแหล่งที่มาอย่างเป็นทางการของรัฐบาลหรือไม่
dropOffLocations[] list สถานที่ที่ผู้มีสิทธิเลือกตั้งมีสิทธิ์ส่งบัตรลงคะแนนที่สมบูรณ์ ผู้มีสิทธิเลือกตั้งจะต้องได้รับและเสร็จสิ้นการลงคะแนนแล้วก่อนที่จะไปถึงสถานที่นั้นๆ สถานที่ดังกล่าวอาจไม่มีบัตรลงคะแนนในสถานที่นั้นๆ โดยสถานที่ดังกล่าวอาจเปิดในหรือก่อนวันเลือกตั้งตามที่ระบุไว้ในช่อง PollingHours
dropOffLocations[].address nested object ที่อยู่ของสถานที่ตั้ง
dropOffLocations[].address.locationName string ชื่อของสถานที่ตั้ง
dropOffLocations[].address.line1 string ชื่อถนนและเลขที่ของที่อยู่นี้
dropOffLocations[].address.line2 string บรรทัดที่ 2 คือที่อยู่ หากจำเป็น
dropOffLocations[].address.line3 string บรรทัดที่ 3 ของที่อยู่ หากจำเป็น
dropOffLocations[].address.city string เมืองสำหรับที่อยู่
dropOffLocations[].address.state string อักษรย่อรัฐ 2 ตัวของสหรัฐอเมริกาของที่อยู่
dropOffLocations[].address.zip string รหัสไปรษณีย์ของสหรัฐอเมริกาของที่อยู่
dropOffLocations[].notes string หมายเหตุเกี่ยวกับตำแหน่งนี้ (เช่น ทางลาดเพื่อการช่วยเหลือพิเศษหรือทางเข้าเพื่อการใช้งาน)
dropOffLocations[].pollingHours string คำอธิบายว่าสถานที่นี้เปิดทำการเมื่อใด
dropOffLocations[].name string ชื่อของสถานที่ลงคะแนนล่วงหน้าหรือสถานที่ที่ส่งคืน ช่องนี้ไม่มีข้อมูลสำหรับสถานที่ลงคะแนน
dropOffLocations[].voterServices string บริการที่มาจากเว็บไซต์หรือสถานที่ลงคะแนนล่วงหน้านี้ ช่องนี้ไม่มีข้อมูลสำหรับสถานที่ลงคะแนน
dropOffLocations[].startDate string วันแรกที่อาจใช้เว็บไซต์หรือสถานที่ส่งของก่อนลงคะแนนนี้ ช่องนี้ไม่มีข้อมูลสำหรับสถานที่ลงคะแนน
dropOffLocations[].endDate string วันสุดท้ายที่อาจใช้เว็บไซต์หรือสถานที่ส่งของก่อนลงคะแนนล่วงหน้านี้ ช่องนี้ไม่มีข้อมูลสำหรับสถานที่ลงคะแนน
dropOffLocations[].latitude string ละติจูดของตำแหน่งเป็นองศาทางเหนือของเส้นศูนย์สูตร โปรดทราบว่าฟิลด์นี้อาจไม่พร้อมใช้งานในบางสถานที่
dropOffLocations[].longitude string ลองจิจูดของตำแหน่งในหน่วยองศาทางตะวันออกของเส้นเมริเดียนหลัก โปรดทราบว่าฟิลด์นี้อาจไม่พร้อมใช้งานในบางสถานที่
dropOffLocations[].sources[] list รายการแหล่งที่มาของสถานที่นี้ หากมีการแสดงรายการแหล่งที่มาหลายแหล่ง แสดงว่าข้อมูลที่รวบรวมมาจากแหล่งที่มาเหล่านั้น
dropOffLocations[].sources[].name string ชื่อของแหล่งข้อมูล
dropOffLocations[].sources[].official boolean ข้อมูลนี้มาจากแหล่งที่มาอย่างเป็นทางการของรัฐบาลหรือไม่

การแข่งขัน

ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย Notes
contests[] list การแข่งขันที่จะปรากฏในบัตรลงคะแนนของผู้มีสิทธิเลือกตั้ง
contests[].type string ประเภทของการแข่งขัน โดยปกติตัวเลือกนี้จะเป็น "ทั่วไป" "หลัก" หรือ "การแข่งขันรอบสุดท้าย" สำหรับการแข่งขันกับผู้สมัคร สำหรับการลงประชามติ จะเป็น "การลงประชามติ"
contests[].primaryParty string หากเป็นการเลือกตั้งที่ลำเอียง ให้ระบุชื่อพรรค
contests[].electorateSpecifications string คำอธิบายข้อกำหนดเพิ่มเติมของการได้รับสิทธิ์ในการลงคะแนนเสียงในการแข่งขันนี้
contests[].special string "ใช่" หรือ "ไม่ใช่" ขึ้นอยู่กับว่านี่เป็นการแข่งขันที่จัดขึ้นนอกรอบการเลือกตั้งปกติหรือไม่
contests[].ballotTitle string ชื่ออย่างเป็นทางการในบัตรลงคะแนนสำหรับการแข่งขันนี้ หากมี
contests[].office string ชื่อสำนักงานสำหรับการแข่งขันนี้
contests[].level[] list ระดับของหน่วยงานราชการสำหรับการประกวดครั้งนี้ อย่างไรก็ตาม อาจมีกรณีมากกว่า 1 ข้อในกรณีที่เขตอำนาจศาลมีอำนาจหน้าที่ในการปกครอง 2 ระดับอย่างมีประสิทธิภาพ เช่น นายกเทศมนตรีของดิสตริกต์ออฟโคลัมเบียทำหน้าที่ในระดับ locality แต่ก็มีผลทั้ง administrativeArea2และadministrativeArea1ด้วย

ค่าที่ถูกต้อง ได้แก่
  • international -- รัฐบาลระหว่างประเทศ เช่น สหประชาชาติหรือสหภาพยุโรป
  • country -- รัฐบาลระดับชาติ เช่น รัฐบาลสหพันธรัฐของสหรัฐอเมริกา
  • administrativeArea1 - รัฐบาลของเขตการปกครองระดับบนสุดของประเทศหนึ่งๆ เช่น รัฐในสหรัฐอเมริกา
  • regional -- รัฐบาลประจำภูมิภาคที่มีเขตอำนาจศาลอาจข้ามเขตการปกครองมาตรฐานได้ รัฐบาลเหล่านี้ไม่แพร่หลายในสหรัฐอเมริกาแต่พบได้ทั่วไปในเมืองใหญ่ๆ ในประเทศอื่นๆ
  • administrativeArea2 -- รัฐบาลของเขตปกครองระดับ 2 ของประเทศ เช่น เคาน์ตีในสหรัฐอเมริกา
  • locality - รัฐบาลระดับเมืองหรือเทศบาล
  • subLocality1 - รัฐบาลของเขตการปกครองระดับบนสุดของเมือง เช่น เขตการปกครองของวอชิงตัน ดี.ซี.
  • subLocality2 - รัฐบาลของหน่วยงานย่อยด้านการปกครองระดับ 2 ของเมือง เช่น สภาผู้นำทางความคิดของวอชิงตัน ดี.ซี.
  • special - เขตในท้องถิ่นที่สร้างขึ้นสำหรับหน่วยงานปกครองที่มีวัตถุประสงค์พิเศษเท่านั้น เช่น เขตอนุรักษ์ดินและน้ำ
contests[].roles[] list บทบาทของสำนักงานการแข่งขันนี้ บทบาทไม่ได้ออกแบบมาให้ละเอียดถี่ถ้วนหรือระบุความรับผิดชอบทั้งหมดของสำนักงานหนึ่งๆ แต่ควรเป็นหมวดหมู่คร่าวๆ ที่มีประโยชน์สำหรับการเลือกหรือจัดเรียงรายชื่อสำนักงานทั่วไป

ค่าที่ใช้ได้ ได้แก่
  • headOfState -- หัวหน้าตัวแทนสาธารณะของรัฐบาล โดยทั่วไปประมุขแห่งรัฐของประเทศหนึ่งจะเรียกว่าประธานาธิบดี
  • headOfGovernment ประธานเจ้าหน้าที่บริหารของรัฐบาล ในสหรัฐอเมริกา บุคคลนี้คือประธานาธิบดี ส่วนประเทศอื่นๆ มักจะเป็นนายกรัฐมนตรี ส่วนในระดับที่ต่ำกว่านี้อาจเป็นผู้ว่าการรัฐหรือนายกเทศมนตรี
  • deputyHeadOfGovernment - เจ้าหน้าที่ผู้รับผิดชอบการสวมบทบาทเป็นหัวหน้ารัฐบาลในกรณีที่คุณเสียชีวิตหรือไม่สามารถดำรงตำแหน่งหัวหน้ารัฐบาลที่ได้รับเลือก รองประธานาธิบดีในสหรัฐอเมริกา สำนักงานนี้อาจมีหน้าที่อื่นด้วย
  • governmentOfficer - เจ้าหน้าที่สาขาที่ได้รับเลือก ในรัฐในสหรัฐอเมริกา บทบาทนี้อาจรวมถึงบทบาทต่างๆ เช่น อัยการสูงสุด ทนายกฏหมาย เลขาธิการหรือรัฐ หรือเหรัญญิก
  • executiveCouncil - เป็นสมาชิกของคณะกรรมการบริหารที่ปฏิบัติหน้าที่ตามบทบาทระดับผู้บริหารสาขาเป็นกลุ่ม ตัวอย่างเช่น กรรมาธิการมณฑลในรัฐอินดีแอนา
  • legislatorUpperBody - เป็นสมาชิกสภาฝ่ายบนของสภานิติบัญญัติที่มีสมาชิก 2 ฝ่าย หรือเป็นสมาชิกฝ่ายเดียวของสภานิติบัญญัติที่มีกฎหมายเดียว
  • legislatorLowerBody - เป็นสมาชิกสภานิติบัญญัติที่มีสมาชิก 2 ฝ่ายในส่วนล่าง
  • highestCourtJudge - ผู้พิพากษาของศาลชั้นต้นของรัฐบาลแห่งใดแห่งหนึ่ง เช่น ศาลฎีกาแห่งรัฐ
  • judge - ผู้พิพากษาในศาลใดก็ตามที่ไม่ใช่ศาลชั้นต้นของรัฐบาลที่ทำหน้าที่แทน
  • schoolBoard - เป็นสมาชิกคณะกรรมการโรงเรียนท้องถิ่น
  • specialPurposeOfficer - เจ้าหน้าที่ที่ทำหน้าที่ตามวัตถุประสงค์ที่กำหนดไว้เพียงวัตถุประสงค์เดียว เช่น เป็นสมาชิกคณะกรรมการอนุรักษ์ดินและน้ำ หรือเจ้าหน้าที่ป้องกันยุง
contests[].district nested object ข้อมูลเกี่ยวกับเขตเลือกตั้งที่มีการแข่งขันนี้
contests[].district.name string ชื่อเขต
contests[].district.scope string ขอบเขตทางภูมิศาสตร์ของเขตนี้ หากไม่ระบุ พื้นที่ทางภูมิศาสตร์ของเขตนั้นๆ ข้อใดข้อหนึ่ง: ระดับชาติ ทั่วรัฐ รัฐสภา รัฐตอนบน รัฐด้านล่าง เขตการปกครอง คณะกรรมการโรงเรียน เขตเมือง เขตชุมชน เทศบาลเมือง เขตปกครอง เทศบาลเมือง เขตพิเศษ

ค่าที่ยอมรับ ได้แก่
  • "cityCouncil"
  • "citywide"
  • "congressional"
  • "countyCouncil"
  • "countywide"
  • "judicial"
  • "national"
  • "schoolBoard"
  • "special"
  • "stateLower"
  • "stateUpper"
  • "statewide"
  • "township"
  • "ward"
contests[].district.id string ตัวระบุสำหรับเขตนี้ซึ่งเกี่ยวข้องกับขอบเขตของเขตนี้ ตัวอย่างเช่น เขตวุฒิสภาแห่งรัฐครั้งที่ 34 จะมีรหัส "34" และขอบเขตของ StateUpper
contests[].numberElected long จำนวนผู้สมัครที่จะได้รับเลือกให้ดำรงตำแหน่งในการแข่งขันนี้
contests[].numberVotingFor long จำนวนผู้สมัครที่ผู้มีสิทธิเลือกตั้งสามารถลงคะแนนในการแข่งขันนี้
contests[].ballotPlacement long ตัวเลขที่ระบุตำแหน่งของการแข่งขันนี้ในบัตรลงคะแนนของผู้มีสิทธิเลือกตั้ง
contests[].candidates[] list ตัวเลือกของผู้สมัครสำหรับการแข่งขันนี้
contests[].candidates[].name string ชื่อผู้สมัคร
contests[].candidates[].party string ชื่อและนามสกุลของพรรคการเมืองที่ผู้สมัครเป็นสมาชิก
contests[].candidates[].candidateUrl string URL สำหรับเว็บไซต์หาเสียงของผู้สมัคร
contests[].candidates[].phone string หมายเลขโทรศัพท์เสียงประจำสำนักงานหาเสียงเลือกตั้งของผู้สมัคร
contests[].candidates[].photoUrl string URL สำหรับรูปภาพของผู้สมัคร
contests[].candidates[].email string อีเมลสำหรับแคมเปญของผู้สมัคร
contests[].candidates[].orderOnBallot long ลำดับที่ผู้สมัครปรากฏอยู่ในบัตรลงคะแนนสำหรับการแข่งขันนี้
contests[].candidates[].channels[] list รายชื่อช่องทางโซเชียลมีเดีย (โซเชียล) ที่รู้จักสำหรับผู้สมัครรายนี้
contests[].candidates[].channels[].type string ประเภทของช่อง ประเภทช่องมีดังนี้ โดยเราจะเพิ่มช่องประเภทอื่นๆ ในภายหลัง ข้อใดข้อหนึ่ง:
  • GooglePlus
  • YouTube
  • Facebook
  • Twitter
contests[].candidates[].channels[].id string ตัวระบุสาธารณะที่ไม่ซ้ำกันสำหรับช่องของผู้สมัคร
contests[].referendumTitle string ชื่อของประชามติ (เช่น "ข้อเสนอ 42") ช่องนี้จะมีข้อมูลสำหรับการแข่งขันประเภท "อ้างอิง" เท่านั้น
contests[].referendumSubtitle string คำอธิบายสั้นๆ เกี่ยวกับการลงประชามติ ช่องนี้จะมีข้อมูลสำหรับการแข่งขันประเภท "อ้างอิง" เท่านั้น
contests[].referendumUrl string ลิงก์ไปยังการลงประชามติ ช่องนี้จะมีข้อมูลสำหรับการแข่งขันประเภท "อ้างอิง" เท่านั้น
contests[].referendumBrief string ระบุข้อมูลสรุปสั้นๆ เกี่ยวกับการลงประชามติที่โดยทั่วไปจะอยู่ในบัตรลงคะแนนใต้ชื่อ แต่อยู่เหนือข้อความ ช่องนี้จะมีข้อมูลสำหรับการแข่งขันประเภท "อ้างอิง" เท่านั้น
contests[].referendumText string ข้อความทั้งหมดของการลงประชามติ ช่องนี้จะมีข้อมูลสำหรับการแข่งขันประเภท "อ้างอิง" เท่านั้น
contests[].referendumProStatement string คำแถลงที่สนับสนุนการลงประชามติ ไม่จำเป็นต้องปรากฏในบัตรลงคะแนน ช่องนี้จะมีข้อมูลสำหรับการแข่งขันประเภท "อ้างอิง" เท่านั้น
contests[].referendumConStatement string แถลงการณ์ที่คัดค้านการลงประชามติ ไม่จำเป็นต้องปรากฏในบัตรลงคะแนน ช่องนี้จะมีข้อมูลสำหรับการแข่งขันประเภท "อ้างอิง" เท่านั้น
contests[].referendumPassageThreshold string เกณฑ์คะแนนเสียงที่การลงประชามติต้องใช้เพื่อให้ผ่าน เช่น "2 ใน 3" ช่องนี้จะมีข้อมูลสำหรับการแข่งขันประเภท "อ้างอิง" เท่านั้น
contests[].referendumEffectOfAbstain string ระบุว่าการไม่ยอมรับผลเสีย (ไม่ใช่การลงคะแนนเสียง) ที่มีต่อข้อเสนอจะมีผลอย่างไร (เช่น การงดออกเสียงจะถือว่าเป็นการลงคะแนนเสียงไม่เห็นด้วยหรือไม่) ช่องนี้จะมีข้อมูลสำหรับการแข่งขันประเภท "อ้างอิง" เท่านั้น
contests[].referendumBallotResponses[] list ชุดคำตอบลงประชามติสำหรับการลงประชามติ การตอบบัตรลงคะแนนหมายถึงบรรทัดที่อยู่ในบัตรลงคะแนน ตัวอย่างทั่วไปอาจรวมถึง "ใช่" หรือ "ไม่" สำหรับการลงประชามติ หรือชื่อของผู้ตัดสินสำหรับการแข่งขันการเก็บรักษาระหว่างดำเนินคดี ช่องนี้จะมีข้อมูลสำหรับการแข่งขันประเภท "อ้างอิง" เท่านั้น
contests[].sources[] list รายชื่อแหล่งที่มาของการแข่งขันนี้ หากมีแหล่งที่มาหลายแหล่งอยู่ในรายการ แสดงว่าข้อมูลที่รวบรวมมาจากแหล่งที่มาเหล่านั้น
contests[].sources[].name string ชื่อของแหล่งข้อมูล
contests[].sources[].official boolean ข้อมูลนี้มาจากแหล่งที่มาอย่างเป็นทางการของรัฐบาลหรือไม่

เจ้าหน้าที่การเลือกตั้ง

ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย Notes
state[] list ข้อมูลการเลือกตั้งท้องถิ่นของรัฐที่ผู้มีสิทธิเลือกตั้งลงคะแนนเสียง สำหรับสหรัฐอเมริกา จะมีเพียงองค์ประกอบเดียวในอาร์เรย์นี้
state[].name string ชื่อของเขตอำนาจศาล
state[].electionAdministrationBody nested object หน่วยงานบริหารการเลือกตั้งสำหรับพื้นที่นี้
state[].electionAdministrationBody.name string ชื่อขององค์กรบริหารการเลือกตั้งนี้
state[].electionAdministrationBody.electionInfoUrl string URL ที่ได้รับจากหน่วยงานบริหารนี้เพื่อใช้ค้นหาข้อมูลการเลือกตั้งทั่วไป
state[].electionAdministrationBody.electionRegistrationUrl string URL ที่ได้รับจากหน่วยงานบริหารนี้สำหรับหาวิธีลงทะเบียนเพื่อลงคะแนนเสียง
state[].electionAdministrationBody.electionRegistrationConfirmationUrl string URL ที่ได้รับจากหน่วยงานบริหารนี้เพื่อยืนยันว่าผู้มีสิทธิเลือกตั้งได้ลงทะเบียนเพื่อลงคะแนนเสียง
state[].electionAdministrationBody.electionNoticeText string นาทีสุดท้ายหรือข้อความแจ้งเตือนเหตุฉุกเฉินโดยหน่วยงานดูแลระบบนี้
state[].electionAdministrationBody.electionNoticeUrl string URL ที่ระบุโดยหน่วยงานดูแลระบบนี้สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการแจ้งเตือนในนาทีสุดท้ายหรือการแจ้งเตือนเหตุฉุกเฉิน
state[].electionAdministrationBody.absenteeVotingInfoUrl string URL ที่ได้รับจากหน่วยงานบริหารนี้สำหรับข้อมูลเกี่ยวกับการลงคะแนนเสียงเลือกตั้งล่วงหน้า
state[].electionAdministrationBody.votingLocationFinderUrl string URL ที่หน่วยงานบริหารนี้ให้ไว้สําหรับการค้นหาสถานที่ลงคะแนนเสียง
state[].electionAdministrationBody.ballotInfoUrl string URL ที่ได้รับจากหน่วยงานบริหารนี้เพื่อให้ข้อมูลการแข่งขันแก่ผู้มีสิทธิเลือกตั้ง
state[].electionAdministrationBody.electionRulesUrl string URL ที่ได้รับจากหน่วยงานบริหารนี้ซึ่งอธิบายกฎการเลือกตั้งแก่ผู้มีสิทธิเลือกตั้ง
state[].electionAdministrationBody.voter_services[] list คำอธิบายของบริการที่หน่วยงานบริหารจัดการนี้อาจให้บริการ
state[].electionAdministrationBody.hoursOfOperation string คำอธิบายเวลาทำการของหน่วยงานบริหารจัดการนี้
state[].electionAdministrationBody.correspondenceAddress nested object ที่อยู่จัดส่งของหน่วยงานบริหารนี้
state[].electionAdministrationBody.correspondenceAddress.locationName string ชื่อของสถานที่ตั้ง
state[].electionAdministrationBody.correspondenceAddress.line1 string ชื่อถนนและเลขที่ของที่อยู่นี้
state[].electionAdministrationBody.correspondenceAddress.line2 string บรรทัดที่ 2 คือที่อยู่ หากจำเป็น
state[].electionAdministrationBody.correspondenceAddress.line3 string บรรทัดที่ 3 ของที่อยู่ หากจำเป็น
state[].electionAdministrationBody.correspondenceAddress.city string เมืองสำหรับที่อยู่
state[].electionAdministrationBody.correspondenceAddress.state string อักษรย่อรัฐ 2 ตัวของสหรัฐอเมริกาของที่อยู่
state[].electionAdministrationBody.correspondenceAddress.zip string รหัสไปรษณีย์ของสหรัฐอเมริกาของที่อยู่
state[].electionAdministrationBody.physicalAddress nested object ที่อยู่จริงของหน่วยงานบริหารนี้
state[].electionAdministrationBody.physicalAddress.locationName string ชื่อของสถานที่ตั้ง
state[].electionAdministrationBody.physicalAddress.line1 string ชื่อถนนและเลขที่ของที่อยู่นี้
state[].electionAdministrationBody.physicalAddress.line2 string บรรทัดที่ 2 คือที่อยู่ หากจำเป็น
state[].electionAdministrationBody.physicalAddress.line3 string บรรทัดที่ 3 ของที่อยู่ หากจำเป็น
state[].electionAdministrationBody.physicalAddress.city string เมืองสำหรับที่อยู่
state[].electionAdministrationBody.physicalAddress.state string อักษรย่อรัฐ 2 ตัวของสหรัฐอเมริกาของที่อยู่
state[].electionAdministrationBody.physicalAddress.zip string รหัสไปรษณีย์ของสหรัฐอเมริกาของที่อยู่
state[].electionAdministrationBody.electionOfficials[] list เจ้าหน้าที่การเลือกตั้งของหน่วยงานบริหารการเลือกตั้งนี้
state[].electionAdministrationBody.electionOfficials[].name string ชื่อและนามสกุลของเจ้าหน้าที่การเลือกตั้ง
state[].electionAdministrationBody.electionOfficials[].title string ชื่อของเจ้าหน้าที่การเลือกตั้ง
state[].electionAdministrationBody.electionOfficials[].officePhoneNumber string หมายเลขโทรศัพท์ของเจ้าหน้าที่การเลือกตั้ง
state[].electionAdministrationBody.electionOfficials[].faxNumber string หมายเลขแฟกซ์ของเจ้าหน้าที่การเลือกตั้ง
state[].electionAdministrationBody.electionOfficials[].emailAddress string อีเมลของเจ้าหน้าที่การเลือกตั้ง
state[].local_jurisdiction nested object เมืองหรือเคาน์ตีที่ให้ข้อมูลการเลือกตั้งผู้มีสิทธิเลือกตั้งรายนี้ ออบเจ็กต์นี้อาจมีองค์ประกอบเดียวกันกับสถานะ
state[].sources[] list รายการแหล่งที่มาของพื้นที่นี้ หากมีการแสดงรายการแหล่งที่มาหลายแหล่ง แสดงว่าข้อมูลที่รวบรวมมาจากแหล่งที่มาเหล่านั้น
state[].sources[].name string ชื่อของแหล่งข้อมูล
state[].sources[].official boolean ข้อมูลนี้มาจากแหล่งที่มาอย่างเป็นทางการของรัฐบาลหรือไม่

ลองใช้เลย