مواصفات بيانات انتخابات بطاقة الهوية الوطنية

ويحتوي هذا المستند على مواصفات للبيانات اللازمة توفر Google معلومات عن موقع الاقتراع ومعلومات المرشح الانتخابات المستندة إلى بطاقة التعريف الوطنية هذا المستند عبارة عن مسودة مواصفات تهدف في المقام الأول إلى طلب الملاحظات وقد تتغير في المستقبل.

الجداول

يجب تقديم مجموعة الجداول التالية كجداول منفصلة. مفصول بعلامات جدولة value (TSV). يجب أن يبدأ كل ملف بحرف سطر العنوان يسرد حقول هذا الجدول. حقول عناوين اختيارية لا يلزم تضمينها إذا لم تكن هناك بيانات . تحتوي الأسطر التالية في الملف على صفوف البيانات التي تحتوي على بنفس الترتيب المحدد في صف العنوان.

يجب تسمية الملفات بشكل مناسب وتجميعها داخل ملف zip الأرشفة. يجب تسمية الملفات: biasrs.tsv وcontributionGroups.tsv، segmentations.tsv وPluingLocations.tsv وmasters.tsv وoffice.tsv

ما لم يذكر خلاف ذلك، فإن كل حقل مشار إليه في هذه المواصفات هو وسلسلة. لا تتطلب ملفات TSV إلغاء الفواصل أو استخدام علامات خاصة أحرفًا بخلاف علامات التبويب. نظرًا لأنّ علامات التبويب ليست مناسبة لأي من الحقول في أي من الجداول، فإننا لا نسمح لهم صراحةً من التواجد في مجال ما.

تُستخدم العلامة * للإشارة إلى حقل مطلوب في الجدول
** للإشارة إلى حقل مطلوب والذي يعد أيضًا مفتاحًا أساسيًا ذلك الجدول (لا يمكن أن يتضمّن صفان القيمة نفسها لهذا الحقل)
يشير ^Æ إلى حقل يجب تدويله.

التدويل

لضمان تقديم البيانات باللغة الصحيحة يجب أن تتضمن بعض الحقول في صف العنوان مواصفات اللغة. نظرًا لأن بعض البلدان لديها أكثر من لغة بيانات واحدة، فقد يلزم المقدمة بأكثر من لغة واحدة. بالنسبة إلى هذه البلدان، قد تكون الأعمدة يتم تكرارها مع إلحاق لغة مختلفة بنهاية العمود مفصولاً بشرطة أو شرطة، على سبيل المثال PartyAffiliation-en.

لإنشاء لغات، راجع صفحة Google APIs على معرّفات اللغات والبلدان والعملات والمناطق الزمنية تعتمد هذه المواصفات على أفضل الممارسات الحالية 47 - علامات تحديد اللغات (BCP 47) راجِع الملحق A من BCP 47 للاطّلاع على أمثلة على علامات اللغة.

الجدول 1 - جدول الناخبين (مطلوب)

NationalVoterId**, VoterGroupId

يمثل الصف في جدول الناخبين ناخبًا واحدًا. كل ناخب في تمتلك الدولة بطاقة تعريف وطنية أو بطاقة تعريف للناخب، يتم تخزينها في حقل "رقم تعريف التصويت الوطني". يشير VoterGroupId إلى مجموعة التصويت هذه ينتمي إليها الناخب

ملاحظات: في البلدان التي لا توجد فيها مجموعة تصويت منطقية، يمكن أن يكون VoterGroupId تكرارًا لرقم تعريف الوطني الأصوات في هذه الحالة سيقوم جدول مجموعة التصويت (الجدول 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 أحد أرقام تعريف المنطقة المدرجة في حقل ProcessDistrictId أو CountyDistrictId أو LocalityDistrictId في جدول مجموعة التصويت. للمكاتب التي يصوّت عليها الجميع الناخبين، يجب استخدام ALL كرقم تعريف المنطقة.

نماذج

نماذج عناوين ملف بيانات الموقع الجغرافي للاستطلاع

الملف: forcers.tsv
العنوان:

NationalVoterId        VoterGroupId

الملف: annotateGroups.tsv
العنوان:

VoterGroupId        PollingLocationId

الملف: LouingLocations.tsv
العنوان:

PollingLocationId        Address        HoursOfOperation

نموذج لعنوان ملف متعدد اللغات

إذا كان للبلد لغات متعددة، يمكن أن يتضمن العنوان الخاص بكل ملف حقول إضافية تشير إلى لغة/منطقة البيانات المضمنة في هذا المجال. فقط الحقول التي تم وضع علامة عليها كقابلة للتدويل، مثلاً، باستخدام علامة ^Æ، في أوصاف الجدول أعلاه، يجب أن يحمل اسم إلحاق اللغة.

الملف: LouingLocations.tsv
العنوان:

PollingLocationId        Address        HoursOfOperation-en        HoursOfOperation-fr

يوضح هذا المثال البسيط ساعات عمل حقل "العمل" باللغة الإنجليزية. والفرنسية.