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

राजनैतिक भूगोल और निर्वाचित प्रतिनिधि

Google नागरिकों से जुड़ी जानकारी का एपीआई, राजनैतिक भौगोलिक विभागों और अमेरिका से लेकर स्थानीय स्तर तक, अमेरिका के पतों के लिए चुने गए प्रतिनिधियों के बारे में जानकारी देता है. फ़िलहाल, हमारे पास राज्य, काउंटी, और संसदीय ज़िलों के लिए 100% कवरेज है. साथ ही, हम राज्य के विधान ज़िलों को 90% से ज़्यादा कवरेज देना चाहते हैं. निचले लेवल (जैसे कि शहर और काउंटी काउंसिल) को बेहतर बनाने की पूरी कोशिश की जाती है. यह समय समय के साथ बेहतर हो जाता है.

हम फ़ेडरल, राज्य, और काउंटी के लेवल पर चुने गए सभी अधिकारियों के बारे में अप-टू-डेट जानकारी देने की उम्मीद करते हैं. साथ ही, हम हर अमेरिकी राज्य के सबसे बड़े शहर के साथ-साथ 2,50,000 से ज़्यादा जनसंख्या वाले किसी भी शहर के अधिकारियों के बारे में अप-टू-डेट जानकारी चाहते हैं. हम इस डेटा को कई सोर्स से इकट्ठा करते हैं और बेहतरीन क्वालिटी की जानकारी दिखाते हैं. डेटा क्वालिटी से जुड़ी समस्याओं का पता चलने पर, हम कुछ चुनिंदा भौगोलिक विभागों, चुने गए अधिकारियों या चुने गए अधिकारियों का डेटा दिखाना बंद कर सकते हैं.

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

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

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

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

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

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

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

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

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

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

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

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

एट्रिब्यूशन

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

  • “नागरिकों की जानकारी देने वाले एपीआई की ओर से”
  • “नागरिकों की जानकारी देने वाले एपीआई से मिली मतदान की जानकारी”
  • “नागरिकों की जानकारी देने वाले एपीआई से मिले बैलेट की जानकारी”
  • “नागरिकों की जानकारी देने वाले एपीआई से मिली प्रतिनिधि जानकारी”
  • “ज़्यादा जानें”

स्थिति कोड

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

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