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

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

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

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

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

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

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

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

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

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

डेटा से जुड़े अन्य दिशा-निर्देश

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

  • चुनाव के आखिरी कुछ हफ़्तों और चुनाव से पहले के कुछ दिनों में, चुनाव के अधिकारी इस डेटा में अक्सर बदलाव करते हैं. उपयोगकर्ताओं को चेतावनी देना अच्छा होगा कि वे वोट करने से पहले वापस आकर देख लें.
  • ज़्यादातर आधिकारिक फ़ीड में सड़क के सेगमेंट होते हैं. इसका मतलब है कि चुनाव अधिकारी, मतदान केंद्रों और मतदान की जगहों के लिए पतों की एक सीमा तय करते हैं. हो सकता है कि इन रेंज में, उन पतों पर कोई मतदाता रजिस्टर न हो. इसलिए, जिन राज्यों ने वोटिंग इन्फ़ॉर्मेशन प्रोजेक्ट के ज़रिए आधिकारिक फ़ीड उपलब्ध कराए हैं उनके लिए, ऐसे पते के लिए भी 'सफ़लता' का मैसेज मिल सकता है जहां कोई मतदाता रजिस्टर नहीं है.
  • जिन राज्यों ने आधिकारिक फ़ीड उपलब्ध नहीं कराया है उनके लिए, सिर्फ़ उन पतों की जानकारी मिलेगी जहां कोई मतदाता रजिस्टर है.
  • कभी-कभी, एक ही जानकारी के लिए हमारे पास कई सोर्स होंगे. हम स्थानीय चुनाव अधिकारी की संपर्क जानकारी और मतपत्र की जानकारी के लिए, सबसे अच्छी क्वालिटी की जानकारी उपलब्ध कराते हैं. इस व्यवहार को बदलने का कोई तरीका नहीं है. हालांकि, 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 अनुरोध को प्रोसेस करने के दौरान कोई गड़बड़ी हुई.