Counts
مستقیماً مورد استفاده یا ارجاع قرار نمی گیرد. در عوض، فقط به عنوان یک پایه برنامه افزودنی برای موجودیت های زیر استفاده می شود:
-
SummaryCounts
: برای گزارش در موردContest
و تعداد آرا خلاصه شده واحد ژئوپلیتیک (GpUnit
) استفاده می شود. -
VoteCounts
: برای گزارش تعداد آرا درContest
استفاده می شود.
Counts
به شما امکان می دهد تعداد آرا را بر اساس ویژگی های دستگاه، یا بر اساس نوع برگه رای یا ثبت نام فیلتر کنید. همچنین به شما امکان می دهد تعداد را به یک موجودیت تعریف شده GpUnit
، مانند یک کشور، پیوند دهید.
عناصر
جدول زیر عناصر Counts
را توضیح می دهد:
عنصر | کثرت | تایپ کنید | توضیحات |
---|---|---|---|
GpUnitId | 0 یا 1 | IDREF | شناسه منحصر به فرد برای یک عنصر GpUnit . برای مرتبط کردن شمارش ها با یک واحد ژئوپلیتیکی مانند حوزه، شهرستان یا شهرستان استفاده می شود. |
IsSuppressedForPrivacy | 0 یا 1 | boolean | نشان می دهد که آیا آرا برای حفظ حریم خصوصی رای دهندگان سرکوب شده است یا خیر. اگر این وجود نداشته باشد، مقدار پیشفرض false است. |
Type | 0 یا 1 | CountItemType | نوع شمارش که به عنوان فیلتری در شمارش آرا استفاده می شود، مانند روز انتخابات یا رای گیری زودهنگام. اگر نوع مورد |
OtherType | 0 یا 1 | string | زمانی استفاده می شود که Type other برای تعیین موارد شمارش شده باشد. |
خلاصه شمارش
از SummaryCounts
برای نمایش تعداد خلاصه در سطح مسابقه یا ژئوپلیتیک در سطح واحد استفاده کنید.
SummaryCounts
شامل Counts
به عنوان پایه افزونه است و بنابراین عناصر را از Counts
به ارث می برد. با این حال، SummaryCounts
یک نوع Counts
نیست، بلکه مستقیماً برای Contest
و GpUnit
گنجانده شده است.
SummaryCounts
میتواند برای ارائه خلاصهای از دامنه جغرافیایی از شمارشهای متفرقه مرتبط با یک Contest
، مانند تعداد کل آرا، تعداد کل آرای بیشازحد، کمرایها، و ثبت نامها استفاده شود. SummaryCounts
میتواند به صورت اختیاری به عناصر GpUnit
تعریفشده برای واحدهای گزارشدهی سطح پایینتر ارجاع دهد. این به شما امکان می دهد تعداد خلاصه را با سایر واحدهای گزارشگر سطح پایین در محدوده مسابقه مرتبط کنید.
SummaryCounts
همچنین می تواند برای ارائه تعداد خلاصه مختص به GpUnit
استفاده شود. به عنوان مثال، یک GpUnit
تعریف شده برای یک کشور می تواند شامل SummaryCounts
برای ارائه یک تعداد خلاصه باشد. SummaryCounts
، در این مورد، عنصر GpUnitId
را در Counts
شامل نمیشود.
در Counts
، اگر نوع مورد شمارش در شمارش CountItemType
فهرست نشده است، از other
استفاده کنید و نوع سفارشی را در OtherType
قرار دهید.
عناصر
جدول زیر عناصر SummaryCounts
را شرح می دهد:
عنصر | کثرت | تایپ کنید | توضیحات |
---|---|---|---|
BallotsCast | 0 یا 1 | integer | تعداد رای های داده شده |
BallotsOutstanding | 0 یا 1 | integer | تعداد آرا هنوز شمارش نشده است. |
BallotsRejected | 0 یا 1 | integer | تعداد برگه های رای رد شده |
Overvotes | 0 یا 1 | integer | تعداد آرای اضافه |
Undervotes | 0 یا 1 | integer | تعداد کمترین رای. |
WriteIns | 0 یا 1 | integer | تعداد نوشته ها |
نمونه ها
XML
<SummaryCounts> <BallotsCast>2089540</BallotsCast> <WriteIns>2087</WriteIns> </SummaryCounts>
JSON
"SummaryCounts": [ { "BallotsCast": "2089540", "WriteIns": "2087" } ]
تعداد آرا
از VoteCounts
برای توصیف تعداد آرا برای BallotSelection
در یک Contest
استفاده کنید.
عناصر
جدول زیر عناصر VoteCounts
را توضیح می دهد:
عنصر | کثرت | تایپ کنید | توضیحات |
---|---|---|---|
Count | 0 یا 1 | float | تعداد آرای مسابقه داده شده، به صورت عددی بین 0 تا 100. در موارد خاص، شمارش می تواند شامل یک جزء کسری باشد. به عنوان مثال، 14.2٪ را به عنوان برای فهرستی از انواع پشتیبانیشده شمارش آرا، انواع جدولبندی نتایج را ببینید. |
نمونه ها
XML
<VoteCounts> <GpUnitId>ru_001</GpUnitId> <Type>total</Type> <Count>6173433</Count> </VoteCounts> <VoteCounts> <GpUnitId>ru_001</GpUnitId> <Type>other</Type> <OtherType>projected-vote-percent</OtherType> <Count>22.3</Count> </VoteCounts>
JSON
"VoteCounts": [ { "GpUnitId": "ru_001", "Type": "total", "Count": "6173433" }, { "GpUnitId": "ru_001", "Type": "other", "OtherType": "projected-vote-percent", "Count": "22.3" } ]