समाचार

पतों की सूचियों के लिए एक नया बल्क एंडपॉइंट

पतों की सूची को एक-एक करके, एक HTTP कॉल के बाद दूसरी, प्रोसेस करना कम मात्रा के लिए ठीक काम करता है, लेकिन किसी भी असली पैमाने पर जल्दी ही थकाऊ हो जाता है। अब हम पूरी पता सूची को एक ही बल्क कॉल में भेजने का सपोर्ट देते हैं, जिससे किसी बड़ी सूची को प्रोसेस करने के लिए ज़रूरी राउंड ट्रिप कम हो जाते हैं, और मूल्य निर्धारण में कोई बदलाव नहीं होता।

यहाँ गिनती का नियम ठीक वही है जो हम प्लेटफ़ॉर्म पर बाकी हर जगह लागू करते हैं: बल्क कॉल के अंदर हर पता एक अनुरोध गिना जाता है, पूरी कॉल नहीं। पाँच सौ पतों की सूची एक बल्क कॉल में भेजें, तो वह लागू कोटा से पाँच सौ अनुरोध खर्च करती है, चाहे वह मुफ़्त दैनिक कोटा हो, €0.0001 प्रति अनुरोध वाला प्रीपेड क्रेडिट हो, या Unlimited पैकेज का कवरेज। काम को एक कॉल में जोड़ने या कई छोटी कॉल में भेजने पर न कोई छूट है और न कोई जुर्माना।

कोटा हेडर भी बल्क कॉल को सटीक रूप से दिखाते हैं। X-Quota-Used, X-Quota-Free-Remaining और X-Credits-Remaining सभी उतने ही बदलते हैं जितने पते कॉल में असल में प्रोसेस हुए, इसलिए एक बड़ा बल्क अनुरोध आपके दिखने वाले कोटा को उसी तरह अपडेट करता है जैसे पाँच सौ अलग-अलग कॉल करतीं, बस पाँच सौ के बजाय एक राउंड ट्रिप में।

यह ठीक उसी तरह के काम के लिए है जिसके लिए पहले एक-एक पते वाली कॉल के चारों ओर लूप लिखना पड़ता था: जियोकोडिंग की ज़रूरत वाली ग्राहक सूची इम्पोर्ट करना, पतों का डेटाबेस साफ़ करना, या कोई बड़ा बैच जॉब तैयार करना जो किसी एक यूज़र की कार्रवाई के जवाब में नहीं, बल्कि शेड्यूल पर चलता है। उस सूची को एक बल्क कॉल में भेजने से कई अलग HTTP कनेक्शन संभालने का बोझ कम होता है, जो खास तौर पर उन जॉब के लिए उपयोगी है जो ऐसे इन्फ्रास्ट्रक्चर पर चलते हैं जिसकी हमारी सीमाओं के अलावा अपनी कनेक्शन या रेट सीमाएँ होती हैं।

ऑथेंटिकेशन और सामान्य व्यवहार में कोई बदलाव नहीं है: वही चार कुंजी तरीके काम करते हैं, वही कोटा नियम लागू होते हैं, और वही मुफ़्त कोटा किसी असली खर्च से पहले ठोस टेस्टिंग के लिए काफ़ी है। किसी भी पता आधारित लुकअप की तरह, फ़ॉरवर्ड और रिवर्स जियोकोडिंग के परिणाम अब भी हमारे उस बैकएंड का हिस्सा हैं जो असली दुनिया के भरे हुए परिणामों के लिए अभी विकसित हो रहा है, इसलिए इस बल्क सुविधा का दस्तावेज़ खास तौर पर इसकी अनुरोध संरचना और गिनती के व्यवहार पर केंद्रित है।

बल्क अनुरोध भेजने का पूरा दस्तावेज़, अनुरोध के फ़ॉर्मेट सहित, /docs/forward-geocoding/ और /docs/reverse-geocoding/ पर उपलब्ध है। अगर आपका वर्कफ़्लो अभी एक-एक पते वाली कॉल पर लूप चलाता है, तो एक साथ कुछ से ज़्यादा पते प्रोसेस करने वाली किसी भी चीज़ के लिए इसे देखना फ़ायदेमंद है।