डेवलपर के डेटा से जुड़े दिशा-निर्देश

वोटिंग के बारे में जानकारी

Google Civic Information API, लोगों को नागरिकता से जुड़ी जानकारी देता है. जैसे, वोट डालने की जगह, जल्दी वोट डालने की जगह, स्थानीय चुनाव अधिकारी की संपर्क जानकारी, और मतपत्र की जानकारी. यह जानकारी, Voting Information Project के तहत होने वाले चुनावों के लिए दी जाती है.

डेटा की उपलब्धता

डेवलपर के लिए दिशा-निर्देश

हम सभी डेवलपर से इन दिशा-निर्देशों का पालन करने के लिए कहते हैं:

  • एपीआई की सेवा की शर्तों का पालन करें.
  • एपीआई का इस्तेमाल करके, डेवलपर इस बात से सहमत होते हैं कि अगर कोई कैश-कंट्रोल हेडर मौजूद है, तो वे उसका पालन करेंगे. कैश मेमोरी को कंट्रोल करने वाले हेडर मौजूद न होने पर, डेवलपर इस बात से सहमत होते हैं कि वे वोटिंग की जगहों और प्रतियोगिता की जानकारी को 24 घंटे से ज़्यादा समय तक कैश मेमोरी में सेव नहीं करेंगे. साथ ही, वे पद पर मौजूद लोगों और ज़िलों की जानकारी को 30 दिनों से ज़्यादा समय तक कैश मेमोरी में सेव नहीं करेंगे.
  • एपीआई का इस्तेमाल करने वाले डेवलपर को यह पक्का करना चाहिए कि सभी उपयोगकर्ताओं को एक जैसा अनुभव मिले. हम होल्डबैक, A/B टेस्टिंग या इसी तरह के एक्सपेरिमेंट की अनुमति नहीं देते.

  • अगर आपको अपने इस्तेमाल के उदाहरण के लिए ज़्यादा कोटा चाहिए, तो Developer Console में जाकर, हर प्रोजेक्ट के लिए कोटा बढ़ाने का अनुरोध करें. ज़्यादा कोटा सीमित तौर पर दिया जाता है और यह ज़्यादा से ज़्यादा तय सीमा के हिसाब से होता है.

    ध्यान दें: मंज़ूरी मिलने में एक से दो महीने लगते हैं.इसलिए, कोटा बढ़ाने के अनुरोधों की योजना इसी हिसाब से बनाएं. साल 2024 में होने वाले राष्ट्रपति चुनाव के लिए,कोटा बढ़ाने के अनुरोध अगस्त तक सबमिट करें.

  • Civic Info API के लिए अतिरिक्त कोटा, सिर्फ़ उपयोगकर्ता के लिए उपलब्ध इस्तेमाल के उदाहरणों के लिए होता है. इस्तेमाल के अन्य उदाहरणों के लिए, कोटा बढ़ाने के अनुरोध स्वीकार नहीं किए जाते.

डेटा के बारे में अन्य दिशा-निर्देश

इस डेटा को मैनेज करना काफ़ी मुश्किल होता है. कृपया इन बातों का ध्यान रखें.

  • चुनाव के अधिकारी, चुनाव से कुछ हफ़्ते पहले और यहां तक कि कुछ दिन पहले भी इस डेटा में अक्सर बदलाव करते हैं. उपयोगकर्ताओं को यह चेतावनी देना बेहतर है कि वे वोट करने से पहले, इस बारे में दोबारा जांच कर लें.
  • ज़्यादातर आधिकारिक फ़ीड में सड़क के सेगमेंट होते हैं. इसका मतलब है कि चुनाव अधिकारी, कई पतों को मतदान केंद्रों और पोलिंग जगहों से जोड़ते हैं. ऐसा हो सकता है कि इन पतों पर कोई मतदाता रजिस्टर न हो. इसलिए, जिन राज्यों में Voting Information Project के ज़रिए आधिकारिक फ़ीड उपलब्ध कराए जाते हैं वहां ऐसे पते के लिए भी 'सफल' नतीजा मिल सकता है जहां कोई भी मतदाता रजिस्टर नहीं है.
  • जिन राज्यों में आधिकारिक फ़ीड उपलब्ध नहीं है वहां सिर्फ़ उन पतों की पुष्टि हो पाएगी जहां कोई मतदाता रजिस्टर है.
  • कभी-कभी, हमारे पास एक ही जानकारी के लिए कई सोर्स होते हैं. हम स्थानीय चुनाव अधिकारी की संपर्क जानकारी और मतपत्र की जानकारी के लिए, सबसे अच्छी क्वालिटी वाली जानकारी उपलब्ध कराते हैं. इस व्यवहार को बदलने का कोई तरीका नहीं है. हालांकि, officialSourcesOnly पैरामीटर का इस्तेमाल करके, गैर-आधिकारिक स्रोतों को हटाया जा सकता है. पोलिंग स्टेशन की जानकारी के लिए, हम हमेशा आधिकारिक डेटा सोर्स को अन्य सोर्स के मुकाबले प्राथमिकता देते हैं.
  • अगर हमें डेटा क्वालिटी से जुड़ी समस्याएं मिलती हैं, तो हम किसी चुनावी ज़िले के लिए कोई डेटा नहीं दिखा सकते. ऐसा तब तक किया जा सकता है, जब तक समस्या हल नहीं हो जाती.
  • अगर हमारे पास किसी पते का डेटा नहीं है, तो इसका मतलब यह नहीं है कि उस पते पर कोई भी व्यक्ति वोट देने के लिए रजिस्टर नहीं है. ऐप्लिकेशन को उपयोगकर्ताओं को पूरी जानकारी देने के लिए, स्थानीय चुनाव अधिकारियों से संपर्क करने के लिए कहना चाहिए.
  • चुनाव के दिन के बाद, चुनाव अपने-आप बंद हो जाते हैं. इसके बाद, चुनाव के लिए कोई डेटा नहीं दिखाया जाएगा.

एट्रिब्यूशन

Civic Information API को एट्रिब्यूट करना ज़रूरी नहीं है. अगर कोई डेवलपर, Civic Information API को एट्रिब्यूट करने का विकल्प चुनता है और उपयोगकर्ताओं को Civic Information API के बारे में ज़्यादा जानकारी देने के लिए लिंक करता है, तो हम डेवलपर से अनुरोध करते हैं कि वे एट्रिब्यूशन के लिए, यहां दिए गए भाषा के विकल्पों में से किसी एक का इस्तेमाल करें. साथ ही, नीचे दिए गए वेबपेज को लिंक करें:

  • “Civic Information API की मदद से उपलब्ध कराई गई जानकारी”
  • “Civic Information API की मदद से वोटिंग की जानकारी दी गई है”
  • “चुनाव से जुड़ी जानकारी, Civic Information API से ली गई है”
  • “ज़्यादा जानें”

स्टेटस कोड

voterInfoQuery को किए गए कॉल में एक status फ़ील्ड शामिल होता है. पते को स्वीकार किए जाने पर, इसे success पर सेट किया जाता है. अन्य मामलों में, गड़बड़ी का कोड दिखेगा. गड़बड़ी कोड के बारे में सामान्य जानकारी यहां दी गई है. ध्यान दें कि गड़बड़ी का कोड मौजूद होने पर भी जानकारी मिल सकती है.

स्थिति जानकारी
success एपीआई ने अनुरोध किए गए पते को मान्य पते के तौर पर पहचान लिया है.
noStreetSegmentFound फ़िलहाल, एपीआई के पास इस पते के चुनावी क्षेत्र और/या ज़िले के बारे में कोई जानकारी नहीं है. ऐसा हो सकता है कि हम अब भी नया डेटा इकट्ठा/प्रोसेस कर रहे हों या इस पते पर वोट देने के लिए किसी भी मतदाता ने रजिस्टर न किया हो.
addressUnparseable अनुरोध किए गए पते को सही तरीके से फ़ॉर्मैट नहीं किया गया है या उसे जियोकोड नहीं किया जा सकता. इसका मतलब है कि Google Maps API को इस पते के बारे में कोई जानकारी नहीं है.
noAddressParameter कोई पता नहीं दिया गया था.
multipleStreetSegmentsFound एपीआई को दिए गए पते की जानकारी नहीं मिल रही है. हालांकि, उसे आस-पास के पतों की जानकारी मिल रही है. ज़्यादा जानकारी के लिए, उपयोगकर्ता को अपने चुनाव अधिकारी से संपर्क करना चाहिए.
electionOver जिस चुनाव के लिए अनुरोध किया गया था वह खत्म हो गया है. चुनाव के लिए एपीआई के नतीजे अब उपलब्ध नहीं हैं. आने वाले चुनाव का आईडी ढूंढने के लिए, electionQuery करें.
electionUnknown अनुरोध किया गया चुनाव आईडी अमान्य है. मान्य आईडी ढूंढने के लिए, electionQuery करें.
internalLookupFailure अनुरोध को प्रोसेस करते समय कोई गड़बड़ी हुई है.