این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

مشخصات داده های انتخابات شناسه ملی

این سند حاوی مشخصاتی برای داده‌های لازم برای Google برای ارائه مکان رأی‌گیری و اطلاعات نامزدها برای انتخابات مبتنی بر شناسه ملی است. این سند یک پیش نویس مشخصات است که عمدتاً برای درخواست بازخورد در نظر گرفته شده است و ممکن است در آینده تغییر کند.

جداول

مجموعه جداول زیر باید به‌عنوان فایل‌های ارزش جداشده با تب (TSV) جداگانه ارائه شود. هر فایل باید با یک خط سرصفحه شروع شود که فیلدهای آن جدول را فهرست می کند. اگر داده ای برای فیلد مربوطه وجود نداشته باشد، نیازی به اضافه کردن فیلدهای سرصفحه اختیاری نیست. خطوط بعدی در فایل حاوی ردیف های داده با فیلدهایی به همان ترتیبی است که در ردیف سرصفحه مشخص شده است.

فایل‌ها باید نام‌گذاری مناسبی داشته باشند و در داخل یک آرشیو فشرده قرار بگیرند. فایل ها باید نامگذاری شوند: voters.tsv، votingGroups.tsv، regions.tsv، pollingLocations.tsv، kandidats.tsv، offices.tsv.

مگر اینکه به طور دیگری ذکر شده باشد، هر فیلد نشان داده شده در این مشخصات یک رشته است. فایل‌های TSV برای کاما یا کاراکترهای خاص به غیر از برگه‌ها نیازی به فرار ندارند. از آنجایی که برگه ها برای هیچ یک از فیلدهای هیچ یک از جداول مناسب نیستند، ما به صراحت آنها را از قرار گرفتن در یک فیلد منع می کنیم.

* برای نشان دادن یک فیلد الزامی در جدول استفاده می شود
** برای نشان دادن یک فیلد الزامی استفاده می شود که همچنین کلید اصلی آن جدول است (دو سطر نمی توانند مقدار یکسانی برای این فیلد داشته باشند)
^Æ نشان دهنده زمینه ای است که باید بین المللی شود.

بین المللی شدن

برای اطمینان از اینکه داده‌ها به زبان صحیح ارائه می‌شوند، برخی از فیلدها در ردیف سرصفحه باید شامل مشخصات محلی باشند. از آنجایی که برخی کشورها بیش از یک زبان دارند، ممکن است لازم باشد داده ها به بیش از یک زبان ارائه شوند. برای چنین کشورهایی، ستون‌ها ممکن است با محلی متفاوت که به انتهای نام ستون اضافه شده و با یک خط تیره از هم جدا شوند، به عنوان مثال PartyAffiliation-en تکرار شوند.

برای ساختن زبان‌ها به صفحه Google API در شناسه‌های زبان‌ها، کشورها، ارزها و مناطق زمانی مراجعه کنید. این مشخصات متکی به بهترین شیوه های فعلی 47 - برچسب ها برای شناسایی زبان ها (BCP 47). برای نمونه‌هایی از برچسب‌های زبان به پیوست A از BCP 47 مراجعه کنید.

جدول 1 - جدول رأی دهندگان (الزامی)

NationalVoterId**, VoterGroupId

یک ردیف در جدول رأی دهندگان نشان دهنده یک رأی دهنده است. هر رای دهنده در کشور یک شناسه ملی یا شناسه رای دهنده دارد که در قسمت NationalVoterId ذخیره می شود. VoterGroupId نشان می دهد که این رای دهنده به کدام گروه رای دهنده تعلق دارد.

نکات: در کشورهایی که هیچ گروه رای گیری منطقی وجود ندارد، VoterGroupId می تواند تکراری از NationalVoterId باشد که در این صورت جدول گروه رای گیری (جدول 2) رای دهندگان را مستقیماً به شناسه های ناحیه و محل رای گیری اختصاص می دهد.

جدول 2 - جدول گروه رای گیری (الزامی)

VoterGroupId**, PollingLocationId*, ProvinceDistrictId, CountyDistrictId, LocalityDistrictId

یک ردیف در این جدول یک گروه رای‌دهنده را مشخص می‌کند، جایی که آن گروه (از طریق PollingLocationId) رای می‌دهد، و این گروه رای‌دهی به کدام ناحیه تعلق دارد. هر گروه رای دهی به طور منحصر به فرد توسط VoterGroupId مشخص می شود. ممکن است شناسه‌های چند ناحیه مشخص شود، زیرا یک گروه رای‌دهنده ممکن است به مقامات مختلف در سطوح مختلف دولت رای دهد. به عنوان مثال، در ایالات متحده می توان به یک فرماندار در سطح ایالت، یک مدیر اجرایی شهرستان در سطح شهرستان و یک شهردار در سطح شهر رای داد.

نکات: هر فرد در یک گروه رای‌دهی باید در همان رقابت‌ها و در یک محل رای‌گیری رای دهد. اگر اینطور نیست، یک گروه رای‌دهی باید به چند گروه رای‌دهنده تقسیم شود.

جدول 3 - جدول ناحیه (الزامی)

DistrictId**, AuthorityName*, LocalElectionOfficialName*, LocalElectionOfficialPhone*, LocalElectionUrl*, LocalElectionOfficialEmail, LocalElectionOfficialAddress

هر ردیف در جدول ناحیه حاوی داده‌های مربوط به حوزه رأی‌دهی است که شامل اطلاعات رسمی انتخابات محلی می‌شود. فیلد نام مرجع باید در صورت لزوم شامل نام ناحیه باشد، به عنوان مثال ناحیه کلمبیا.

جدول 4 - محل رای گیری (الزامی)

PollingLocationId**, Address* ^Æ , Latitude, Longitude, HoursOfOperation ^Æ , AdditionalDirections ^Æ , ContactInfo ^Æ

هر مکان رأی گیری با یک ردیف در جدول مکان رأی گیری نشان داده می شود. فیلد آدرس باید حاوی یک رشته با آدرس کاملاً مشخص شده برای محل نظرسنجی باشد. آدرس‌ها ممکن است برای ارائه لینک‌های نقشه مورد استفاده قرار گیرند تا آدرس‌هایی که به طور دقیق در وب‌سایت‌های جغرافیایی نقشه‌برداری می‌کنند ایده‌آل باشند. در مواردی که آدرس قابل نقشه برداری امکان پذیر نباشد، اطلاعات به صورت متن در اختیار کاربر قرار می گیرد. طول و عرض جغرافیایی فیلدهای اختیاری هستند که شامل طول و عرض جغرافیایی هستند. ارائه طول و عرض جغرافیایی اطلاعات ارزشمندی را برای خطا در بررسی نتایج مکان نظرسنجی فراهم می کند.

فیلد AdditionalDirections اختیاری است و ممکن است حاوی دستورالعمل های لازم برای یافتن محل رأی گیری باشد، به عنوان مثال در داخل ساختمان مشخص شده توسط آدرس. فیلد ContactInfo باید حاوی اطلاعات لازم برای تماس با مقامات مسئول این محل رأی گیری باشد.

جدول 5 - جدول کاندیدا (الزامی)

CandidateId**, CandidateName* ^Æ , PartyAffiliation ^Æ , OfficeId*, Url, CampaignAddress ^Æ , Photo, Phone, TwitterHandle, FacebookUsername, Email, YoutubeChannel

هر ردیف در جدول کاندیدا نشان دهنده یک نامزد است. CandidateId به طور منحصر به فرد یک نامزد را شناسایی می کند. فیلد دفتر حاوی نام دفتری است که این نامزد در آن شرکت می کند. سایر فیلدهای این جدول اطلاعات مربوط به داوطلب را ارائه می دهد.

جدول 6 - میز اداری

OfficeId**, DistrictId*, Name ^Æ , Term ^Æ , Description ^Æ

هر دفتر دارای یک ردیف در این جدول است که با شناسه دفتر مشخص می شود. نام و توضیحات دفتر نیز درج شده است. فیلد DistrictId باید یکی از شناسه‌های ناحیه فهرست شده در قسمت‌های ProvinceDistrictId، CountyDistrictId یا LocalityDistrictId را در جدول Voting Group مشخص کند. برای دفاتری که همه رای دهندگان به آنها رأی می دهند، ALL باید به عنوان شناسه ناحیه استفاده شود.

نمونه ها

نمونه سرصفحه فایل داده های مکان نظرسنجی

فایل: voters.tsv
سربرگ:

NationalVoterId        VoterGroupId

فایل: votingGroups.tsv
سربرگ:

VoterGroupId        PollingLocationId

فایل: pollingLocations.tsv
سربرگ:

PollingLocationId        Address        HoursOfOperation

نمونه سربرگ فایل چند زبانه

اگر کشوری چندین زبان داشت، سرصفحه هر فایل ممکن است دارای فیلدهای اضافی باشد که زبان/محل داده‌های موجود در آن فیلد را نشان می‌دهد. فقط فیلدهایی که قابل بین المللی شدن هستند، یعنی با نشانگر ^Æ ، در توضیحات جدول بالا باید دارای محلی باشند.