การแข่งขัน

ใช้ 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 ชื่อย่อของการแข่งขัน
BallotSelection 0 ขึ้นไป BallotSelection

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

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

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

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

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

ContestDateStatus 0 หรือ 1 DateStatus

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

ElectoralDistrictId 1 IDREF

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

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

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

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

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

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

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
StartDate 0 หรือ 1 PartialDate วันที่เริ่มต้นการแข่งขันในปฏิทิน ใช้วันที่ที่เริ่มการสำรวจความคิดเห็น เช่น 2022-11-08 ควรตั้งวันที่เริ่มต้นเฉพาะในกรณีที่วันที่เริ่มต้นและวันที่สิ้นสุดของ Contest แตกต่างจากวันที่เริ่มต้นและวันที่สิ้นสุดของ Election
EndDate 0 หรือ 1 PartialDate วันที่สิ้นสุดของปฏิทินการแข่งขัน ใช้วันที่ที่การลงคะแนนสิ้นสุด เช่น 2022-11-08 ควรตั้งวันที่สิ้นสุดก็ต่อเมื่อวันที่เริ่มต้นและวันที่สิ้นสุดของ Contest แตกต่างจากวันที่เริ่มต้นและวันที่สิ้นสุดของ Election
CountingDate 0 หรือ 1 PartialDate วันที่หลังการลงคะแนนเสียงเมื่อมีการนับคะแนนสำหรับการแข่งขันการเลือกตั้ง ควรระบุเฉพาะในกรณีที่วันนับคะแนนแตกต่างจากวันสุดท้ายของการโหวต เช่น การเลือกตั้ง Lok Sabha ของอินเดีย โดยปกติแล้ว การนับคะแนนจะเกิดขึ้นในวันเดียวกับวันสุดท้ายของการลงคะแนนเสียง ซึ่งก็คือวันที่ EndDate ของการเลือกตั้ง

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 จำนวนการโหวตหรือการเขียนชื่อผู้สมัครรับเลือกตั้งสูงสุดที่อนุญาตต่อผู้มีสิทธิ์เลือกตั้ง 1 คนในการแข่งขันนี้ หากไม่มี 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 จำนวนคะแนนโหวตหรือการเขียนชื่อที่อนุญาตต่อผู้โหวต 1 คนในการแข่งขันนี้ หากไม่มี 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>