GpUnit และองค์ประกอบที่เกี่ยวข้อง

หน่วยภูมิรัฐศาสตร์ หรือ GpUnit อธิบายหน่วยทางกายภาพหรือเสมือนใดๆ ของ การเป็นตัวแทนหรือการรวบรวมคะแนน/ที่นั่ง ใช้เอนทิตีนี้เพื่อกำหนดหน่วยภูมิรัฐศาสตร์ เช่น เมือง เขตอำเภอ เขตอำนาจศาล หรือเขตเลือกตั้ง เพื่อเชื่อมโยง การแข่งขัน สำนักงาน จำนวนคะแนนโหวต หรือข้อมูลอื่นๆ กับภูมิศาสตร์เหล่านั้น

GpUnit

เอนทิตีต่อไปนี้มีการอ้างอิงถึง GpUnit

  • Election, Contest และ Office มีการอ้างอิงที่จำเป็น ไปยังองค์ประกอบ GpUnit ซึ่งกำหนดเขตอำนาจศาลของการเลือกตั้ง การแข่งขัน หรือตำแหน่งตามลำดับ
  • SummaryCounts และ VoteCounts อ้างอิงถึง GpUnit เพื่อลิงก์สรุปหรือจำนวนการโหวตไปยังองค์ประกอบ GpUnit ที่กำหนดไว้สำหรับ เขตเลือกตั้งหรือหน่วยภูมิรัฐศาสตร์ประเภทอื่นๆ

ความสัมพันธ์ระหว่างเอนทิตีหลักกับเอนทิตีย่อยสำหรับเอนทิตี GpUnit ที่คล้ายกันต้องสอดคล้องกัน เช่น เขตเลือกตั้งทั้งหมดต้องมีเขตเลือกตั้งระดับรัฐเป็นเขตเลือกตั้งระดับบนสุด แม้ว่าเขตเลือกตั้งหนึ่งๆ จะอยู่ในเขตปกครองทั้งหมดก็ตาม

Attributes

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

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

องค์ประกอบ

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

องค์ประกอบ ความหลากหลาย ประเภท คำอธิบาย
ComposingGpUnitIds 0 หรือ 1 IDREFS

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

ใช้องค์ประกอบ ComposingGpUnitIds เพื่อแสดงเฉพาะ องค์ประกอบย่อยโดยตรงของ GpUnit นั้นๆ เช่น หากเขตเลือกตั้ง A และ B อยู่ในเมือง M และเมือง M อยู่ในเทศมณฑล X ให้ แสดงเขตเลือกตั้ง A และ B เป็นเขตย่อยของเมือง M จากนั้นเมือง M จะเป็นองค์ประกอบย่อยของ เขต X แต่อย่าทำให้เขต A และ B เป็นองค์ประกอบย่อยของ เขต X
ExternalIdentifiers 0 หรือ 1 ExternalIdentifiers

เชื่อมโยงรหัสกับ GpUnit เช่น รหัสของเขตหรือเมือง

เมื่อระบุ ExternalIdentifiers หากประเภทไม่ได้อยู่ใน การแจงนับ IdentifierType ให้ใช้ Type ของ other และระบุประเภทที่กำหนดเองใน OtherType

Name 0 หรือ 1 string ชื่อของหน่วยภูมิศาสตร์การเมือง
SummaryCounts 0 ขึ้นไป SummaryCounts

จำนวนสรุปบัตรลงคะแนน เช่น บัตรลงคะแนนเกิน บัตรลงคะแนนไม่ครบ และบัตรลงคะแนนทั้งหมด โดยอาจแยกตามประเภทอุปกรณ์และชั้นเรียนการลงคะแนน ได้ (ไม่บังคับ)

GpUnit รวมถึง SummaryCounts เพื่อให้ข้อมูล จำนวนสรุปสำหรับภูมิศาสตร์ทางการเมืองที่เกี่ยวข้อง

ReportingUnit

ใช้ ReportingUnit เพื่อกำหนดหน่วยภูมิรัฐศาสตร์ เช่น รัฐ เมือง เขตการปกครอง หรือเขตเลือกตั้งด้วยการแจงนับ ReportingUnitType

Election อ้างอิงองค์ประกอบนี้เพื่อ ระบุขอบเขตทางภูมิศาสตร์ของการเลือกตั้ง ในกรณีนี้ องค์ประกอบ ReportingUnit ที่กำหนดขอบเขตของการเลือกตั้งอาจรวมถึง ElectionAdministration เพื่อให้ข้อมูลที่เกี่ยวข้องกับหน่วยงานจัดการเลือกตั้ง

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

ไวยากรณ์ XML สำหรับ ReportingUnit คือ <GpUnit xsi:type="ReportingUnit" ... />

องค์ประกอบ

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

องค์ประกอบ ความหลากหลาย ประเภท คำอธิบาย
AuthorityIds 0 หรือ 1 IDREFS objectId ขององค์ประกอบ Person อย่างน้อย 1 รายการ ที่อธิบายถึงหน่วยงานที่รับผิดชอบหน่วยรายงาน
ContactInformation 0 หรือ 1 ContactInformation เชื่อมโยงข้อมูลติดต่อกับหน่วยรายงาน เช่น ที่อยู่ของศูนย์ลงคะแนน
CountStatus 0 ขึ้นไป CountStatus ระบุสถานะการนับต่างๆ สำหรับบัตรลงคะแนนประเภทต่างๆ หรือ รายการอื่นๆ
ElectionAdministration 0 หรือ 1 ElectionAdministration ให้ข้อมูลเกี่ยวกับหน่วยงานจัดการเลือกตั้ง ใช้ในกรณีที่หน่วยรายงานทำหน้าที่เป็นหน่วยงานที่มีอำนาจในการเลือกตั้ง
InternationalizedName 1 InternationalizedText ชื่อแบบเต็มที่แปลแล้วและเป็นชื่อที่แน่นอนของหน่วยภูมิศาสตร์การเมือง ไม่ใช่ ชื่อย่อ เช่น "อลาสก้า" หรือ "เขตเลือกตั้งที่ 14 ของนิวยอร์ก"
IsDistricted 0 หรือ 1 boolean คุณใช้บูลีน IsDistricted ได้หลายวิธี ไม่จำเป็นอย่างเคร่งครัดเนื่องจากสามารถระบุเขตได้ โดยใช้องค์ประกอบย่อย Type นอกจากนี้ คุณยังตรวจสอบองค์ประกอบ Contest ขององค์ประกอบย่อย ElectoralDistrictId ซึ่งลิงก์ ไปยังเขตเลือกตั้งที่เชื่อมโยงกับการแข่งขันได้ด้วย อย่างไรก็ตาม หากมีการกำหนดเขตเลือกตั้งแต่ไม่ได้ลิงก์จากเขตเลือกตั้ง หรือหากมีการระบุประเภทเขตเลือกตั้งด้วย OtherType ก็จะต้องระบุ IsDistricted เพื่อระบุ GpUnit เป็นเขตเลือกตั้ง นอกจากนี้ คุณยังใช้IsDistrictedบูลีน เพื่อระบุว่า GpUnit ที่กำหนดเป็น เขตอำนาจศาล เช่น เมือง ยังใช้เป็นเขตด้วยได้ เช่น สำหรับ การแข่งขันทั่วทั้งเมือง
IsMailOnly 0 หรือ 1 boolean ระบุว่าหน่วยรายงานจัดการเฉพาะการเลือกตั้งทางไปรษณีย์หรือ การเลือกตั้งล่วงหน้าหรือไม่ หากไม่มี ค่าเริ่มต้นจะเป็น false
SubUnitsReported 0 หรือ 1 integer จำนวนหน่วยย่อยที่เกี่ยวข้อง เช่น เขตเลือกตั้ง ที่รายงานเสร็จสมบูรณ์แล้ว
TotalSubUnits 0 หรือ 1 integer จำนวนหน่วยย่อยที่เกี่ยวข้องทั้งหมด เช่น เขตเลือกตั้ง
Type 1 ReportingUnitType

ประเภทของหน่วยรายงานที่ระบุ เช่น รัฐ เมือง เขต หรือเขตเลือกตั้ง

หากประเภทหน่วยการรายงานไม่อยู่ในรายการการแจงนับ ReportingUnitType ให้ใช้ Type ของ other และระบุประเภทหน่วยการรายงานที่กำหนดเองใน OtherType
OtherType 0 หรือ 1 string ใช้เพื่อระบุประเภทหน่วยภูมิศาสตร์การเมืองเมื่อค่าของ ReportingUnitType เป็น other
VotersParticipated 0 หรือ 1 integer จำนวนผู้มีสิทธิเลือกตั้งที่เข้าร่วมการเลือกตั้ง นั่นคือ มีผู้มาที่หน่วยเลือกตั้งกี่คน ซึ่งรวมถึงผู้ที่ไม่ได้ ลงคะแนนด้วย
VotersRegistered 0 หรือ 1 integer จำนวนผู้มีสิทธิเลือกตั้งที่จดทะเบียนซึ่งอาศัยอยู่ภายในขอบเขตของ หน่วยภูมิรัฐศาสตร์

ตัวอย่าง

XML

    <GpUnit objectId="ru0081" xsi:type="ReportingUnit">
      <ComposingGpUnitIds>ru_wahlkreis1 ru_wahlkreis2</ComposingGpUnitIds>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-state-0081</Value>
        </ExternalIdentifier>
        <ExternalIdentifier>
          <Type>ocd-id</Type>
          <Value>ocd-division/country:de/state:hb</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <InternationalizedName>
        <Text language="en">Bremen</Text>
      </InternationalizedName>
      <Name>Bremen</Name>
      <Type>state</Type>
    </GpUnit>

JSON

    "GpUnit": [
      {
        "@type": "ReportingUnit",
        "objectId": "ru0081",
        "ComposingGpUnitIds": [
          "ru_wahlkreis1",
          "ru_wahlkreis2"
        ],
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "stable-state-0081"
            },
            {
              "Type": "ocd-id",
              "Value": "ocd-division/country:de/state:hb"
            }
          ]
        },
        "InternationalizedName": {
          "Text": [
            {
              "language": "en",
              "value": "Bremen"
            }
          ]
        },
        "Name": "Bremen",
        "Type": "state"
      }
    ]