GpUnit ואלמנטים קשורים

יחידה גיאופוליטית, או GpUnit, מתארת כל יחידה פיזית או וירטואלית של ייצוג או צבירה של קולות/מושבים. השתמשו בישות הזו כדי להגדיר יחידות גיאופוליטיות כמו ערים, מחוזות, אזורי שיפוט או אזורי בחירה, כדי לשייך תחרויות, משרדים, ספירת קולות או מידע אחר לאזורים הגיאוגרפיים האלה.

GpUnit

הישויות הבאות מכילות הפניות אל GpUnit:

  • ‫Election,‏ Contest ו-Office מכילים הפניה נדרשת לרכיב GpUnit, שמגדיר את תחום השיפוט של הבחירות, התחרות או המשרה בהתאמה.
  • ‫SummaryCounts ו-VoteCounts מתייחסים אל GpUnit כדי לקשר סיכום או ספירת קולות לאלמנטים של GpUnit שמוגדרים עבור אזורי בחירה או סוגים אחרים של יחידות גיאופוליטיות.

הקשרים בין ישויות דומות GpUnit צריכים להיות עקביים. לדוגמה, לכל המחוזות לקונגרס חייב להיות הורה יחיד, שהוא מדינה, גם אם מחוז מסוים לקונגרס נמצא כולו בתוך מחוז.

מאפיינים

בטבלה הבאה מתוארים המאפיינים של GpUnit:

מאפיין חובה? סוג תיאור
objectId חובה ID מזהה פנימי ייחודי שמשמש רכיבים אחרים כדי ליצור הפניה לרכיב הזה.

רכיבים

בטבלה הבאה מתוארים הרכיבים של GpUnit:

רכיב ריבוי סוג תיאור
ComposingGpUnitIds ‫0 או 1 IDREFS

מזהה ייחודי של רכיב GpUnit אחד או יותר. התג משמש להפניה לרכיבי GpUnit אחרים ולשיוך שלהם לרכיב האב GpUnit. כל אלמנט שמפנים אליו צריך להיות מוגדר ליחידה גיאופוליטית שנכללת באלמנט האב GpUnit.

משתמשים ברכיב ComposingGpUnitIds רק כדי לייצג צאצאים ישירים של רכיב GpUnit מסוים. לדוגמה, אם אזור בחירות א' ואזור בחירות ב' נמצאים בעיר מ', ועיר מ' נמצאת במחוז X, אז אזור בחירות א' ואזור בחירות ב' מופיעים כצאצאים של עיר מ'. אז העיר 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 לקבלת הנחיות.

התחביר של ReportingUnit ב-XML הוא <GpUnit xsi:type="ReportingUnit" ... />.

רכיבים

בטבלה הבאה מתוארים הרכיבים של ReportingUnit:

רכיב ריבוי סוג תיאור
AuthorityIds ‫0 או 1 IDREFS המאפיין objectId של רכיב Person אחד או יותר שמתארים רשות שאחראית על יחידת הדיווח.
ContactInformation ‫0 או 1 ContactInformation משייך פרטים ליצירת קשר ליחידת הדיווח, כמו כתובת של מרכז הצבעה.
CountStatus ‫0 או יותר CountStatus הכלי מספק סטטוסים שונים של ספירה לסוגים שונים של פתקי הצבעה או פריטים אחרים.
ElectionAdministration ‫0 או 1 ElectionAdministration מספק מידע על רשות בחירות. כדאי להשתמש באפשרות הזו אם יחידת הדיווח משמשת כרשות בבחירות.
InternationalizedName 1 InternationalizedText השם המלא והקנוני של היחידה הגיאו-פוליטית, בשפה המקומית, ולא קיצור. לדוגמה, 'אלסקה' או 'המחוז ה-14 של ניו יורק בקונגרס'.
IsDistricted ‫0 או 1 boolean אפשר להשתמש בערך הבוליאני IsDistricted בכמה דרכים. הוא לא נדרש באופן מוחלט כי אפשר לזהות מחוזות באמצעות רכיב המשנה Type שלהם. אפשר גם לבדוק את רכיב המשנה ElectoralDistrictId של הרכיב Contest, שמקשר למחוז הבחירה שמשויך לתחרות. עם זאת, אם מוגדר מחוז אבל הוא לא מקושר לתחרות, או אם סוג המחוז מצוין באמצעות 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"
      }
    ]