การแข่งขัน

ใช้ Contest เพื่ออธิบายการแข่งขันและลิงก์การแข่งขันกับ ผู้สมัครรับเลือกตั้งและพรรคที่เกี่ยวข้อง

เอกสารนี้จะกล่าวถึง Contest และเอนทิตีย่อยของ Contest ดังนี้

  • Contest
    • CandidateContest
    • PartyContest
    • BallotMeasureContest
    • RetentionContest

ประเภท

Contest เป็นองค์ประกอบนามธรรมที่มี 3 ประเภทซึ่งใช้ตาม ประเภทของการแข่งขัน

  • CandidateContest: ใช้ประเภทนี้เมื่อContest เกี่ยวข้องกับผู้สมัครรับเลือกตั้งตั้งแต่ 1 คนขึ้นไป
  • PartyContest: ใช้ประเภทนี้เมื่อContestมีตัวเลือกรายชื่อพรรค ในการลงคะแนน นอกจากนี้ ยังใช้เป็น การแข่งขันเสมือนจริงซึ่งเป็นสรุปของการแข่งขันขนาดเล็กหลายรายการได้ด้วย
  • BallotMeasureContest: ใช้ประเภทนี้เมื่อContestเกี่ยวข้องกับมาตรการลงคะแนนตั้งแต่ 1 รายการขึ้นไป
  • RetentionContest: ใช้ประเภทนี้เมื่อContest เกี่ยวข้องกับการลงประชามติเพื่อตัดสินว่าเจ้าหน้าที่ที่ได้รับเลือกควรอยู่ในตำแหน่งต่อไป หรือถูกถอดออกจากตำแหน่ง

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

Attributes

ตารางต่อไปนี้อธิบายแอตทริบิวต์สำหรับ Contest

แอตทริบิวต์ จำเป็นหรือไม่ ประเภท คำอธิบาย
objectId ต้องระบุ ID ตัวระบุภายในที่ไม่ซ้ำกันซึ่งองค์ประกอบอื่นๆ ใช้เพื่ออ้างอิงถึง องค์ประกอบนี้

องค์ประกอบ

ตารางต่อไปนี้จะอธิบายองค์ประกอบสำหรับ Contest

องค์ประกอบ ความหลากหลาย ประเภท คำอธิบาย
Abbreviation 0 หรือ 1 string ชื่อย่อของการแข่งขัน
AggregateBallotSelection 0 หรือ 1 SpecialBallotSelection การเลือกบัตรลงคะแนนสำหรับการรวบรวมจำนวนคะแนน เช่น การรวบรวม ผู้สมัครหลายคนเป็น "อื่นๆ"
BallotSelection 0 ขึ้นไป BallotSelection

เชื่อมโยงตัวเลือกในบัตรเลือกตั้งกับการแข่งขัน ลำดับ ของผู้สมัครรับเลือกตั้งหรือพรรคการเมืองใน Contest ต้องเหมือนกับ ลำดับใน BallotSelection

หากมี BallotSelection.SequenceOrder สำหรับทุกรายการ ระบบจะใช้เป็นลำดับเริ่มต้นสำหรับการ เลือก

BallotSubTitle 0 หรือ 1 InternationalizedText คำบรรยายของการแข่งขัน ซึ่งต้องตรงกับที่ปรากฏในบัตรลงคะแนนของผู้มีสิทธิเลือกตั้ง
BallotTitle 0 หรือ 1 InternationalizedText ชื่อการแข่งขัน ข้อความชื่อควรสอดคล้องกับคำแนะนำด้านไวยากรณ์ สำหรับการแข่งขันลงประชามติ ชื่อควรตรงกับข้อความในบัตรลงคะแนน
BlankBallotSelection 0 หรือ 1 SpecialBallotSelection การเลือกบัตรลงคะแนนสำหรับบัตรลงคะแนนที่ว่างเปล่า
ComposingContestIds 0 ขึ้นไป IDREFS

ใช้เพื่อกำหนดการแข่งขันแบบสรุป ตัวอย่างเช่น ในการเลือกตั้งทั่วไปของประธานาธิบดีสหรัฐอเมริกา มีการแข่งขันระดับประเทศที่มีการสร้าง รหัสการแข่งขันสำหรับการเลือกตั้งระดับรัฐแต่ละครั้ง

ComposingContest ต้องมีขอบเขตที่เล็กกว่า การแข่งขันระดับบนสุดและต้องเกิดขึ้นในรอบเดียวกันของการ เลือกตั้ง

ContestDateStatus 0 หรือ 1 DateStatus

องค์ประกอบนี้ระบุการอัปเดตการกำหนดเวลาสำหรับการเลือกตั้ง ค่าเริ่มต้นคือ confirmed ในกรณีส่วนใหญ่ ค่า ContestDateStatus ควรตรงกับ ElectionDateStatus ของ Election ที่มีค่าดังกล่าว

CountingDate 0 หรือ 1 PartialDate วันที่หลังการลงคะแนนเสียงเมื่อมีการนับคะแนนสำหรับการแข่งขันในการเลือกตั้ง ควรระบุเฉพาะในกรณีที่วันนับคะแนนแตกต่างจาก วันสุดท้ายของการโหวต เช่น การเลือกตั้ง Lok Sabha ของอินเดีย กรณีทั่วไปคือการนับคะแนนจะเกิดขึ้นในวันเดียวกับวันสุดท้ายของการลงคะแนน ซึ่งก็คือวันที่ EndDate ของการเลือกตั้ง
CurrentResultsReportingStage 1 ResultsReportingStageType ขั้นตอนปัจจุบันของการรายงานผลการแข่งขัน
EarliestPollsClose 0 หรือ 1 dateTime เมื่อปิดหีบเลือกตั้งแรก การประกวดแต่งเพลงจะรับค่านี้จากการประกวดระดับบนหากไม่มี
ElectoralDistrictId 1 IDREF

ตัวระบุที่ไม่ซ้ำกันสำหรับองค์ประกอบ GpUnit เชื่อมโยงการแข่งขันกับหน่วยการรายงานที่แสดงถึง ขอบเขตทางภูมิศาสตร์ของการแข่งขัน เช่น เขต

เช่น สำหรับการแข่งขันที่เฉพาะเจาะจง ElectoralDistrictId อาจอ้างอิงถึง ReportingUnit ที่กำหนดไว้สำหรับ เขตที่เชื่อมโยงกับการแข่งขัน Office รวมถึงการอ้างอิงที่ไม่บังคับซึ่งมีวัตถุประสงค์เดียวกันด้วย เช่น สำหรับการแข่งขันระดับประเทศ คุณสามารถใช้ GpUnit เดียวกันที่กำหนดไว้สำหรับประเทศนั้นซ้ำได้

ExternalIdentifiers 1 ExternalIdentifiers เชื่อมโยงรหัสกับการแข่งขัน ต้องมี ตัวระบุที่เสถียร หากต้องการระบุขั้นตอนของผลการเลือกตั้งที่ฟีดรายงาน ให้ตั้งค่า OtherType โดยใช้ค่าจาก ContestStage
EndDate 0 หรือ 1 PartialDate วันที่สิ้นสุดของปฏิทินการแข่งขัน ใช้วันที่ที่การลงคะแนน สิ้นสุด เช่น 2022-11-08 ควรตั้งวันที่สิ้นสุดก็ต่อเมื่อวันที่เริ่มต้น และวันที่สิ้นสุดของ Contest แตกต่างจากวันที่เริ่มต้นและวันที่สิ้นสุด ของ Election
FilingDeadline 0 หรือ 1 PartialDate วันที่ที่ผู้สมัครต้องยื่นเอกสารเพื่อเข้าร่วมการแข่งขัน
HasRotation 0 หรือ 1 boolean ระบุว่ามีการหมุนเวียนการเลือกในการแข่งขันหรือไม่ หากไม่มีองค์ประกอบนี้ ค่าเริ่มต้นจะเป็น false
IsNotable 0 หรือ 1 boolean พิจารณาว่าเอนทิตีนั้นน่าสนใจหรือไม่ ระบบจะถือว่าเป็น false หากไม่ได้ระบุ
LatestPollsClose 0 หรือ 1 dateTime เมื่อปิดการลงคะแนนครั้งสุดท้าย การประกวดแต่งเพลงจะรับค่านี้จากการประกวดระดับบนหากไม่มี
Name 1 string ชื่อนี้ควรตรงกับBallotTitleที่เป็นภาษาอังกฤษและสอดคล้อง กับไวยากรณ์ของชื่อ
NoneOfTheAboveBallotSelection 0 หรือ 1 SpecialBallotSelection การเลือกบัตรลงคะแนนสำหรับตัวเลือกในบัตรลงคะแนนเพื่อโหวต "ไม่มีตัวเลือกข้างต้น" หรือการเลือกที่เทียบเท่า เช่น "ไม่มี" "ไม่มีตัวเลือกเหล่านี้" หรือ "ยังไม่ตัดสินใจ"
NullBallotSelection 0 หรือ 1 SpecialBallotSelection การเลือกบัตรลงคะแนนสำหรับบัตรลงคะแนนที่เป็นค่าว่างหรือบัตรลงคะแนนที่เสีย บัตรเลือกตั้งเหล่านี้ มีการทำเครื่องหมายในลักษณะที่นับคะแนนเสียงได้อย่างไม่ถูกต้อง ตัวอย่างบัตรเสีย ได้แก่ บัตรที่ฉีกขาด สกปรก ทำเครื่องหมายมากเกินไปหรือน้อยเกินไป หรือทำเครื่องหมายในลักษณะที่ระบุตัว ผู้ลงคะแนนเสียงได้
Seat 0 หรือ 1 string ที่นั่งที่เฉพาะเจาะจงสำหรับการแข่งขัน
SequenceOrder 0 หรือ 1 integer

ลำดับเริ่มต้นขององค์ประกอบ Contest เพื่อวัตถุประสงค์ ในการแสดงผลลัพธ์ การแข่งขันจะแสดงตาม กฎต่อไปนี้

  • หากการแข่งขัน 2 รายการมีค่าเหมือนกัน ระบบอาจแสดงการแข่งขันเหล่านั้นตามลำดับที่ไม่แน่นอน
  • การแข่งขันทั้งหมดที่มี SequenceOrder จะแสดงตามลำดับนั้น ตามด้วยการแข่งขันทั้งหมดที่ไม่มีค่า SequenceOrder โดยไม่มีลำดับที่กำหนด

ใช้ SequenceOrder เพื่อจัดลำดับผลการค้นหาที่แสดง เช่น 100 อาจระบุการแข่งขันระดับภูมิภาค 200 อาจระบุการแข่งขันระดับท้องถิ่น เป็นต้น SequenceOrder ไม่เหมาะสมที่จะใช้เป็นลำดับการแข่งขัน ในการลงคะแนนเสียง แต่จะยังคงลำดับการแข่งขันในการลงคะแนนเสียงแต่ละครั้งได้ อย่างไรก็ตาม ให้ใช้เอนทิตี BallotStyle ซึ่งเชื่อมโยง รูปแบบบัตรลงคะแนนกับหน่วยภูมิศาสตร์การเมืองที่เกี่ยวข้อง

StartDate 0 หรือ 1 PartialDate วันที่เริ่มต้นการแข่งขันในปฏิทิน ใช้วันที่ที่การสำรวจ เริ่มขึ้น เช่น 2022-11-08 ควรตั้งวันที่เริ่มต้นเฉพาะในกรณีที่วันที่เริ่มต้นและวันที่สิ้นสุดของ Contest แตกต่างจากวันที่เริ่มต้นและวันที่สิ้นสุดของ Election
SubsequentContestId 0 หรือ 1 IDREF

ใช้เพื่อชี้ไปยังการแข่งขันในภายหลังในชุดที่เกี่ยวข้องเดียวกัน เช่น ในการเลือกตั้งของสหรัฐอเมริกา โดยปกติแล้วลิงก์จะชี้จากการเลือกตั้งขั้นต้นไปยังการเลือกตั้งทั่วไปที่เกี่ยวข้อง นอกจากนี้ยังชี้จากเลือกตั้งทั่วไปไปยังการเลือกตั้งรอบชิงได้ด้วย

โดยปกติแล้ว SubsequentContest จะมีขอบเขตเดียวกัน กับการแข่งขันก่อนหน้า

SubUnitsReported 0 หรือ 1 integer จำนวนหน่วยย่อย เช่น เขตเลือกตั้งที่รายงานผลคะแนนการแข่งขันนี้เสร็จสมบูรณ์แล้ว
SummaryCounts 0 ขึ้นไป SummaryCounts แสดงสรุปจำนวนอื่นๆ ที่เกี่ยวข้องกับการแข่งขัน ซึ่งรวมถึงจำนวนบัตรเลือกตั้งทั้งหมดที่มีการลงคะแนน ในการแข่งขัน และจำนวนการงดออกเสียง การลงคะแนนเกิน การลงคะแนนไม่ครบ หรือ การเขียนชื่อผู้สมัครรับเลือกตั้ง คุณเชื่อมโยงจํานวนสรุปกับการแข่งขันโดยรวมหรือกับหน่วยการรายงานระดับล่างอื่นๆ ได้โดยใช้SummaryCountsหลายรายการ
TotalSubUnits 0 หรือ 1 integer จำนวนหน่วยย่อยทั้งหมด เช่น เขตเลือกตั้งที่มีการ แข่งขันนี้ในบัตรเลือกตั้ง
VoteVariation 0 หรือ 1 VoteVariation ประเภทการโหวตที่เชื่อมโยงกับการแข่งขัน เช่น n-of-m
OtherVoteVariation 0 หรือ 1 string ใช้เพื่อระบุค่าที่กำหนดเองเมื่อ VoteVariation เป็น other
ResultsEmbargoEnd 0 หรือ 1 dateTime เมื่อสิ้นสุดการห้ามเผยแพร่ผลการเลือกตั้ง การประกวดที่สร้างขึ้นจะรับค่านี้จากการประกวดหลักหากไม่มี
ResultsExpected 0 หรือ 1 dateTime เมื่อคาดว่าจะเห็นผลการนับคะแนนเสียงครั้งแรกในฟีด การประกวดที่ประกอบขึ้นจะรับค่านี้จากการประกวดหลักหากไม่มีค่า
ResultsReportingStageCollection 0 หรือ 1 ไม่มี องค์ประกอบ Wrapper สำหรับ คำจำกัดความของ ResultsReportingStage โปรดดูรายละเอียดเพิ่มเติมที่ เอนทิตีคอลเล็กชัน

CandidateContest

ใช้ CandidateContest เพื่ออธิบายการแข่งขันที่มีการเลือกผู้เข้าแข่งขัน 1 คนขึ้นไป

เอนทิตีนี้จะอ้างอิง Office หรือ Party ตามรหัสก็ได้ เราไม่รองรับการ แสดงตั๋วของผู้สมัครรับเลือกตั้งในการแข่งขันเดียวกัน คุณอ้างอิงได้เพียง Office เดียว เช่น หากต้องการจัดการแข่งขันCandidate สำหรับตำแหน่งประธานาธิบดีและรองประธานาธิบดี คุณจะต้องมีการแข่งขัน 2 รายการ แต่ละรายการ จะอ้างอิงถึงสำนักงานที่แตกต่างกัน

องค์ประกอบ

ตารางต่อไปนี้จะอธิบายองค์ประกอบสำหรับ CandidateContest

องค์ประกอบ ความหลากหลาย ประเภท คำอธิบาย
NumberElected 0 หรือ 1 integer จำนวนผู้สมัครรับเลือกตั้งที่ได้รับเลือกในการแข่งขัน ซึ่งเป็น n ของการแข่งขัน n-of-m หากไม่มี NumberElected ในฟีด ระบบจะใช้ค่าเริ่มต้นเป็น 1
OfficeIds 1 IDREFS ตัวระบุที่ไม่ซ้ำกันสำหรับองค์ประกอบ Office อย่างน้อย 1 รายการ เชื่อมโยงคำอธิบายสำนักงานกับการแข่งขัน
PrimaryPartyIds 0 ขึ้นไป IDREFS ตัวระบุที่ไม่ซ้ำกันสำหรับองค์ประกอบ Party อย่างน้อย 1 รายการ ซึ่งระบุว่า Contest เป็นส่วนหนึ่งของ การเลือกตั้งขั้นต้นแบบแบ่งพรรค PrimaryPartyId จะมีความหมายเฉพาะในการ เลือกตั้งขั้นต้น
VotesAllowed 1 integer จำนวนการโหวตหรือการเขียนชื่อผู้สมัครรับเลือกตั้งสูงสุดที่อนุญาตต่อผู้มีสิทธิ์เลือกตั้งใน การแข่งขันนี้ หากไม่มี VotesAllowed ในฟีด ระบบจะใช้ค่าเริ่มต้นเป็น 1
Type 0 ขึ้นไป ElectionType ประเภทที่แจกแจงของการแข่งขัน เช่น การเลือกตั้งขั้นต้นหรือการเลือกตั้งทั่วไป ควรตั้งค่าประเภท ของ Contest เฉพาะในกรณีที่แตกต่างจากประเภทของ Election

ตัวอย่าง

XML

    <Contest xsi:type="CandidateContest" objectId="cc1-001">
      <Abbreviation>KENYAPRES</Abbreviation>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-kenyatta">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-odinga">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-mudavadi">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-kenneth">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-dida">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-karua">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-kiyiapi">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-muite">...</BallotSelection>
      <BallotTitle>
        <Text language="en">2022 Kenya Presidential election</Text>
        <Text language="es">2022 Elecciones presidenciales de Kenia</Text>
        <Text language="fr">2022 Élection présidentielle au Kenya</Text>
      </BallotTitle>
      <CountStatus>...</CountStatus>
      <CountingDate>2022-08-11</CountingDate>
      <ElectoralDistrictId>...</ElectoralDistrictId>
      <EndDate>2022-08-09</EndDate>
      <Name>2022 Kenya Presidential election</Name>
      <StartDate>2022-08-09</StartDate>
      <SubUnitsReported>48</SubUnitsReported>
      <SummaryCounts>...</SummaryCounts>
      <TotalSubUnits>48</TotalSubUnits>
      <VoteVariation>1-of-m</VoteVariation>
      <NumberElected>1</NumberElected>
      <OfficeIds>off9999a</OfficeIds>
      <VotesAllowed>1</VotesAllowed>
      <Type>general</Type>
    </Contest>

JSON

    "Contest": [
      {
        "@type": "CandidateContest",
        "objectId": "cc1-001",
        "Abbreviation": "KENYAPRES",
        "BallotSelection": [
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-kenyatta",
            ...
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-odinga",
            ...
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-mudavadi",
            ...
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-kenneth",
            ...
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-dida",
            ...
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-karua",
            ...
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-kiyiapi",
            ...
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-muite",
            ...
          }
        ],
        "BallotTitle": {
          "Text": [
            {
              "value": "2022 Kenya Presidential election",
              "language": "en"
            },
            {
              "value": "2022 Elecciones presidenciales de Kenia",
              "language": "es"
            },
            {
              "value": "2022 Élection présidentielle au Kenya",
              "language": "fr"
            },
          ]
        },
        "CountStatus": "...",
        "ElectoralDistrictId": "...",
        "Name": "2022 Kenya Presidential election",
        "SubUnitsReported": 48,
        "SummaryCounts": "...",
        "TotalSubUnits": 48,
        "VoteVariation": "1-of-m",
        "NumberElected": 1,
        "VotesAllowed": 1,
        "Type": "general"
      }
    ]

PartyContest

ใช้ PartyContest สำหรับการแข่งขันที่ผู้ลงคะแนนเลือกพรรคการเมืองในบัตรเลือกตั้ง นอกจากนี้ ยังใช้ในฟีดผลการเลือกตั้งเป็นรายการสรุปเสมือนได้ด้วย เพื่อสื่อสารข้อมูลรวม (เช่น การแข่งขันของพรรคการเมืองระดับรัฐที่ รวบรวมผลการแข่งขันในเขตเลือกตั้ง)

องค์ประกอบ

ตารางต่อไปนี้จะอธิบายองค์ประกอบสำหรับ PartyContest

องค์ประกอบ ความหลากหลาย ประเภท คำอธิบาย
NumberElected 0 หรือ 1 integer จำนวนผู้สมัครรับเลือกตั้งที่ได้รับเลือกในการแข่งขัน ซึ่งเป็น n ของการแข่งขัน n-of-m หากไม่มี NumberElected ในฟีด ระบบจะใช้ค่าเริ่มต้นเป็น 1
VotesAllowed 0 หรือ 1 integer จำนวนการโหวตหรือการเขียนชื่อผู้สมัครรับเลือกตั้งสูงสุดที่อนุญาตต่อผู้มีสิทธิ์เลือกตั้งใน การแข่งขันนี้ หากไม่มี VotesAllowed ในฟีด ระบบจะใช้ค่าเริ่มต้นเป็น 1
OfficeIds 1 IDREFS ตัวระบุที่ไม่ซ้ำกันสำหรับองค์ประกอบ Office อย่างน้อย 1 รายการ เชื่อมโยงคำอธิบายสำนักงาน กับการแข่งขัน
Type 0 ขึ้นไป ElectionType ประเภทที่แจกแจงของการแข่งขัน เช่น การเลือกตั้งขั้นต้นหรือการเลือกตั้งทั่วไป ควรตั้งค่าประเภท ของ Contest เฉพาะในกรณีที่แตกต่างจากประเภทของ Election

ตัวอย่าง

XML

    <Contest xsi:type="PartyContest" objectId="pc20001">
      <BallotSelection objectId="ps101321" xsi:type="PartySelection">
        <PartyIds>par10132</PartyIds>
      </BallotSelection>
      <BallotSelection objectId="ps101322" xsi:type="PartySelection">
        <PartyIds>par10133</PartyIds>
      </BallotSelection>
      <BallotTitle>
        <Text language="en">Ballot title example</Text>
      </BallotTitle>
      <ContestDateStatus>confirmed</ContestDateStatus>
      <CountingDate>2022-08-11</CountingDate>
      <ElectoralDistrictId>...</ElectoralDistrictId>
      <EndDate>2022-08-09</EndDate>
      <ExternalIdentifiers>...</ExternalIdentifiers>
      <Name>Contest name example</Name>
      <StartDate>2022-08-09</StartDate>
      <VoteVariation>1-of-m</VoteVariation>
      <OfficeIds>off9999a</OfficeIds>
      <Type>general</Type>
      <VotesAllowed>1</VotesAllowed>
    </Contest>

JSON

    "Contest": [
      {
        "@type": "PartyContest",
        "objectId": "pc20001",
        "BallotSelection": [
          {
            "@type": "PartySelection",
            "objectId": "ps101321",
            "PartyIds": [
              "par10132"
            ]
          }
        ],
        "BallotSelection": [
          {
            "@type": "PartySelection",
            "objectId": "ps101322",
            "PartyIds": [
              "par10133"
            ]
          }
        ],
        "BallotTitle": {
          "Text": [
            {
              "value": "Ballot title example",
              "language": "en"
            }
          ]
        },
        "ContestDateStatus": "confirmed",
        "CountingDate": "2022-08-11",
        "ElectoralDistrictId": "...",
        "EndDate": "2022-08-09",
        "ExternalIdentifiers": [
          ...
        ],
        "Name": "Contest name example",
        "StartDate": "2022-08-09",
        "VoteVariation": "1-of-m",
        "OfficeIds": "off9999a",
        "Type": "general",
        "VotesAllowed": 1
      }
    ]

BallotMeasureContest

ใช้ BallotMeasureContest สำหรับการแข่งขันที่เกี่ยวข้องกับมาตรการลงคะแนน

องค์ประกอบ

ตารางต่อไปนี้จะอธิบายองค์ประกอบสำหรับ BallotMeasureContest

องค์ประกอบ ความหลากหลาย ประเภท คำอธิบาย
BallotTitle 1 InternationalizedText

ชื่ออย่างเป็นทางการของบัตรลงคะแนน เช่น Nevada Renewable Energy Standards Initiative ตรวจสอบว่า BallotTitle ไม่ซ้ำกัน

การออกเสียงประชามติบางครั้งมีชื่อรวมชื่อเดียวที่มีคำถามหลายข้อ ซึ่งมีหมายเลขกำกับ ในกรณีนี้ ชื่ออาจมีหมายเลขคำถามเพื่อแยกความแตกต่างระหว่างBallotMeasureContest เอนทิตีที่สร้างขึ้นสำหรับแต่ละคำถาม

BallotSubTitle 0 หรือ 1 InternationalizedText ชื่อรองของบัตรเลือกตั้ง (หากมี)
BallotText 1 InternationalizedText ข้อความที่ปรากฏบนบัตรเลือกตั้ง เช่น Shall Article 4 of the Nevada Constitution be amended to require, beginning in calendar year 2022, that all providers of electric utility services who sell electricity... in Nevada comes from renewable energy resources?
FullText 0 หรือ 1 InternationalizedText

สำเนาข้อความทั้งหมดของมาตรการลงคะแนน ระบุองค์ประกอบนี้ หากมีข้อความเพิ่มเติมที่ไม่ได้อยู่ในบัตรลงคะแนน มีอักขระได้ไม่เกิน 30,000 ตัว

หากข้อความเต็มของมาตรการลงคะแนนสั้นกว่า 30,000 อักขระและไม่มีการจัดรูปแบบใดๆ ที่จะใช้ในไฟล์ฟีดไม่ได้ ให้ใส่ข้อความนั้นใน FullText รวมถึง InfoUri ที่มี URI ที่มีคำอธิบายประกอบของ fulltext ด้วย ไม่เช่นนั้น ให้รวมเฉพาะ URI ที่มีคำอธิบายประกอบ fulltext

InfoUri 0 หรือ 1 AnnotatedUri

URI ที่มีคำอธิบายประกอบซึ่งยอมรับคำอธิบายประกอบต่อไปนี้ แทนที่จะเป็นคำอธิบายประกอบที่ระบุไว้ที่อื่น

  • wikipedia: หน้า Wikipedia เกี่ยวกับมาตรการ ลงคะแนน
  • ballotpedia: หน้า Ballotpedia เกี่ยวกับมาตรการลงคะแนน เช่น https://ballotpedia.org/Nevada_Renewable_Energy_Standards_Initiative_(2020)
  • official-website: เว็บไซต์อย่างเป็นทางการของมาตรการ ลงคะแนน
  • fulltext: หากมีข้อความมากกว่าที่ระบุ ในบัตรลงคะแนน เช่น สำเนาของกฎหมายที่เสนอ นี่คือ URI สำหรับ ข้อความเพิ่มเติมทั้งหมด ตัวอย่างเช่น https://www.nvsos.gov/sos/home/showdocument?id=5330
  • logo-uri: รูปภาพของโลโก้
SummaryText 0 หรือ 1 InternationalizedText

สรุปมาตรการลงคะแนนเสียง ประกอบด้วยย่อหน้าสั้นๆ 1-2 ย่อหน้า และพาร์ทเนอร์สามารถสร้างขึ้นเพื่อสรุปข้อความทั้งหมดของบัตรลงคะแนนได้ เช่น ตัวอย่างต่อไปนี้

Requires utilities to acquire 50 percent of their electricity from renewable resources by 2030

Official Summary:

EXPLANATION—This ballot measure proposes to amend Article 4 of the Nevada Constitution to require all providers of electric utility services that sell electricity to retail customers for consumption in Nevada to meet a Renewable Portfolio Standard (RPS) that would go into effect beginning in calendar year 2022 and increase gradually until the RPS reaches 50 percent in calendar year 2030. According to the Public Utilities Commission of Nevada, an RPS establishes the percentage of electricity sold by an electric utility to retail customers that must come from renewable sources.

ProStatement 0 หรือ 1 InternationalizedText ข้อความที่อธิบายความหมายของการโหวตเห็นด้วยในบัตรลงคะแนนนี้ แต่ไม่ได้เป็นการโต้แย้งเพื่อสนับสนุนมาตรการนี้ เช่น A "yes" vote supports this initiative to require electric utilities to acquire 50 percent of their electricity from renewable resources by 2030.
ConStatement 0 หรือ 1 InternationalizedText ข้อความที่อธิบายความหมายของการโหวตไม่ในการลงประชามตินี้ แต่ไม่ได้เป็นการโต้แย้งมาตรการดังกล่าว เช่น A "no" vote opposes this initiative, thus keeping the existing requirement that electric utilities acquire 25 percent of their electricity from renewable resources by 2025.
Type 0 หรือ 1 BallotMeasureType ประเภทการแจงนับของการลงประชามติ เลือกค่าที่อธิบาย มาตรการลงคะแนนในเขตอำนาจศาลได้ดีที่สุด
PassageThreshold 0 หรือ 1 string สัดส่วนคะแนนเสียงขั้นต่ำที่จำเป็นเพื่อให้ข้อเสนอผ่าน

ตัวอย่าง

XML

     <Contest objectId="bmc0" xsi:type="BallotMeasureContest">
        <BallotSelection objectId="bms00" xsi:type="BallotMeasureSelection">
          <ExternalIdentifiers>
            <ExternalIdentifier>
              <Type>other</Type>
              <OtherType>stable</OtherType>
              <Value>bmc0_yes</Value>
            </ExternalIdentifier>
          </ExternalIdentifiers>
          <Selection>
            <Text language="en">Yes</Text>
          </Selection>
        </BallotSelection>
        <BallotSelection objectId="bms01" xsi:type="BallotMeasureSelection">
          <ExternalIdentifiers>
            <ExternalIdentifier>
              <Type>other</Type>
              <OtherType>stable</OtherType>
              <Value>bmc0_no</Value>
            </ExternalIdentifier>
          </ExternalIdentifiers>
          <Selection>
            <Text language="en">No</Text>
          </Selection>
        </BallotSelection>
        <BallotSubTitle>
          <Text language="en">Farm Animal Confinement Initiative</Text>
        </BallotSubTitle>
        <BallotTitle>
          <Text language="en">
            California Proposition 12, Farm Animal Confinement Initiative (2018)
          </Text>
        </BallotTitle>
        <ElectoralDistrictId>ru_ca_1</ElectoralDistrictId>
        <ExternalIdentifiers>
          <ExternalIdentifier>
            <Type>other</Type>
            <OtherType>stable</OtherType>
            <Value>bmc0</Value>
          </ExternalIdentifier>
        </ExternalIdentifiers>
        <Name>
          California Proposition 12, Farm Animal Confinement Initiative (2018)
        </Name>
        <BallotText>
          <Text language="en">
            Establishes minimum requirements for confining certain farm animals. Prohibits sales of meat and egg products from animals confined in noncomplying manner. Fiscal Impact: Potential decrease in state income tax revenues from farm businesses, likely not more than several million dollars annually. State costs up to $10 million annually to enforce the measure.
          </Text>
        </BallotText>
        <ConStatement>
          <Text language="en">No means the measure will not be enacted
          </Text>
        </ConStatement>
        <InfoUri Annotation="fulltext">
          https://example-government.gov/ballot-measures/California_Proposition_12_2018
        </InfoUri>
        <InfoUri Annotation="wikipedia">
          https://en.wikipedia.org/wiki/2018_California_Proposition_12
        </InfoUri>
        <PassageThreshold>
          <Text language="en">50.01%</Text>
        </PassageThreshold>
        <ProStatement>
          <Text language="en">Yes means the measure will be enacted
          </Text>
        </ProStatement>
        <SummaryText>
          <Text language="en">
            The proposition establishes new minimum requirements on farmers to provide more space for egg-laying hens, breeding pigs, and calves raised for veal. California businesses will be banned from selling eggs or uncooked pork or veal that came from animals housed in ways that did not meet these requirements.
          </Text>
        </SummaryText>
        <Type>ballot-measure</Type>
      </Contest>

JSON

    "Contest": [
      {
        "@type": "BallotMeasureContest",
        "objectId": "bmc0",
        "BallotSelection": [
          {
            "@type": "BallotMeasureSelection",
            "objectId": "bms00",
            "ExternalIdentifiers": {
              "ExternalIdentifier" : [
                {
                  "Type": "other",
                  "OtherType": "stable",
                  "Value": "bmc0_yes"
                }
              ]
            }
          }
            "Text": [
              {
                "value": "Yes",
                "language": "en"
              },
            ]
        ],
        "BallotSelection": [
          {
            "@type": "BallotMeasureSelection",
            "objectId": "bms01",
            "ExternalIdentifiers": {
              "ExternalIdentifier" : [
                {
                  "Type": "other",
                  "OtherType": "stable",
                  "Value": "bmc0_no"
                }
              ]
            }
          }
            "Text": [
              {
                "value": "No",
                "language": "en"
              },
            ]
        ],
        "BallotSubTitle": {
          "Text": [
            {
              "value": "Farm Animal Confinement Initiative",
              "language": "en"
            }
          ]
        },
        "BallotTitle": {
          "Text": [
            {
              "value": "California Proposition 12, Farm Animal Confinement Initiative (2018)",
              "language": "en"
            }
          ]
        },
        "ElectoralDistrictId": "ru_ca_1"
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "bmc0"
            }
          ]
        },
        "Name": "California Proposition 12, Farm Animal Confinement Initiative (2018)",
        "BallotText": [
          "Text": [
            {
              "value": "Establishes minimum requirements for confining certain farm animals. Prohibits sales of meat and egg products from animals confined in noncomplying manner. Fiscal Impact: Potential decrease in state income tax revenues from farm businesses, likely not more than several million dollars annually. State costs up to $10 million annually to enforce the measure.",
              "language": "en"
            }
          ]
        ],
        "ConStatement": [
          "Text": [
            {
              "value": "No means the measure will not be enacted",
              "language": "en"
            }
          ]
        ],
        "InfoUri": [
          {
            "value": "https://example-government.gov/ballot-measures/California_Proposition_12_2018",
            "Annotation": "fulltext"
          }
        ],
        "InfoUri": [
          {
            "value": "https://en.wikipedia.org/wiki/2018_California_Proposition_12",
            "Annotation": "wikipedia"
          }
        ],
        "PassageThreshold": [
            "Text": [
              {
                  "value": "50.01%",
                  "language": "en"
            }
          ]
          ],
        "ProStatement": [
          "Text": [
            {
              "value": "Yes means the measure will be enacted",
              "language": "en"
            }
          ]
        ],
        "SummaryText": [
          "Text": [
            {
              "value": "The proposition establishes new minimum requirements on farmers to provide more space for egg-laying hens, breeding pigs, and calves raised for veal. California businesses will be banned from selling eggs or uncooked pork or veal that came from animals housed in ways that did not meet these requirements.",
              "language": "en"
            }
          ]
        ],
        "Type": "ballot-measure",
      }
    ]

RetentionContest

ใช้ประเภทนี้เมื่อContestเกี่ยวข้องกับการลงประชามติเพื่อตัดสินว่าเจ้าหน้าที่ที่ได้รับเลือกตั้งควรอยู่ในตำแหน่งต่อไปหรือถูกถอดออกจากตำแหน่ง

ซึ่งรวมถึงกรณีต่างๆ เช่น การแข่งขันเพื่อรักษาตำแหน่งผู้พิพากษาในบางรัฐของสหรัฐอเมริกา ซึ่ง เป็นการตัดสินว่าผู้พิพากษาควรดำรงตำแหน่งต่อไปอีกวาระหรือไม่ รวมถึงการเลือกตั้งเพื่อถอดถอน ซึ่งเป็นการตัดสินว่าควรปลดเจ้าหน้าที่ออกจากตำแหน่งก่อนที่ เจ้าหน้าที่จะหมดวาระหรือไม่

องค์ประกอบ

องค์ประกอบทั้งหมดจาก BallotMeasureContest ยังใช้กับ RetentionContest ด้วย

องค์ประกอบ ความหลากหลาย ประเภท คำอธิบาย
CandidateId 1 IDREF รหัสของผู้สมัครที่แสดงถึงผู้ดำรงตำแหน่งซึ่งปัจจุบันดำรงตำแหน่งอยู่
OfficeId 0 หรือ 1 IDREF รหัสของตำแหน่งที่ผู้ดำรงตำแหน่งถือครองอยู่ในปัจจุบัน

ตัวอย่าง

XML

        <Contest objectId="rc40001" xsi:type="RetentionContest">
        <!-- Retention contest selections are actually BallotMeasureSelection
          objects, and should use the 'bms' objectId prefix.-->
          <BallotSelection objectId="bms40001a" xsi:type="BallotMeasureSelection">
            <ExternalIdentifiers>
              <ExternalIdentifier>
                <Type>other</Type>
                <OtherType>stable</OtherType>
                <Value>bmc_bms40001a</Value>
              </ExternalIdentifier>
            </ExternalIdentifiers>
          <Selection label="bms40001at">
            <Text language="en">Yes</Text>
          </Selection>
          </BallotSelection>
          <BallotSelection objectId="bms40001b" xsi:type="BallotMeasureSelection">
            <ExternalIdentifiers>
              <ExternalIdentifier>
                <Type>other</Type>
                <OtherType>stable</OtherType>
                <Value>bmc_bms40001at</Value>
              </ExternalIdentifier>
            </ExternalIdentifiers>
          <Selection label="bms40001bt">
            <Text language="en">No</Text>
          </Selection>
          </BallotSelection>
          <BallotTitle>
            <Text language="en">Retention of Supreme Court Justice</Text>
          </BallotTitle>
          <ElectoralDistrictId>ru0002</ElectoralDistrictId>
          <ExternalIdentifiers>
            <ExternalIdentifier>
              <Type>other</Type>
              <OtherType>stable</OtherType>
              <Value>vageneral-cont-2013-va16-country-us</Value>
            </ExternalIdentifier>
          </ExternalIdentifiers>
          <Name>Judicial Retention, Supreme Court</Name>
          <CandidateId>can12345</CandidateId>
          <OfficeId>off20006</OfficeId>
        </Contest>