माइग्रेशन

HERE autosuggest इंटीग्रेशन से हटना

HERE का autosuggest एंडपॉइंट उपयोगकर्ता के टाइप करते समय पते और जगहों के सुझाव लौटाता है, जो एक items ऐरे के रूप में होते हैं, जिसकी हर एंट्री में एक title, एक resultType जो बताता है कि सुझाव पूरा पता है, कोई जगह है या कोई श्रेणी, और अक्सर एक highlighting ऑब्जेक्ट होता है जो बताता है कि कौन से अक्षर इनपुट से मेल खाए। नतीजों के प्रकारों का यह मेल, यानी एक ही रिस्पॉन्स में पते, जगहें और श्रेणियाँ एक साथ, HERE के तरीके के ज़्यादा विशिष्ट हिस्सों में से एक है, और यह मानने से पहले कि किसी दूसरे प्रोवाइडर का ऑटोकम्प्लीट बिल्कुल वैसे ही काम करता है, इसे ध्यान से समझ लेना चाहिए।

Autosuggest इंटीग्रेशन आम तौर पर किसी खास फ़्रंट-एंड कंपोनेंट से गहराई से जुड़े होते हैं, जैसे ड्रॉपडाउन वाला पते का फ़ील्ड, और इंटरैक्शन के विवरण (सुझाव कितनी जल्दी दिखते हैं, highlighting कैसे दिखाई जाती है, जब उपयोगकर्ता सुझावों को अनदेखा करके टाइप करता रहता है तो क्या होता है) अंतिम उपयोगकर्ताओं के लिए किसी भी बैकएंड इम्प्लीमेंटेशन विवरण से ज़्यादा मायने रखते हैं। इससे माइग्रेशन कुछ हद तक बैकएंड का काम और कुछ हद तक UX की समीक्षा बन जाता है।

My Geocode पता ऑटोकम्प्लीट देता है, जैसा /docs/address-autocomplete/ पर दर्ज है, जिसका अपना अनुरोध और रिस्पॉन्स रूप है। क्योंकि नतीजों को मिलाने और रैंकिंग का व्यवहार सच में हर प्रोवाइडर के इम्प्लीमेंटेशन के लिए खास होता है, इसलिए यह मान लेने के बजाय कि HERE की मिले-जुले प्रकारों वाली नतीजा संरचना बिना बदलाव के आगे आएगी, इस एंडपॉइंट को अपने उपयोगकर्ताओं की प्रतिनिधि क्वेरी पर सीधे टेस्ट करना चाहिए। अलग-अलग प्रोवाइडर इस बात की अलग रेखा खींचते हैं कि क्या पता सुझाव गिना जाए और क्या जगह।

इस तरह के माइग्रेशन के लिए आम तौर पर अच्छी तरह काम करने वाले चरण:

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

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

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