माइग्रेशन

Google Maps Platform ऊँचाई इंटीग्रेशन से हटना

ऊँचाई लुकअप आम तौर पर एक चुपचाप रहने वाली निर्भरता होते हैं, जिन्हें किसी हाइकिंग ऐप के रूट प्रोफ़ाइल फ़ीचर, टेरेन से दूरी जाँचने वाले ड्रोन उड़ान प्लानर या भूमि सर्वेक्षण टूल से कॉल किया जाता है, और ये शायद ही कभी वह वजह होते हैं जिसके लिए Google Maps Platform अकाउंट बनाया गया था। इसलिए इसे किसी बड़े Google इंटीग्रेशन की बाकी चीज़ों से अलग ले जाना अच्छा विकल्प है, क्योंकि कॉल करने वाला कोड आम तौर पर एक या दो फ़ंक्शन में सिमटा होता है।

Google का Elevation API एक या ज़्यादा निर्देशांक जोड़ियाँ स्वीकार करता है और मीटर में एक elevation मान लौटाता है, साथ में एक resolution आँकड़ा जो मूल डेटा नमूने की सटीकता बताता है। यह एक छोटा रिस्पॉन्स है जिसमें पार्स करने को बहुत कम है, जिससे मूल डेटा स्रोत बदलने के बावजूद माइग्रेशन का दायरा काफ़ी छोटा रहता है।

My Geocode ऊँचाई को एक सीधे-सादे अनुरोध और रिस्पॉन्स रूप वाले पूरी तरह काम करने वाले एंडपॉइंट के रूप में चलाता है: एक निर्देशांक भेजें और मीटर में ज़मीन की ऊँचाई वापस पाएँ। क्योंकि यह उन लुकअप में से है जहाँ केवल रिस्पॉन्स के रूप का नहीं बल्कि असली जवाबों का सीधे वर्णन किया जा सकता है, इसलिए प्रोडक्शन ट्रैफ़िक स्विच करने से पहले इस माइग्रेशन को जाने-माने संदर्भ बिंदुओं पर टेस्ट करना, जैसे किसी खास पहाड़ की चोटी या समुद्र तल पर स्थित किसी तटीय जगह पर, भरोसा बनाने का एक उचित तरीका है। विवरण /docs/elevation-lookup/ पर है।

इस बदलाव के लिए खास तौर पर जाँचने लायक कुछ चीज़ें:

  • क्या आपका कोड दिखाने के अलावा किसी और काम के लिए Google के resolution फ़ील्ड पर निर्भर है, क्योंकि अलग-अलग ऊँचाई डेटा स्रोतों में resolution आँकड़ा नमूने की सटीकता को अलग तरह से बताता है, और किसी खास resolution मान पर निर्भर आगे के किसी भी लॉजिक की समीक्षा करनी चाहिए
  • क्या ऊँचाई लुकअप बैच में (एक कॉल में कई निर्देशांक) होते हैं या अलग-अलग, क्योंकि बैच अनुरोधों का रूप हर प्रोवाइडर में अलग होता है और उन्हें उन्हीं बैच आकारों पर टेस्ट करना चाहिए जो आपका एप्लिकेशन असल में इस्तेमाल करता है
  • क्या ऊँचाई को सीधे क्लाइंट-साइड कोड से कॉल किया जाता है, और अगर हाँ, तो लक्ष्य प्रोवाइडर चाहे कोई भी हो, कॉल को सर्वर-साइड ले जाने का यह उचित मौका है

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

ऊँचाई के अलावा वैकल्पिक अतिरिक्त डेटा, जैसे IP खतरे का विवरण और एप्लिकेशन के दूसरे हिस्सों के लिए उपयोगी नेटवर्क जानकारी, कम्पैटिबिलिटी होस्ट पर mg_extras=1 के ज़रिए उपलब्ध है, हालाँकि इस जैसे केवल ऊँचाई वाले माइग्रेशन के लिए अलग एंडपॉइंट आम तौर पर ज़्यादा सरल और सीधा विकल्प है। किसी बड़े जियोकोडिंग माइग्रेशन से पहले केवल ऊँचाई को ले जाना, तुरंत किसी बड़े प्रोजेक्ट के लिए प्रतिबद्ध हुए बिना एक अकेले अकाउंट पर निर्भरता घटाने की शुरुआत का कम जोखिम वाला तरीका है।