कोटा, क्रेडिट और सीमाएँ

हर कुंजी को एक मुफ़्त दैनिक कोटा मिलता है। उसके बाद अनुरोध प्रीपेड क्रेडिट से लिए जाते हैं या Unlimited पैकेज में शामिल होते हैं। हर रिस्पॉन्स अपने हेडर में बताता है कि आप कहाँ खड़े हैं।

दैनिक कोटा

कुंजी वाला कोटा प्रति कुंजी है, प्रति खाता नहीं: तीन कुंजियों का मतलब है तीन गुना 2,500 मुफ़्त अनुरोध। बिना कुंजी वाला कोटा प्रति पता है, और एक ही नेटवर्क के पते इसे साझा करते हैं। एक नेटवर्क और उससे इस्तेमाल होने वाली कुंजियाँ एक ही कोटा से लेती हैं: बिना कुंजी वाले अनुरोध घटाते हैं कि उसी नेटवर्क से इस्तेमाल होने वाली कुंजी को उस दिन कितना मिलेगा, और इसका उल्टा भी होता है, इसलिए मुफ़्त 2,500 एक ही जगह से दो बार नहीं लिए जा सकते। क्रेडिट प्रति खाता है और जो भी कुंजी अपने कोटा से आगे जाती है वह उसी से लेती है। दिन UTC कैलेंडर दिन है; X-Quota-Reset में अगले रीसेट का सटीक Unix समय होता है।

अनुरोध के रूप में क्या गिना जाता है

• किसी भी एंडपॉइंट पर हर सफल कॉल (200) एक के रूप में गिनी जाती है, चाहे उसे कुछ मिला हो या नहीं।
• बल्क कॉल की हर प्रविष्टि एक अनुरोध के रूप में गिनी जाती है: IP बैच का हर पता, कई बिंदुओं वाली ऊँचाई या समय क्षेत्र कॉल का हर बिंदु, ड्रॉप-इन होस्ट के बैच एंडपॉइंट की हर प्रविष्टि। मूल प्रदाता भी इन्हें इसी तरह गिनते हैं। बचे हुए कोटा से बड़ा बैच, कोई भी काम शुरू होने से पहले, आंशिक जवाब देने के बजाय प्रदाता की अपनी सीमा त्रुटि के साथ पूरा का पूरा अस्वीकार कर दिया जाता है। हर होस्ट प्रति कॉल उतनी ही प्रविष्टियाँ लेता है जितनी उसका मूल प्रदाता लेता है (ip-api और MapQuest के लिए 100, ipstack के लिए 50, Google elevation के लिए 512, ipinfo, Mapbox और Geoapify के लिए 1,000, Bing और Open-Elevation के लिए 1,024, Geocodio और TomTom के एसिंक्रोनस बैच के लिए 10,000; नेटिव एंडपॉइंट पर 100)। सहेजा गया एसिंक्रोनस परिणाम प्राप्त करने पर कुछ भी नहीं गिना जाता।
• 400, 401, 402, 403 या 404 के साथ अस्वीकार की गई कॉल गिनी नहीं जातीं और उनका कोई खर्च नहीं होता।
• 500 या 503 के साथ विफल होने वाली कॉल गिनी नहीं जातीं और उनका कोई खर्च नहीं होता।
• JavaScript ड्रॉप-इन से मैप टाइल, स्टाइल JSON और लाइब्रेरी लोड गिने नहीं जाते।

IP स्लॉट

एक कुंजी एक समय में दो IP पतों से काम करती है (Unlimited कुंजी के लिए तीन)। हर पता अपने पहले अनुरोध से 24 घंटे तक अपना स्लॉट रखता है और फिर उसे खाली कर देता है। जब सभी स्लॉट घिरे हों तब किसी और पते से आए अनुरोध को 403 key_ip_limit मिलता है, साथ में वह समय जब अगला स्लॉट खाली होगा। विवरण और उदाहरण ऑथेंटिकेशन पेज पर हैं।

अचानक बढ़ा ट्रैफ़िक

आज प्रति सेकंड अनुरोधों की कोई तय सीमा नहीं है, कुंजी के साथ या उसके बिना। जो ट्रैफ़िक बेकाबू लूप या हमले जैसा दिखता है उसे धीमा किया जा सकता है, और अगर आपकी किसी कुंजी के साथ ऐसा होता है तो हम आपको बताएँगे। अगर आपके पास कोई बड़ा काम है, तो हज़ारों अलग-अलग कॉल के बजाय बैच रूपों (ips, locations) का उपयोग करें।

हेडर पढ़ना

x-quota-limit: 2500          # free per day for this key; -1 on an Unlimited key
x-quota-used: 2431           # counted today on this key, including this request
x-quota-free-remaining: 69   # free requests left today on this key
x-credits-remaining: 148200  # requests the account's credit still covers
x-key-ips-used: 1            # IP slots currently held on this key
x-key-ips-limit: 2           # slots on this key
x-quota-reset: 1789948800    # Unix time of the next 00:00 UTC
x-request-id: 2726386e38428697

402 और 403 को संभालना

{ "status": "error", "error": { "code": "no_credits", "message": "The free allowance of 2500 requests for today is used and the account balance (€0.0000, 0 requests) does not cover this request. Add credit at https://www.mygeocode.com/dashboard or wait for the reset at 00:00 UTC." } }

लूप में दोबारा कोशिश न करें; जब तक क्रेडिट नहीं जोड़ा जाता या दिन रीसेट नहीं होता, जवाब वही रहेगा। X-Quota-Reset पढ़ें और या तो इंतज़ार करें, ऑपरेशन को विफल करके उपयोगकर्ता को बताएँ, या रिचार्ज करें। क्रेडिट कम होने पर डैशबोर्ड आपको ईमेल करता है।

{ "status": "error", "error": { "code": "key_ip_limit", "message": "This key is already in use from 2 IP addresses in the last 24 hours (limit 2). The next slot frees at 2026-09-21 23:06 UTC. Use another key or an additional Unlimited package for more addresses." } }

इसका मतलब है कि किसी ऐसी मशीन ने कुंजी का उपयोग करने की कोशिश की जो इस समय उसके स्लॉट रखने वालों में से नहीं है। आम तौर पर यह कोई नया सर्वर या नए पते के साथ दोबारा डिप्लॉय होता है; उस मशीन को उसकी अपनी कुंजी दें।

अनुरोध कम करना

आप परिणामों को अनिश्चित काल तक कैश कर सकते हैं, तो ज़रूर करें। पते अपनी जगह से नहीं हिलते; कल वही फ़ॉरवर्ड जियोकोड वही जवाब देगा। IP ब्लॉक धीरे-धीरे बदलते हैं; एक दिन सुरक्षित कैश समय है। किसी बिंदु के समय क्षेत्र के नियम कभी-कभार बदलते हैं और IANA नाम लगभग कभी नहीं। ऑटोकम्प्लीट के लिए इनपुट को लगभग 150 ms तक डिबाउंस करें और उपयोगकर्ता के कोई सुझाव चुन लेने के बाद अनुरोध भेजना बंद कर दें।