इस दस्तावेज़ में उस डेटा के लिए खास जानकारी दी गई है जो इसके लिए Google, मतदान स्थान और उम्मीदवार की जानकारी उपलब्ध कराएगा: राष्ट्रीय आईडी के आधार पर होने वाले चुनाव. यह दस्तावेज़ एक ड्राफ़्ट स्पेसिफ़िकेशन है इसका मकसद मुख्य तौर पर सुझाव/राय देना या शिकायत करना है. साथ ही, आने वाले समय में इसमें बदलाव हो सकता है.
टेबल
टेबल के इस सेट को अलग-अलग फ़ॉर्मैट में दिया जाना चाहिए टैब से अलग किए गए वैल्यू (TSV) वाली फ़ाइलें होती हैं. हर फ़ाइल एक हेडर लाइन, जिसमें उस टेबल के लिए फ़ील्ड मौजूद हैं. वैकल्पिक हेडर फ़ील्ड को शामिल करने की आवश्यकता नहीं है, अगर संबंधित फ़ील्ड में डालें. फ़ाइल की बाद की पंक्तियों में फ़ील्ड उसी क्रम में हो जिस क्रम में हेडर लाइन में बताया गया है.
फ़ाइलों के नाम सही होने चाहिए और उन्हें ZIP में बंडल के तौर पर स्टोर करना चाहिए संग्रहित करें. फ़ाइलों के नाम इस तरह रखे जाने चाहिए: votess.tsv, मिटाएंGroups.tsv, डिस्ट्रिक्ट.tsv, PoingLocations.tsv, गहराई,tsv, Office.tsv.
जब तक अलग से न बताया जाए, इस स्पेसिफ़िकेशन में बताए गए हर फ़ील्ड स्ट्रिंग. TSV फ़ाइलों को कॉमा या खास आइटम के लिए एस्केप करने की ज़रूरत नहीं होती है टैब के अलावा अन्य वर्ण. क्योंकि टैब इनमें से किसी के भी लिए सही नहीं होते हैं फ़ील्ड भरने की अनुमति नहीं है, तो हम उन्हें एक फ़ील्ड में होने के लिए.
* का इस्तेमाल टेबल में एक ज़रूरी फ़ील्ड को दिखाने के लिए किया जाता है
** का इस्तेमाल किसी ऐसी ज़रूरी फ़ील्ड को दिखाने के लिए किया जाता है जो इसके लिए एक प्राथमिक कुंजी भी है
वह टेबल (इस फ़ील्ड के लिए दो पंक्तियों में एक जैसा मान नहीं हो सकता)
Æ ऐसे फ़ील्ड के बारे में बताता है जिसे अंतरराष्ट्रीय तौर पर उपलब्ध कराना ज़रूरी है.
इंटरनैशनलाइजेशन
यह पक्का करने के लिए कि डेटा सही भाषा में दिखाया गया है हेडर पंक्ति के कुछ फ़ील्ड में स्थान-भाषा का ब्यौरा शामिल करना ज़रूरी है. क्योंकि कुछ देशों में एक से ज़्यादा भाषाओं का डेटा होता है. इसलिए, में दी गई है. ऐसे देशों के लिए, कॉलम में कॉलम के आखिर में एक अलग स्थान-भाषा के साथ दोहराया गया है और डैश से अलग करें, जैसे पार्टी अफ़िलिएशन-hi.
स्थान-भाषाएं बनाने के लिए भाषाओं, देशों, मुद्राओं, और टाइम ज़ोन के आइडेंटिफ़ायर. ये स्पेसिफ़िकेशन इन बातों पर निर्भर करते हैं: सबसे सही मौजूदा तरीके 47 - भाषाओं की पहचान करने के लिए टैग (BCP 47). अपेंडिक्स' देखें भाषा के टैग के उदाहरण के लिए, BCP 47 का A.
पहली टेबल - वोटर टेबल (ज़रूरी है)
NationalVoterId**, VoterGroupId
वोटर टेबल में मौजूद लाइन, एक वोटर को दिखाती है. हर मतदाता देश का एक राष्ट्रीय आईडी या वोटर आईडी है, तो इसे NationalVoterId फ़ील्ड. VoterGroupId से पता चलता है कि यह वोटिंग किस ग्रुप का हिस्सा है मतदाता इसका है.
ध्यान दें: जिन देशों में कोई लॉजिकल वोटिंग ग्रुप नहीं है, वहां VoterGroupId, NationalVoterId को दोहराया जा सकता है. इस मामले में, वोटिंग ग्रुप टेबल (टेबल 2) में मतदाताओं को सीधे तौर पर ज़िला आईडी और मतदान केंद्र आईडी.
दूसरी टेबल - वोटिंग ग्रुप की टेबल (ज़रूरी है)
VoterGroupId**, PollingLocationId*, ProvinceDistrictId,
CountyDistrictId, LocalityDistrictId
इस टेबल में मौजूद पंक्ति में किसी वोटिंग ग्रुप की पहचान की गई है, जहां वह ग्रुप PollingLocationId से मिले वोट. साथ ही, यह भी बताएं कि इस वोटिंग ग्रुप को कौनसे ज़िले के बारे में बताया गया है इनसे जुड़ा है. हर वोटिंग ग्रुप की पहचान, VoterGroupId. दिए गए लिंक के बाद से एक से ज़्यादा ज़िला आईडी तय किए जा सकते हैं वोटिंग ग्रुप, अलग-अलग लेवल के अलग-अलग अधिकारियों के लिए वोट कर सकता है सरकार. उदाहरण के लिए, अमेरिका में कोई भी व्यक्ति गवर्नर के लिए वोट कर सकता है राज्य स्तर पर, काउंटी स्तर पर एक काउंटी एक्ज़ीक्यूटिव, और एक मेयर शहरी स्तर पर तैयार किया जा सकता है.
ध्यान दें: वोटिंग ग्रुप में शामिल हर व्यक्ति को एक ही चुनाव में और एक ही मतदान केंद्र पर मतदान करना. ऐप्लिकेशन अगर ऐसा है, तो वोटिंग ग्रुप को एक से ज़्यादा वोटिंग ग्रुप में बांटा जाना चाहिए बात नहीं होती.
टेबल 3 - डिस्ट्रिक्ट टेबल (ज़रूरी है)
DistrictId**, AuthorityName*, LocalElectionOfficialName*,
LocalElectionOfficialPhone*, LocalElectionUrl*,
LocalElectionOfficialEmail, LocalElectionOfficialAddress
डिस्ट्रिक्ट टेबल की हर लाइन में, वोटिंग डिस्ट्रिक्ट का डेटा शामिल होता है इसमें स्थानीय चुनाव अधिकारी से जुड़ी जानकारी शामिल होगी. संस्था का नाम अगर ज़रूरी हो, तो फ़ील्ड में ज़िले का नाम होना चाहिए, उदाहरण के लिए, डिस्ट्रिक्ट ऑफ़ कोलंबिया.
टेबल 4 - पोलिंग के लिए जगह (ज़रूरी है)
PollingLocationId**, Address*Æ, Latitude, Longitude,
HoursOfOperationÆ, AdditionalDirectionsÆ,
ContactInfoÆ
हर मतदान केंद्र को, मतदान केंद्र की एक पंक्ति के ज़रिए दिखाया जाता है टेबल. पता फ़ील्ड में पूरी तरह से पोलिंग बूथ के लिए तय पता. पतों का इस्तेमाल इन कामों के लिए किया जा सकता है मैप के लिंक उपलब्ध कराएँ, ताकि जियो वेब साइटों पर सही पते मैप करने में मदद मिले वे सही हैं. ऐसे मामलों में जहां मैप किया जा सकने वाला पता संभव नहीं होता, वहां यह जानकारी उपयोगकर्ता को टेक्स्ट के रूप में दी जाएगी. अक्षांश और देशांतर वे वैकल्पिक फ़ील्ड होते हैं जिनमें जियोडेटिक अक्षांश और देशांतर. अक्षांश और देशांतर की जानकारी देने से मतदान स्थान के परिणामों की जाँच में गड़बड़ी की जानकारी.
अतिरिक्त दिशा-निर्देश वाला फ़ील्ड ज़रूरी नहीं है और इसमें दिशा-निर्देश हो सकते हैं पोलिंग बूथ को ढूंढने के लिए ज़रूरी है, जैसे कि इमारत के अंदर पते में दर्ज किया गया है. ContactInfo फ़ील्ड में इसके लिए ज़िम्मेदार अधिकारियों से संपर्क करने के लिए ज़रूरी जानकारी मतदान स्थान.
टेबल 5 - कैंडिडेट टेबल (ज़रूरी है)
CandidateId**, CandidateName*Æ,
PartyAffiliationÆ, OfficeId*, Url,
CampaignAddressÆ, Photo, Phone, TwitterHandle,
FacebookUsername, Email, YoutubeChannel
उम्मीदवार की टेबल की हर पंक्ति में किसी उम्मीदवार की जानकारी होती है. CandidateId किसी उम्मीदवार की खास तौर पर पहचान करती है. ऑफ़िस फ़ील्ड में नाम होता है वह उम्मीदवार जिस पद के लिए चुनाव लड़ रहा है. इसमें मौजूद दूसरे फ़ील्ड टेबल में उम्मीदवार के बारे में जानकारी दी जाती है.
टेबल 6 - ऑफ़िस टेबल
OfficeId**, DistrictId*, NameÆ, TermÆ,
DescriptionÆ
इस टेबल में हर ऑफ़िस के लिए एक पंक्ति होती है, जिसकी पहचान ऑफ़िस आईडी. ऑफ़िस का नाम और जानकारी भी शामिल है. डिस्ट्रिक्टId फ़ील्ड में प्रांत वोटिंग ग्रुप की टेबल में. उन ऑफ़िस के लिए जिन्हें सभी ने वोट दिया है सभी वोटर के लिए, ज़िला आईडी के तौर पर इस्तेमाल किया जाना चाहिए.
सैंपल
पोलिंग की जगह की जानकारी के डेटा फ़ाइल हेडर का सैंपल
फ़ाइल: वोटर.tsv
हेडर:
NationalVoterId VoterGroupId
फ़ाइल: वोटिंगGroups.tsv
हेडर:
VoterGroupId PollingLocationId
फ़ाइल: PolingLocations.tsv
हेडर:
PollingLocationId Address HoursOfOperation
कई भाषाओं वाले फ़ाइल हेडर का सैंपल
अगर किसी देश में एक से ज़्यादा भाषाएं होती हैं, तो हर फ़ाइल का हेडर अतिरिक्त फ़ील्ड, जो शामिल किए गए डेटा की भाषा/इलाके के बारे में बताते हैं डालें. सिर्फ़ ऐसे फ़ील्ड जिन्हें अंतरराष्ट्रीय स्तर पर इस्तेमाल के लिए मार्क किया गया है, उदाहरण के लिए, ऊपर दी गई टेबल में मौजूद जानकारी में Æ मार्कर के साथ यह होना चाहिए स्थान-भाषा जोड़ी गई.
फ़ाइल: PolingLocations.tsv
हेडर:
PollingLocationId Address HoursOfOperation-en HoursOfOperation-fr
इस आसान उदाहरण में कारोबार के खुले होने का समय अंग्रेज़ी में दिखाया गया है और फ़्रेंच जैपनीज़ हैं.