गाइड

जियोकोड करने से पहले बिखरे पता इनपुट को नॉर्मलाइज़ करें

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

भेजने से पहले क्या साफ़ करें

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

GET /v1/forward?q=221b   baker st,  london&limit=1

एंडपॉइंट इस तरह के ढीले फ़ॉर्मैट वाले इनपुट को भी आम तौर पर हल कर लेगा, क्योंकि वह किसी सख्त टेम्पलेट के बजाय असल दुनिया के पते के टेक्स्ट को संभालने के लिए बना है, लेकिन ज़्यादा साफ़ इनपुट स्ट्रिंग सच में अव्यवस्थित डेटा पर अस्पष्ट या कम confidence वाले मिलान की संभावना घटाती है।

दूसरा उदाहरण: संक्षिप्त रूपों को वैसा ही छोड़ना

आम संक्षिप्त रूपों वाली क्वेरी, जैसे "Street" के लिए "St" या "Avenue" के लिए "Ave", को भेजने से पहले पूरा लिखने की ज़रूरत नहीं है।

GET /v1/forward?q=500 5th Ave, New York&limit=1

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

नतीजों को सीमित करने के लिए countries पैरामीटर का इस्तेमाल

अगर आप पहले से जानते हैं कि कोई पता किस देश में होना चाहिए, जैसे रिकॉर्ड में दर्ज बिलिंग पते से या किसी साइट के क्षेत्रीय फ़ोकस से, तो उसे countries पैरामीटर के साथ भेजें, ताकि दुनिया में कहीं और मिलते-जुलते नाम वाली जगहों से अस्पष्ट मिलान कम हों।

GET /v1/forward?q=Springfield Main Street&countries=US&limit=3

एक गलती जिससे बचना चाहिए

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

बाद में confidence जाँचना

नॉर्मलाइज़ेशन गलत मिलान कम करता है, उन्हें पूरी तरह खत्म नहीं करता। यह मानने के बजाय कि अनुरोध सफल होने भर से लौटाया गया नतीजा अपने आप सही है, नतीजे पर हमेशा confidence फ़ील्ड जाँचें।

अनुरोध की लागत वही रहती है

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

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