माइग्रेशन

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

OpenCage ने जियोकोडिंग को आसान बनाकर अपने उपयोगकर्ता बनाए: एक अकेला कुंजी पैरामीटर, results ऐरे वाला JSON रिस्पॉन्स, और एक components ऑब्जेक्ट जो पते को road, city और country जैसे फ़ील्ड में बाँटता है। यह अपना मालिकाना डेटासेट चलाने के बजाय कई ओपन स्रोतों का डेटा मिलाता है, और यही एक वजह है कि जो डेवलपर इस बारे में पारदर्शिता को महत्व देते हैं कि उनका लोकेशन डेटा कहाँ से आता है, वे इसकी ओर खिंचते हैं।

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

My Geocode का OpenCage कम्पैटिबिलिटी होस्ट OpenCage द्वारा लौटाए जाने वाले results ऐरे और components के बँटवारे को दोहराता है, और केवल कॉपीराइट, शर्तों और गोपनीयता का टेक्स्ट बदलता है। फ़ील्ड स्तर का संदर्भ /compatibility/opencage/ पर है। ज़्यादातर इंटीग्रेशन के लिए इसका मतलब है अनुरोध का होस्ट और कुंजी का मान अपडेट करना, जबकि results[0].components.city या results[0].formatted पढ़ने वाला कोड जैसा लिखा है वैसे ही काम करता रहता है।

हमारी तरफ़ ऑथेंटिकेशन में X-API-Key हेडर, Authorization: Bearer हेडर, HTTP Basic auth या query पैरामीटर स्वीकार होता है, इसलिए जो क्लाइंट पहले से अपनी OpenCage कुंजी query string पैरामीटर के रूप में भेजता है, वह आम तौर पर नई कुंजी के मान के साथ काम करता रहेगा, और अनुरोध लॉजिक में कुछ और नहीं बदलेगा।

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

एक चीज़ जिसे मान लेने के बजाय सीधे टेस्ट करना चाहिए: annotations। अगर आपका OpenCage इंटीग्रेशन जियोकोडिंग रिस्पॉन्स में जुड़े अतिरिक्त annotation फ़ील्ड पढ़ता है, जैसे समय क्षेत्र या मुद्रा की जानकारी, तो कम्पैटिबिलिटी होस्ट के दर्ज फ़ील्ड की तुलना उससे करें जिसकी आपका पार्सिंग कोड अपेक्षा करता है, क्योंकि उस विवरण का कुछ हिस्सा जियोकोडिंग रिस्पॉन्स में शामिल होने के बजाय किसी समर्पित एंडपॉइंट से लेना पड़ सकता है, जैसे My Geocode का अपना समय क्षेत्र लुकअप

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