इस महीने हमने क्या लॉन्च किया: जियोकोडिंग, IP, समय क्षेत्र और बहुत कुछ
पूरे API में हाल के काम का सार: नए कम्पैटिबिलिटी होस्ट, तेज़ समय क्षेत्र और ऊँचाई लुकअप, डैशबोर्ड की सुविधाएँ, और कोटा की ज़्यादा साफ़ जानकारी।
LocationIQ ने ऐसे बहुत से स्टैक में जगह बनाई है जो छोटे से शुरू होकर बड़े हुए, अक्सर इसलिए कि शुरुआत में इसे अपनाना आसान था। हमारा कम्पैटिबिलिटी होस्ट ठीक इसी तरह के इंटीग्रेशन के लिए है: जो आज ठीक काम करता है, जिसे कभी स्थायी बनाने का इरादा नहीं था, और जिसे दोबारा लिखना कभी फ़ायदेमंद नहीं लगा।
यह होस्ट LocationIQ के अनुरोध पैरामीटर और रिस्पॉन्स बॉडी को हूबहू दोहराता है, सिवाय कॉपीराइट, शर्तों और प्राइवेसी वाले टेक्स्ट के, जो My Geocode का अपना है। LocationIQ के एंडपॉइंट के लिए बने अनुरोध बिना बदलाव के हमारे होस्ट पर भेजे जा सकते हैं, और लौटाया गया रिस्पॉन्स उसी तरह पार्स होता है जैसी मौजूदा कोड पहले से उम्मीद करता है।
यह सटीकता हर प्रोवाइडर पर लगाई गई मेहनत का संयोग नहीं है। हर कम्पैटिबिलिटी होस्ट उसी बिलिंग, कोटा और अकाउंट सिस्टम पर टिका है जो बाकी My Geocode को चलाता है, इसलिए नया होस्ट बनाना ज़्यादातर एक मैपिंग का काम है, यानी फ़ील्ड नामों और पैरामीटर संरचनाओं को उससे मिलाना जो किसी प्रोवाइडर के क्लाइंट पहले से भेजते हैं, न कि एक अलग बैकएंड खड़ा करना। यही वजह है कि कीमतें, ऑथेंटिकेशन और कोटा ट्रैकिंग सभी सत्रह होस्ट पर एक जैसे व्यवहार करते हैं, बजाय समय के साथ एक-दूसरे से अलग होते जाने के।
ऑथेंटिकेशन वही पैटर्न अपनाता है जो प्लेटफ़ॉर्म के हर होस्ट पर इस्तेमाल होता है। अपनी कुंजी X-API-Key हेडर, Authorization: Bearer हेडर, कुंजी को यूज़रनेम बनाकर HTTP Basic auth, या क्वेरी पैरामीटर के रूप में भेजें, जो भी आपका मौजूदा LocationIQ इंटीग्रेशन पहले से करता हो। चारों यहाँ बिना किसी अपवाद के स्वीकार किए जाते हैं, इसलिए स्विच करने का मतलब शायद ही कभी आपके HTTP क्लाइंट को छूना होता है।
कीमतें इस आधार पर नहीं बदलतीं कि कौन सा होस्ट या एंडपॉइंट कॉल संभालता है। किसी भी पते को बिना कुंजी के प्रतिदिन 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 इस होस्ट के रिस्पॉन्स के साथ ठीक वैसे ही जुड़े होते हैं जैसे हमारे नेटिव एंडपॉइंट के साथ, इसलिए इन हेडर के आसपास बनी कोई भी चीज़ बिना बदलाव के काम करती रहती है।
अगर किसी प्रोजेक्ट को कम्पैटिबल रिस्पॉन्स से ज़्यादा चाहिए, तो अनुरोध पर mg_extras=1 या X-MG-Extras हेडर ऊपर वैकल्पिक अतिरिक्त फ़ील्ड जोड़ देता है, पूरी तरह ऑप्ट-इन। जियोकोडिंग कॉल पर इसमें लौटाए गए कोऑर्डिनेट की ज़मीन की ऊँचाई शामिल हो सकती है, जो उसी स्रोत से ली जाती है जो सीधे /v1/elevation का जवाब देता है। इसे छोड़ दें, और रिस्पॉन्स फ़ॉर्मेट LocationIQ की संरचना से सटीक रूप से मेल खाता है, जिससे मौजूदा पार्सिंग लॉजिक के लिए कोई अचानक बदलाव नहीं होता।
जो अकाउंट स्विच करते हैं और पाते हैं कि यह असली ट्रैफ़िक में भी टिकता है, वे अक्सर अपनी टीम के उन लोगों को इसकी सलाह देते हैं जो अब भी मूल प्रोवाइडर को भुगतान कर रहे हैं। डैशबोर्ड में /dashboard/referrals पर रेफ़रल प्रोग्राम ठीक इसी तरह की ज़ुबानी सिफ़ारिश के लिए बना है।
होस्ट के दस्तावेज़ /compatibility/locationiq/ पर हैं, और प्रोवाइडर बदलने की सामान्य गाइड /docs/compatibility/ पर है। यह पक्का करने के लिए कि यह किसी मौजूदा इंटीग्रेशन में साफ़-सुथरे ढंग से फ़िट होता है, एक नई कुंजी के साथ एक टेस्ट कॉल आम तौर पर काफ़ी होती है।