माइग्रेशन

PositionStack से माइग्रेट करना

PositionStack चीज़ों को उतना ही सरल रखता है जितना कोई जियोकोडिंग API रख सकता है: एक access_key query पैरामीटर, और एक JSON data ऐरे, जिसकी हर एंट्री में latitude, longitude, label और कुछ सपाट पते के फ़ील्ड होते हैं, न कि गहराई से नेस्टेड संरचना। यही सपाटपन अक्सर वह असली वजह होता है जिसके लिए किसी छोटी टीम ने इसे चुना था, क्योंकि पहली सफल कॉल से पहले सीखने को कम होता है।

जानबूझकर सरल रखे गए API से हटते समय माइग्रेशन को जटिलता वापस नहीं जोड़नी चाहिए, और पूरे रीराइट के बजाय कम्पैटिबिलिटी आधारित किसी भी तरीके की यही मूल शर्त है। शुरू करने से पहले पूछने लायक सवाल यह है कि क्या नए प्रोवाइडर का ड्रॉप-इन होस्ट सच में वह सपाटपन बनाए रखता है, या बस जटिलता को प्रक्रिया में कहीं और खिसका देता है।

My Geocode का PositionStack कम्पैटिबिलिटी होस्ट data ऐरे और उसकी सपाट फ़ील्ड संरचना को हूबहू दोहराता है, latitude, longitude और label नामों तक, और केवल कॉपीराइट, शर्तों और गोपनीयता का टेक्स्ट PositionStack के अपने रिस्पॉन्स से अलग होता है। संदर्भ /compatibility/positionstack/ पर है। इस API के लिए बने ज़्यादातर इंटीग्रेशन में data[0].latitude पढ़ने वाले कोड में होस्ट और कुंजी के अलावा कोई बदलाव नहीं चाहिए।

स्विच करने से पहले जाँचने लायक चीज़ों की एक छोटी सूची:

  • क्या आपका कोड PositionStack के अपने एरर रिस्पॉन्स से जुड़े किसी खास HTTP स्टेटस कोड पैटर्न की जाँच करता है, क्योंकि एरर के रूप अलग से /docs/errors/ पर दर्ज हैं और उनकी सीधी तुलना करनी चाहिए
  • क्या access_key पैरामीटर का नाम कहीं हार्डकोड है, क्योंकि नया होस्ट कुंजी को X-API-Key हेडर, Authorization: Bearer हेडर या HTTP Basic auth के रूप में भी स्वीकार करता है, अगर आप माइग्रेशन के दौरान query पैरामीटर से हटना चाहें
  • क्या कोई क्लाइंट-साइड कोड कुंजी को सीधे उजागर करता है, और अगर हाँ, तो उस कॉल को सर्वर-साइड प्रॉक्सी के पीछे ले जाने का यह अच्छा मौका है, चाहे दूसरी तरफ़ कोई भी प्रोवाइडर हो

यहाँ लागत की तुलना सच में सरल है, क्योंकि दोनों तरीके कम से कम झंझट को प्राथमिकता देते हैं। My Geocode प्रतिदिन 2,500 मुफ़्त अनुरोध देता है जिनके लिए किसी कुंजी की ज़रूरत ही नहीं, फिर हर कुंजी पर प्रतिदिन 2,500 और मुफ़्त जो नेटवर्क के हिसाब से गिने जाते हैं, और उसके बाद €0.0001 प्रति अनुरोध की दर से प्रीपेड क्रेडिट या €50 प्रति माह की Unlimited कुंजी। इस कम्पैटिबिलिटी होस्ट समेत हर एंडपॉइंट की कीमत एक जैसी है, इसलिए किसी बल्क या ज़्यादा वॉल्यूम वाले PositionStack वर्कलोड के यहाँ आने पर अलग हिसाब लगाने की ज़रूरत नहीं पड़ती।

जो छोटा प्रोजेक्ट साइड अकाउंट की क्षमता से आगे बढ़ गया है, उसके लिए इस तरह का माइग्रेशन आम तौर पर एक पूरा प्रोजेक्ट नहीं बल्कि टेस्टिंग की एक दोपहर होता है। एक स्टेजिंग बिल्ड को नए होस्ट की ओर करें, पतों के एक नमूने की तुलना करें, और अगर रूप मेल खाता है, तो स्विच खुद बस एक कॉन्फ़िगरेशन बदलाव है।