इस महीने हमने क्या लॉन्च किया: जियोकोडिंग, IP, समय क्षेत्र और बहुत कुछ
पूरे API में हाल के काम का सार: नए कम्पैटिबिलिटी होस्ट, तेज़ समय क्षेत्र और ऊँचाई लुकअप, डैशबोर्ड की सुविधाएँ, और कोटा की ज़्यादा साफ़ जानकारी।
हर रिस्पॉन्स पर कोटा हेडर: कॉल करने से पहले अपनी सीमा जानें
ज़्यादातर API आपको उपयोग की अपनी स्थिति के बारे में तब तक अंदाज़ा लगाने देते हैं जब तक कुछ टूट न जाए। My Geocode एक अलग तरीका अपनाता है: हर एक रिस्पॉन्स, हर एंडपॉइंट और हर कम्पैटिबिलिटी होस्ट पर, कोटा हेडर का पूरा सेट लेकर आता है जो ठीक-ठीक बताता है कि आप कहाँ हैं।
X-Quota-Limit और X-Quota-Used कॉल करने वाली कुंजी या नेटवर्क की बुनियादी तस्वीर देते हैं। X-Quota-Free-Remaining दिखाता है कि मुफ़्त दैनिक कोटा कितना बचा है, और X-Quota-Network-Used दर्शाता है कि उस साझा, प्रति-नेटवर्क मुफ़्त कोटा का कितना हिस्सा उसी कनेक्शन के किसी पते या कुंजी ने पहले ही उपयोग कर लिया है। X-Credits-Remaining उन सभी के लिए प्रीपेड क्रेडिट बैलेंस दिखाता है जो मुफ़्त श्रेणी से आगे हैं और Unlimited पैकेज पर नहीं हैं। X-Key-IPs-Used और X-Key-IPs-Limit यह ट्रैक करते हैं कि किसी कुंजी का उपयोग कितने अलग-अलग पतों से हुआ है, और X-Quota-Reset बताता है कि दैनिक काउंटर कब रीसेट होते हैं।
यह क्यों मायने रखता है, इसका कारण सरल है: जो स्क्रिप्ट अपना कोटा देख सकती है, वह उसके हिसाब से समझदारी से व्यवहार कर सकती है। वह ब्लॉक होने से पहले धीमी हो सकती है, क्रेडिट कम होने पर डेवलपर को अलर्ट कर सकती है, या पहले विफल होकर बाद में प्रतिक्रिया देने के बजाय अपने आप मुफ़्त कुंजी से सशुल्क कुंजी पर जा सकती है। इनमें से किसी के लिए अलग उपयोग एंडपॉइंट को कॉल करने या हाथ से डैशबोर्ड देखने की ज़रूरत नहीं है। यह जानकारी उसी जवाब के साथ आती है जो आपने पहले ही माँगा था।
यह सच है, चाहे आप हमारे मूल एंडपॉइंट का उपयोग कर रहे हों या सत्रह कम्पैटिबिलिटी होस्ट में से किसी एक का। Google Maps Platform, Bing Maps REST Services या ipstack की कॉल के ढाँचे वाला अनुरोध भी हमारे कोटा हेडर के साथ लौटता है, उस प्रदाता के फ़ॉर्मैट से मेल खाने वाले रिस्पॉन्स बॉडी के अलावा। प्रदाता बदलने का मतलब यह दृश्यता खोना नहीं है, बल्कि इसे उन जगहों पर पाना है जहाँ यह पहले कभी थी ही नहीं।
हर कुंजी को मुफ़्त दैनिक कोटा मिलता है। उसके बाद, अनुरोध प्रीपेड क्रेडिट से लिए जाते हैं या Unlimited पैकेज से कवर होते हैं। हर रिस्पॉन्स अपने हेडर में बताता है कि आप कहाँ हैं, जो किसी एक कॉल पर छोटी बात है और ट्रैफ़िक से भरे पूरे दिन में सचमुच उपयोगी।
एक बार की स्क्रिप्ट से ज़्यादा कुछ भी बनाने वाली टीमों के लिए हमारा सुझाव है कि शुरुआत से ही इन हेडर को अपने अनुरोध लॉग के साथ लॉग करें। X-Quota-Free-Remaining का उम्मीद से तेज़ी से घटना एक चुपचाप चलता रुझान है, जिसे सपोर्ट टिकट की तुलना में ग्राफ़ पर देखना कहीं सस्ता है। हर हेडर का पूरा विवरण और उसे क्या ट्रिगर करता है, यह /docs/rate-limits/ पर दर्ज है, साथ में ऑथेंटिकेशन का सामान्य मार्गदर्शन /docs/authentication/ पर है।