इस महीने हमने क्या लॉन्च किया: जियोकोडिंग, IP, समय क्षेत्र और बहुत कुछ
पूरे API में हाल के काम का सार: नए कम्पैटिबिलिटी होस्ट, तेज़ समय क्षेत्र और ऊँचाई लुकअप, डैशबोर्ड की सुविधाएँ, और कोटा की ज़्यादा साफ़ जानकारी।
PositionStack के साथ ड्रॉप-इन कम्पैटिबिलिटी लाइव है
PositionStack आम तौर पर हल्के इंटीग्रेशन में दिखता है, अक्सर किसी बड़े एप्लिकेशन के अंदर एक API कॉल को लपेटने वाली एक सर्विस क्लास के रूप में। इस तरह का इंटीग्रेशन इतना छोटा होता है कि आसानी से नज़रअंदाज़ हो जाए और इतना बड़ा कि दोबारा लिखना झंझट लगे। हमारा कम्पैटिबिलिटी होस्ट उस दोबारा लिखने को पूरी तरह हटाने के लिए है।
यह होस्ट PositionStack के अनुरोध पैरामीटर और रिस्पॉन्स बॉडी को हूबहू दोहराता है, सिवाय कॉपीराइट, शर्तों और प्राइवेसी वाले टेक्स्ट के, जो मूल प्रोवाइडर का नहीं बल्कि हमारा है। PositionStack के जियोकोडिंग एंडपॉइंट के लिए बना अनुरोध बिना बदलाव के हमारे होस्ट पर भेजा जा सकता है, और रिस्पॉन्स उसी संरचना में लौटता है जिसे मौजूदा कोड पहले से पार्स करता है।
बदलता है एक होस्ट नाम और एक कुंजी। वह कुंजी हमारे चार मानक तरीकों में से उसी से ऑथेंटिकेट होती है जो आपका इंटीग्रेशन पहले से इस्तेमाल करता है: X-API-Key हेडर, Authorization: Bearer हेडर, कुंजी को यूज़रनेम बनाकर HTTP Basic auth, या क्वेरी पैरामीटर।
एक कॉल को लपेटने वाली एक सर्विस क्लास उसी तरह का इंटीग्रेशन भी है जिसके दस्तावेज़ कोई नहीं रखता, इसलिए सवाल अक्सर बाद में उस व्यक्ति से सपोर्ट टिकट के रूप में आते हैं जिसे कोड विरासत में मिला। My Geocode की सपोर्ट कतार में ठीक इन्हीं बार-बार आने वाले कम्पैटिबिलिटी सवालों के लिए तैयार जवाब रहते हैं, जैसे हेडर का मतलब, कुंजी के फ़ॉर्मेट, क्या बदलता है और क्या नहीं, ताकि माइग्रेशन का सीधा सवाल ज़्यादा उलझे सवालों के पीछे इंतज़ार करने के बजाय जल्दी हल हो जाए।
कोई भी कोड छूने से पहले रिस्पॉन्स की संरचना टेस्ट करना भी आसान है: /demo/ पर इंटरैक्टिव डेमो किसी भी एंडपॉइंट या कम्पैटिबिलिटी होस्ट पर एक सैंपल अनुरोध भेजकर ठीक वे फ़ील्ड दिखा सकता है जो लौटते हैं, और यह अक्सर यह पक्का करने के लिए काफ़ी होता है कि PositionStack जैसी संरचना वाली कॉल आगे साफ़-सुथरे ढंग से पार्स होगी।
कीमतें इस आधार पर नहीं बदलतीं कि अनुरोध किस कम्पैटिबिलिटी होस्ट ने संभाला। किसी भी पते को बिना कुंजी के प्रतिदिन 2,500 मुफ़्त अनुरोध मिलते हैं, जो नेटवर्क के हिसाब से गिने जाते हैं। एक कुंजी अपने प्रतिदिन 2,500 और मुफ़्त अनुरोध जोड़ती है। दोनों कोटों के बाद प्रीपेड क्रेडिट €0.0001 प्रति अनुरोध है, या एक Unlimited पैकेज €50 प्रति माह में उपयोग कवर करता है, जो प्लेटफ़ॉर्म के हर दूसरे एंडपॉइंट और होस्ट से बिल्कुल मेल खाता है।
हर रिस्पॉन्स में हमारे कोटा हेडर भी होते हैं: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit और X-Quota-Reset, जो उपयोग की ऐसी जानकारी देते हैं जो एक सामान्य PositionStack इंटीग्रेशन वैसे नहीं दिखाता।
कम्पैटिबल रिस्पॉन्स के मानक फ़ील्ड से आगे कुछ भी चाहिए तो अनुरोध पर mg_extras=1 या X-MG-Extras हेडर ऊपर वैकल्पिक एक्स्ट्रा जोड़ देता है, पूरी तरह ऑप्ट-इन और डिफ़ॉल्ट रूप से बंद।
होस्ट के दस्तावेज़ /compatibility/positionstack/ पर हैं, और सभी सत्रह कम्पैटिबिलिटी होस्ट कैसे काम करते हैं, इसका व्यापक विवरण /docs/compatibility/ पर है। अगर PositionStack आपके स्टैक में कहीं किसी सर्विस में छिपा है, तो उसे यहाँ मोड़ना टेस्ट करने के लिए एक छोटा, वापस लिया जा सकने वाला बदलाव है।