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 المحدّد. على سبيل المثال، إذا كانت الدائرتان الانتخابية "أ" و"ب" تقعان في المدينة "م"، وكانت المدينة "م" تقع في المقاطعة "س"، يجب إدراج الدائرتين الانتخابية "أ" و"ب" كعناصر فرعية من المدينة "م". عندئذٍ، تكون المدينة 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 التي تصف جهة مسؤولة عن وحدة التقارير.
ContactInformation 0 أو 1 ContactInformation ربط معلومات الاتصال بالوحدة المسؤولة عن إعداد التقارير، مثل عنوان مركز التصويت
CountStatus ‫0 أو أكثر CountStatus تقدّم هذه السمة حالات عدّ مختلفة لأنواع مختلفة من بطاقات الاقتراع أو غيرها من العناصر.
ElectionAdministration 0 أو 1 ElectionAdministration تعرض هذه السمة معلومات عن هيئة انتخابية. استخدِم هذا الخيار عندما تكون وحدة إعداد التقارير هي الجهة المسؤولة في الانتخابات.
InternationalizedName 1 InternationalizedText الاسم الكامل والقانوني والمترجم للوحدة الجغرافية السياسية، وليس اختصارًا. على سبيل المثال، "ألاسكا" أو "الدائرة الانتخابية الرابعة عشرة في نيويورك".
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"
      }
    ]