یک واحد ژئوپلیتیکی یا GpUnit ، هر واحد فیزیکی یا مجازی نمایندگی یا تجمع رأی/کرسی را توصیف میکند. از این موجودیت برای تعریف واحدهای ژئوپلیتیکی مانند شهرها، مناطق، حوزههای قضایی یا حوزههای انتخابیه استفاده کنید تا رقابتها، مناصب، شمارش آرا یا سایر اطلاعات را با آن مناطق جغرافیایی مرتبط کنید.
جیپییونیت
موجودیتهای زیر حاوی ارجاعاتی به GpUnit هستند:
-
Election،ContestوOfficeحاوی یک ارجاع الزامی به یک عنصرGpUnitهستند که به ترتیب حوزه قضایی انتخابات، مسابقه یا دفتر را تعریف میکند. -
SummaryCountsوVoteCountsبرای پیوند دادن خلاصه یا شمارش آرا به عناصرGpUnitکه برای حوزههای انتخابیه یا انواع دیگر واحدهای ژئوپلیتیکی تعریف شدهاند، بهGpUnitارجاع میدهند.
روابط والد-فرزندی برای موجودیتهای مشابه GpUnit باید سازگار باشد. برای مثال، تمام حوزههای انتخابیه کنگره باید یک والد واحد داشته باشند که یک ایالت است، حتی اگر یک حوزه انتخابیه کنگره خاص کاملاً در یک شهرستان قرار داشته باشد.
ویژگیها
جدول زیر ویژگیهای GpUnit را شرح میدهد:
| ویژگی | الزامی است؟ | نوع | توضیحات |
|---|---|---|---|
objectId | مورد نیاز | ID | شناسه داخلی منحصر به فردی که توسط عناصر دیگر برای ارجاع به این عنصر استفاده میشود. |
عناصر
جدول زیر عناصر GpUnit را شرح میدهد:
| عنصر | چندگانگی | نوع | توضیحات |
|---|---|---|---|
ComposingGpUnitIds | ۰ یا ۱ | IDREFS | شناسه منحصر به فرد برای یک یا چند عنصر از عنصر |
ExternalIdentifiers | ۰ یا ۱ | ExternalIdentifiers | یک شناسه (ID) مانند کد منطقه یا شهر را به وقتی |
Name | ۰ یا ۱ | string | نام واحد ژئوپلیتیکی |
SummaryCounts | ۰ یا بیشتر | SummaryCounts | خلاصه شمارش آرا، مانند رأیهای بیش از حد، کمتر از حد لازم و کل آرا. آنها میتوانند به صورت اختیاری بر اساس نوع دستگاه و کلاس برگه رأی تفکیک شوند. |
واحد گزارشدهی
ReportingUnit برای تعریف یک واحد ژئوپلیتیکی مانند ایالت، شهر، شهرستان یا حوزه با استفاده از شمارش ReportingUnitType استفاده کنید.
Election به این عنصر برای شناسایی محدوده جغرافیایی انتخابات اشاره میکند. در این مورد، عنصر ReportingUnit که محدوده انتخابات را تعریف میکند، میتواند شامل ElectionAdministration برای ارائه اطلاعات مربوط به مرجع انتخابات باشد.
یک ReportingUnit میتواند حداکثر فرزند یک ReportingUnit دیگر باشد. با این حال، اگر یک ReportingUnit به چندین والد نیاز دارد زیرا به طور قانونی در عناصر والد ReportingUnit قرار میگیرد، برای راهنمایی با نماینده گوگل خود تماس بگیرید.
سینتکس XML برای ReportingUnit به صورت <GpUnit xsi:type="ReportingUnit" ... /> است.
عناصر
جدول زیر عناصر ReportingUnit را شرح میدهد:
| عنصر | چندگانگی | نوع | توضیحات |
|---|---|---|---|
AuthorityIds | ۰ یا ۱ | IDREFS | objectId یک یا چند عنصر Person که یک مرجع مسئول واحد گزارشگری را توصیف میکند. |
ContactInformation | ۰ یا ۱ | ContactInformation | اطلاعات تماس، مانند آدرس یک مرکز رأیگیری، را با واحد گزارشدهی مرتبط میکند. |
CountStatus | ۰ یا بیشتر | CountStatus | وضعیتهای شمارش متنوعی را برای انواع مختلف برگههای رأی یا سایر موارد ارائه میدهد. |
ElectionAdministration | ۰ یا ۱ | ElectionAdministration | اطلاعاتی در مورد مرجع انتخابات ارائه میدهد. از این مورد زمانی استفاده کنید که واحد گزارشگر به عنوان مرجع در انتخابات عمل میکند. |
InternationalizedName | ۱ | InternationalizedText | نام محلی، کامل و متعارف واحد جغرافیایی-سیاسی، نه یک اختصار. برای مثال، «آلاسکا» یا «حوزه انتخابیه چهاردهم نیویورک». |
IsDistricted | ۰ یا ۱ | boolean | مقدار بولی IsDistricted میتواند به روشهای مختلفی استفاده شود. این مقدار کاملاً ضروری نیست زیرا میتوان حوزههای انتخاباتی را با استفاده از زیرعنصر Type آنها شناسایی کرد. همچنین میتوانید زیرعنصر ElectoralDistrictId عنصر Contest را بررسی کنید که به حوزه انتخاباتی مرتبط با مسابقه پیوند میدهد. با این حال، اگر یک حوزه انتخاباتی تعریف شده باشد اما از یک مسابقه پیوند نخورده باشد، یا اگر نوع حوزه با OtherType داده شده باشد، IsDistricted برای شناسایی GpUnit به عنوان یک حوزه ضروری است. مقدار بولی IsDistricted همچنین میتواند برای نشان دادن اینکه یک GpUnit که به عنوان یک حوزه قضایی، مانند یک شهر، تعریف شده است، به عنوان یک حوزه نیز استفاده میشود، به عنوان مثال برای مسابقات در سطح شهر، استفاده شود. |
IsMailOnly | ۰ یا ۱ | boolean | نشان میدهد که آیا واحد گزارشدهنده فقط انتخابات پستی یا رأیگیری غیابی را مدیریت میکند. در صورت عدم وجود، مقدار پیشفرض false است. |
SubUnitsReported | ۰ یا ۱ | integer | تعداد زیرمجموعههای مرتبط، مانند حوزههای انتخابیه، که گزارشدهی را تکمیل کردهاند. |
TotalSubUnits | ۰ یا ۱ | integer | تعداد کل زیرواحدهای مرتبط مانند حوزهها. |
Type | ۱ | ReportingUnitType | نوع واحد گزارشگری شمارششده، مانند ایالت، شهر، منطقه یا حوزه انتخابیه. اگر نوع واحد گزارشدهی در بخش شمارشی |
OtherType | ۰ یا ۱ | string | برای تعیین نوع واحد ژئوپلیتیکی زمانی که مقدار ReportingUnitType other باشد، استفاده میشود. |
VotersParticipated | ۰ یا ۱ | integer | تعداد رأیدهندگانی که در انتخابات شرکت کردهاند. یعنی، چند نفر در حوزههای رأیگیری حاضر شدهاند، که شامل کسانی که رأی ندادهاند نیز میشود. |
VotersRegistered | ۰ یا ۱ | 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>
جیسون
"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" } ]