माइग्रेशन

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

LocationIQ खुद को ओपन भौगोलिक डेटा और एक सरल कुंजी आधारित ऑथेंटिकेशन मॉडल के इर्द-गिर्द पेश करता है, जिसमें कुंजी query पैरामीटर के रूप में भेजी जाती है, और JSON रिस्पॉन्स में lat, lon, display_name और एक address ऑब्जेक्ट होता है, जो ऐसे फ़ील्ड में बँटा होता है जिनसे वे सभी परिचित हैं जिन्होंने OpenStreetMap से निकला डेटा सीधे इस्तेमाल किया है। यह परिचितता संयोग नहीं है; ओपन डेटा स्रोतों पर बने प्रोवाइडर आम तौर पर मिलते-जुलते फ़ील्ड नामों पर आ जाते हैं, जो जानने लायक है अगर आप एक साथ कई प्रोवाइडर की तुलना कर रहे हैं।

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

My Geocode का LocationIQ कम्पैटिबिलिटी होस्ट lat, lon, display_name और पते के घटक फ़ील्ड को हूबहू दोहराता है, और केवल कॉपीराइट, शर्तों और गोपनीयता की भाषा मूल से अलग होती है। संदर्भ विवरण /compatibility/locationiq/ पर हैं। response.display_name पढ़ने वाले या response.address फ़ील्ड पर इटरेट करने वाले एप्लिकेशन कोड में होस्ट नाम और कुंजी के अलावा कुछ बदलने की ज़रूरत नहीं होनी चाहिए।

इस खास बदलाव के लिए एक छोटी चेकलिस्ट:

  • पक्का करें कि आपकी क्लाइंट लाइब्रेरी आज कौन सा ऑथेंटिकेशन तरीका इस्तेमाल करती है (LocationIQ आम तौर पर query पैरामीटर स्वीकार करता है), और उसे यहाँ समर्थित चार तरीकों से मिलाएँ: X-API-Key हेडर, Authorization: Bearer, HTTP Basic auth, या query पैरामीटर
  • जाँचें कि क्या आपका इंटीग्रेशन रिवर्स जियोकोडिंग एंडपॉइंट को भी कॉल करता है, क्योंकि वहाँ अनुरोध का रूप फ़ॉरवर्ड जियोकोडिंग से अलग होता है और उसे अलग से टेस्ट करना चाहिए
  • रेट लिमिट संभालने वाले उस कोड की समीक्षा करें जो आपने खास तौर पर LocationIQ के रिस्पॉन्स हेडर के आसपास लिखा था, क्योंकि हेडर के नाम हर प्रोवाइडर में अलग होते हैं और आपका retry लॉजिक उन्हें नाम से संदर्भित कर सकता है

कीमत के मामले में तुलना काफ़ी सीधी है: प्रतिदिन 2,500 अनुरोधों के लिए किसी कुंजी की ज़रूरत ही नहीं, और हर कुंजी पर प्रतिदिन 2,500 और मुफ़्त अनुरोध, जो नेटवर्क के हिसाब से गिने जाते हैं, चाहे IPv4 (प्रति /24) हो या IPv6 (प्रति /48)। मुफ़्त कोटा के बाद €0.0001 प्रति अनुरोध की दर से प्रीपेड क्रेडिट या €50 प्रति माह की Unlimited कुंजी है, और हर एंडपॉइंट की कीमत एक जैसी है, जियोकोडिंग वॉल्यूम और दूसरे लुकअप के लिए कोई अलग स्तर नहीं है।

अगर आपका LocationIQ इस्तेमाल एक साइड प्रोजेक्ट से धीरे-धीरे बढ़कर ऐसी चीज़ बन गया है जिस पर लोग निर्भर हैं, तो कम्पैटिबिलिटी होस्ट खास तौर पर इसी तरह के माइग्रेशन को सबसे अच्छे अर्थ में उबाऊ बनाने के लिए है: होस्ट नाम बदलें, कुंजी बदलें और काम जारी रखें। जिस पार्सिंग कोड को पहली बार सही करने में समय लगा था, उसे सिर्फ़ इसलिए दोबारा देखने की ज़रूरत नहीं कि उसके पीछे का प्रोवाइडर बदल गया है। नेटवर्क के हिसाब से इस्तेमाल समेत कोटा की पूरी जानकारी /docs/rate-limits/ पर दर्ज मानक रिस्पॉन्स हेडर से मिलती है।