समाचार

Bing Maps REST Services के साथ ड्रॉप-इन कम्पैटिबिलिटी लाइव है

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

हमारा Bing Maps REST Services कम्पैटिबिलिटी होस्ट मूल सेवा के अनुरोध पैरामीटर और रिस्पॉन्स बॉडी की हूबहू नकल करता है, सिवाय कॉपीराइट, शर्तों और प्राइवेसी वाले टेक्स्ट के, जो मूल प्रोवाइडर के बजाय My Geocode का होता है। जो मौजूदा कोड Bing के फ़ॉर्मेट में अनुरोध बनाता है, Bing के फ़ॉर्मेट में रिस्पॉन्स पार्स करता है, या दोनों करता है, उसे बिना दोबारा लिखे हमारे होस्ट की ओर मोड़ा जा सकता है।

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

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

सिर्फ़ इसलिए कि रिस्पॉन्स संरचना किसी दूसरे प्रोवाइडर से मेल खाती है, कोटे की जानकारी गायब नहीं होती। हर कॉल अब भी X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining और हमारे मानक हेडर सेट के बाकी हेडर लौटाती है, ताकि आपको हमेशा ठीक-ठीक पता रहे कि कोई कुंजी या नेटवर्क कहाँ खड़ा है, जो मूल सेवा इस रूप में नहीं देती।

जिन टीमों को सख्ती से कम्पैटिबल रिस्पॉन्स से ज़्यादा चाहिए, उनके लिए अनुरोध पर mg_extras=1 या X-MG-Extras हेडर मानक संरचना को छेड़े बिना उसके ऊपर वैकल्पिक फ़ील्ड जोड़ देता है। यह फ़्लैग पूरी तरह बंद रखें तो रिस्पॉन्स संरचना में उससे बिल्कुल अलग नहीं होता जो मूल API लौटाता।

किसी मौजूदा इंटीग्रेशन को एंडपॉइंट दर एंडपॉइंट माइग्रेट करने की पूरी प्रक्रिया बताने वाली माइग्रेशन गाइड /docs/compatibility/ पर हैं, और होस्ट के दस्तावेज़ /compatibility/bing-maps/ पर हैं। इसे टेस्ट करने में कुछ खाली मिनटों और एक कुंजी के अलावा कुछ नहीं लगता।