वोटिंग से जुड़ी जानकारी
डेटा की उपलब्धता
डेवलपर के लिए दिशा-निर्देश
हम सभी डेवलपर से इन दिशा-निर्देशों का पालन करने का अनुरोध करते हैं:
- एपीआई की सेवा की शर्तों का पालन करें.
- एपीआई का इस्तेमाल करके, डेवलपर इस बात से सहमत होते हैं कि वे कैश-कंट्रोल हेडर का पालन करेंगे. हालांकि, यह ज़रूरी नहीं है कि कैश-कंट्रोल हेडर मौजूद हो. अगर कैश-कंट्रोल हेडर मौजूद नहीं हैं, तो डेवलपर इस बात से सहमत होते हैं कि वे वोटिंग की जगहों और चुनाव की जानकारी को 24 घंटे से ज़्यादा समय के लिए कैश नहीं करेंगे. साथ ही, वे चुने गए पदाधिकारियों और ज़िलों की जानकारी को 30 दिनों से ज़्यादा समय के लिए कैश नहीं करेंगे.
- एपीआई का इस्तेमाल करने वाले डेवलपर को यह पक्का करना चाहिए कि सभी उपयोगकर्ताओं को एक जैसा अनुभव मिले. हम होल्डबैक, A/B टेस्टिंग या इसी तरह के अन्य एक्सपेरिमेंट की अनुमति नहीं देते.
अगर आपको अपने इस्तेमाल के उदाहरण के लिए, ज़्यादा कोटा चाहिए, तो Developer Console में जाकर, हर प्रोजेक्ट के लिए कोटा बढ़ाने का अनुरोध किया जा सकता है. ज़्यादा कोटा देने की सुविधा सीमित है. साथ ही, इसके लिए ज़्यादा से ज़्यादा कोटा तय है.
ध्यान दें: मंज़ूरी की प्रोसेस में एक से दो महीने लगते हैं. इसलिए, हमारा सुझाव है कि डेवलपर, कोटा बढ़ाने के अनुरोधों की योजना इसी हिसाब से बनाएं. हमारा सुझाव है कि नवंबर में होने वाले चुनाव के लिए, कोटा बढ़ाने के अनुरोध अगस्त के आखिर तक सबमिट कर दिए जाएं.
- चुनाव से जुड़ी जानकारी देने वाले एपीआई के लिए, अतिरिक्त कोटा सिर्फ़ उपयोगकर्ताओं के लिए उपलब्ध इस्तेमाल के उदाहरणों के लिए दिया जाता है. इस्तेमाल के अन्य उदाहरणों के लिए, कोटा बढ़ाने के अनुरोधों को स्वीकार नहीं किया जाता.
डेटा के लिए अन्य दिशा-निर्देश
इस डेटा के साथ काम करना मुश्किल हो सकता है. कृपया इन बातों का ध्यान रखें.
- चुनाव अधिकारी, चुनाव से कुछ हफ़्ते पहले और यहां तक कि कुछ दिन पहले भी इस डेटा में अक्सर बदलाव करते हैं. हमारा सुझाव है कि उपयोगकर्ताओं को यह चेतावनी दी जाए कि उन्हें वोट डालने से पहले, इस डेटा की पुष्टि कर लेनी चाहिए.
- ज़्यादातर आधिकारिक फ़ीड में, सड़कों के सेगमेंट शामिल होते हैं. इसका मतलब है कि चुनाव अधिकारी, पतों की एक रेंज को प्रीसिंक्ट और पोलिंग बूथ से जोड़ते हैं. ऐसा हो सकता है कि इन पतों पर कोई मतदाता रजिस्टर न हो. इसलिए, जिन राज्यों में वोटिंग से जुड़ी जानकारी देने वाले प्रोजेक्ट के तहत आधिकारिक फ़ीड उपलब्ध हैं उनमें ऐसे पते के लिए भी 'सफल' का मैसेज दिख सकता है जहां कोई मतदाता रजिस्टर नहीं है.
- जिन राज्यों में आधिकारिक फ़ीड उपलब्ध नहीं है उनमें सिर्फ़ उन पतों के लिए 'सफल' का मैसेज दिखेगा जहां कोई मतदाता रजिस्टर है.
- कभी-कभी, हमारे पास एक ही जानकारी के लिए कई सोर्स होते हैं. हम स्थानीय चुनाव अधिकारी की संपर्क जानकारी और बैलेट से जुड़ी जानकारी के लिए, सबसे अच्छी क्वालिटी वाली जानकारी उपलब्ध कराते हैं. इस व्यवहार को बदला नहीं जा सकता. हालांकि, officialSourcesOnly पैरामीटर का इस्तेमाल करके, गैर-आधिकारिक सोर्स को हटाया जा सकता है. पोलिंग बूथ की जानकारी के लिए, हम हमेशा आधिकारिक डेटा सोर्स को प्राथमिकता देते हैं.
- अगर हमें डेटा क्वालिटी से जुड़ी समस्याएं मिलती हैं, तो हम किसी खास चुनावी ज़िले के लिए, तब तक कोई डेटा नहीं दिखाएंगे, जब तक समस्या हल नहीं हो जाती.
- अगर हमारे पास किसी पते का डेटा नहीं है, तो इसका मतलब यह नहीं है कि वहां वोट करने के लिए कोई व्यक्ति रजिस्टर नहीं है. ऐप्लिकेशन को उपयोगकर्ताओं को पूरी जानकारी के लिए, उनके स्थानीय चुनाव अधिकारियों के पास भेजना चाहिए.
- चुनाव वाले दिन के बाद, चुनाव अपने-आप खत्म हो जाते हैं. इसके बाद, चुनाव के लिए कोई डेटा नहीं दिखाया जाएगा.
एट्रिब्यूशन
चुनाव से जुड़ी जानकारी देने वाले एपीआई को एट्रिब्यूट करना ज़रूरी नहीं है. अगर कोई डेवलपर, चुनाव से जुड़ी जानकारी देने वाले एपीआई को एट्रिब्यूट करता है और उपयोगकर्ताओं को चुनाव से जुड़ी जानकारी देने वाले एपीआई के बारे में ज़्यादा जानकारी से लिंक करता है, तो हमारा सुझाव है कि डेवलपर, एट्रिब्यूशन के लिए यहां दी गई भाषा के विकल्पों में से किसी एक का इस्तेमाल करें. साथ ही, नीचे दिए गए वेबपेज को लिंक करें:
- “चुनाव से जुड़ी जानकारी देने वाले एपीआई की मदद से”
- “चुनाव से जुड़ी जानकारी, चुनाव से जुड़ी जानकारी देने वाले एपीआई की मदद से”
- “बैलेट से जुड़ी जानकारी, चुनाव से जुड़ी जानकारी देने वाले एपीआई की मदद से”
- “ज़्यादा जानें”
स्टेटस कोड
voterInfoQuery के कॉल में, status फ़ील्ड शामिल होता है. जब किसी पते को स्वीकार किया जाता है, तो इसकी वैल्यू success पर सेट हो जाती है. अन्य मामलों में, गड़बड़ी का कोड दिखाया जाएगा. गड़बड़ी के कोड के लिए सामान्य स्पष्टीकरण यहां दिए गए हैं. ध्यान दें कि गड़बड़ी का कोड मौजूद होने पर भी, जानकारी दिखाई जा सकती है.
| स्टेटस | स्पष्टीकरण |
|---|---|
success |
एपीआई, अनुरोध किए गए पते को मान्य पता मानता है. |
noStreetSegmentFound |
फ़िलहाल, एपीआई के पास इस पते के चुनावी प्रीसिंक्ट और/या ज़िले के बारे में कोई जानकारी नहीं है. ऐसा हो सकता है कि हम अब भी नया डेटा सोर्स कर रहे हों/प्रोसेस कर रहे हों या इस पते पर वोट करने के लिए कोई मतदाता रजिस्टर न हो. |
addressUnparseable |
अनुरोध किया गया पता सही फ़ॉर्मैट में नहीं है या इसे जियोकोड नहीं किया जा सकता. इसका मतलब है कि Google Maps API को इस पते के बारे में कोई जानकारी नहीं है. |
noAddressParameter |
कोई पता नहीं दिया गया. |
multipleStreetSegmentsFound |
एपीआई, बताए गए पते के लिए जानकारी नहीं ढूंढ सका. हालांकि, इसके पास आस-पास के पतों के बारे में जानकारी है. ज़्यादा जानकारी के लिए, उपयोगकर्ता को अपने चुनाव अधिकारी से संपर्क करना चाहिए. |
electionOver |
अनुरोध किया गया चुनाव खत्म हो गया है. अब चुनाव के लिए, एपीआई के नतीजे उपलब्ध नहीं हैं. आने वाले चुनाव के लिए आईडी ढूंढने के लिए, electionQuery करें. |
electionUnknown |
अनुरोध किया गया चुनाव आईडी अमान्य है. मान्य आईडी ढूंढने के लिए, electionQuery करें. |
internalLookupFailure |
अनुरोध को प्रोसेस करने के दौरान, कोई ऐसी गड़बड़ी हुई जिसके बारे में जानकारी नहीं है. |