पते की पुष्टि करने का तरीका चुनना

मकसद

पते की पुष्टि करने की सुविधा, कई तरह के इस्तेमाल के उदाहरणों के लिए काम की है. साथ ही, टेस्टिंग के नतीजों की रॉ क्वालिटी के अलावा, कुछ और अहम बातों पर भी ध्यान देने की ज़रूरत है. हमारा सुझाव है कि आप इन पर ध्यान दें. उदाहरण के लिए: उपयोगकर्ता फ़्लो में काम करने वाले प्रॉडक्ट का पूरा व्यू, जैसे कि जगह की जानकारी अपने-आप पूरी होने की सुविधा और Maps, क्षेत्र के हिसाब से उपलब्धता, और कारोबारी उपयोगकर्ताओं के लिए भरोसेमंद और काम का होना.

पते की पुष्टि करने वाले एपीआई का आकलन करने के बाद, हमारा सुझाव है कि आप टेस्टिंग के लिए यहां दिए गए कुछ दिशा-निर्देशों का इस्तेमाल करें.

इस टेस्ट के लक्ष्य ये होंगे:

1. पक्का करें कि पते की पुष्टि करने वाला एपीआई, आपके इस्तेमाल के उदाहरण के लिए सही है.
2. पुष्टि करें कि पते की पुष्टि करने वाला एपीआई, आपके समाधान की ज़रूरी शर्तों को कैसे पूरा करता है. जैसे:
   • अच्छी क्वालिटी के पतों की पहचान करना.
   • खराब क्वालिटी के इनपुट को ठीक करने के लिए सूचना देना.
   • पते के डेटा में सुधार करना. इसमें अनुमान लगाना, बदलाव करना, और वर्तनी में सुधार करना शामिल है.
   • शिपिंग के लिए फ़ॉर्मैट किया गया पता देना.
   • सब-प्राइमिस डेटा मौजूद न होने या गलत होने की चेतावनी (सिर्फ़ अमेरिका के लिए).
3. पक्का करें कि एपीआई को लागू करने से आपको मेज़र किया जा सकने वाला फ़ायदा मिलेगा.

जांच करने के बाद, आपके पास ऊपर दिए गए सवालों के जवाब देने का विकल्प होगा. साथ ही, यह तय किया जा सकेगा कि एपीआई आपके कारोबार के लिए सही है या नहीं.

अपना डेटा तैयार करें

आपका टेस्ट, आपके मौजूदा पते के डेटा के सैंपल के आधार पर किया जाना चाहिए. टेस्ट के लिए डेटा को खुद न चुनें. इसके बजाय, ऐसे रैंडम सैंपल चुनें जो उन इलाकों के बारे में बताते हों जहां आपका कारोबार चलता है. इसका मतलब है कि अगर आपका कारोबार अमेरिका और यूनाइटेड किंगडम, दोनों में है, लेकिन 70% कारोबार यूनाइटेड किंगडम में और 30% अमेरिका में किया जाता है, तो सैंपल में इस बंटवारे को दिखाया जाना चाहिए.

कैप्चर किए गए पतों का इस्तेमाल करें. उदाहरण के लिए, अगर आपको अपने ई-कॉमर्स चेकआउट में पते की पुष्टि करने की सुविधा लागू करनी है, तो फ़ॉर्म में खरीदारों के डाले गए पतों का इस्तेमाल करें. ऐसा, किसी भी मौजूदा प्रोसेसिंग से पहले करें, जिसे Address Validation API लागू करके बदला जा सकता है.

टेस्ट के लिए, 5,000 से 10,000 रिकॉर्ड का सैंपल तैयार करें.

एपीआई को कॉल करना

सेक्शन से जुड़ी ज़रूरी शर्त: पते की पुष्टि करने का अनुरोध भेजने का तरीका जानें.

डेटा तैयार करने के बाद, आपको एपीआई के साथ हर पते का रिकॉर्ड चलाना होगा.

एपीआई को कॉल करने के तरीके के बारे में जानने के लिए, Address Validation API का दस्तावेज़ देखें. हमारे पास एक लेख भी है, जिसमें बड़ी संख्या में पतों को प्रोसेस करने के लिए, पते की पुष्टि करने वाले एपीआई का इस्तेमाल करने के सबसे सही तरीके बताए गए हैं.

इस चरण के बाद, हर पते के रिकॉर्ड के लिए एपीआई से डेटा आउटपुट मिलना चाहिए. इसके बाद, नतीजों का विश्लेषण करके यह पता लगाया जा सकता है कि आपके इस्तेमाल के उदाहरण के लिए एपीआई सही है या नहीं. स्प्रेडशीट, डेटाबेस या किसी दूसरे टूल का इस्तेमाल करना, आपके ऊपर है.

नतीजों की समीक्षा करना

सेक्शन के लिए ज़रूरी शर्त: पुष्टि के जवाब को मैनेज करने का तरीका जानें. इसमें, खास तौर पर, ठीक करें, पुष्टि करें, और स्वीकार करें के कॉन्सेप्ट को समझना ज़रूरी है.

इस सेक्शन में, हम आउटपुट की उन स्थितियों के बारे में बात करेंगे जिनका विश्लेषण करके, यह पता लगाया जा सकता है कि समाधान सही है या नहीं.

इस दस्तावेज़ में बताए गए मुख्य एपीआई फ़ील्ड की खास जानकारी

रिस्पॉन्स डेटा	यह क्या है?	कैसे आकलन करें	यह सुविधा कैसे मददगार है?
verdict.inputGranularity	पते के इनपुट की बारीकी से जानकारी देता है.	SUB_PREMISE PREMISE PREMISE_PROXIMITY ब्लॉक करें ROUTE अन्य	इसकी मदद से यह पता लगाया जा सकता है कि इनपुट पते में ज़रूरत के मुताबिक डेटा है या नहीं.
verdict.validationGranularity	पते की पुष्टि के पूरे आउटपुट के बारे में बताता है.	SUB_PREMISE PREMISE PREMISE_PROXIMITY ब्लॉक करें ROUTE अन्य	इससे एपीआई के आउटपुट पर, पते की कुल क्वालिटी का पता लगाया जा सकता है.
verdict.hasInferredComponents	इससे पता चलता है कि एपीआई ने किसी कॉम्पोनेंट का अनुमान लगाया है या नहीं.	सही/गलत	एपीआई, डेटा का अनुमान लगाने के लिए, छूटे हुए कॉम्पोनेंट जोड़ सकता है. उदाहरण के लिए, राज्य का कोड मौजूद नहीं है.
verdict.hasReplacedComponents	इससे पता चलता है कि एपीआई ने किसी कॉम्पोनेंट की जगह कोई दूसरा कॉम्पोनेंट ले लिया है या नहीं.	सही/गलत	एपीआई, कुछ मामलों में गलत कॉम्पोनेंट को सही डेटा से बदल सकता है.
verdict.addressComplete	पता पूरा होने पर सिग्नल भेजता है.	सही/गलत	अगर एपीआई यह तय करता है कि आउटपुट पते में सभी ज़रूरी कॉम्पोनेंट मौजूद हैं, तो यह सही होगा.
address.missingComponentTypes	अगर पते में कॉम्पोनेंट मौजूद नहीं हैं, तो चेतावनी देने के लिए सिग्नल.	वैल्यू के लिए, दूसरी टेबल देखें.	अधूरे पते में मौजूद कॉम्पोनेंट को हाइलाइट करना.

मान्य पतों की समीक्षा करना

एपीआई से मिले डेटा को क्रम से लगाएं, ताकि यह पता लगाया जा सके कि आपका सिस्टम किन पतों को मान्य के तौर पर स्वीकार करेगा. एपीआई से मिलने वाले मुख्य सिग्नल ये हैं:

• verdict.validationGranularity में PREMISE या इससे बेहतर रेटिंग है.
• verdict.addressComplete true है.
• अनुमानित या बदले गए कॉम्पोनेंट नहीं हैं.

ज़्यादा जानकारी के लिए, पता स्वीकार करना लेख पढ़ें.

इस एक्सरसाइज़ का आउटपुट, पते के उस डेटा का सबसेट होना चाहिए जिसे आपके सिस्टम में मान्य माना जाएगा. इस समय, यह तय किया जा सकता है:

• क्या स्वीकार करने की दर, तय सीमा के अंदर है?
• अगर पते की पुष्टि करने के लिए किसी मौजूदा वर्कफ़्लो का इस्तेमाल किया जाता है, तो क्या पुष्टि होने की दर पहले जैसी है या बेहतर है?

उदाहरण: मान्य पता

पता डाला गया	क्षेत्र
76 Buckingham Palace Road, London SW1W 9TQ	यूके

फ़ैसला

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

अमान्य पतों की समीक्षा करना

इस चरण में, पते के उस डेटा की मैन्युअल तौर पर समीक्षा की जा सकती है जिसे अमान्य के तौर पर मार्क किया गया है. साथ ही, यह भी देखा जा सकता है कि पते की पुष्टि करने वाले एपीआई का इस्तेमाल किए बिना, उस अमान्य पते की वजह से, डाउनस्ट्रीम में समस्याएं आ सकती हैं या नहीं.

एपीआई से मिले डेटा को क्रम से लगाएं, ताकि पता चल सके कि आपका सिस्टम किन पतों को अमान्य के तौर पर मार्क करेगा. एपीआई से मिलने वाले मुख्य सिग्नल ये हैं:

• verdict.validationGranularity को खतरे के लेवल के हिसाब से OTHER या ROUTE पर सेट करें.
• verdict.addressComplete false है.

ज़्यादा जानकारी के लिए, पता ठीक करना लेख पढ़ें.

इस एक्सरसाइज़ का आउटपुट, पते के उस डेटा का सबसेट होना चाहिए जिसे आपके सिस्टम ने अमान्य के तौर पर मार्क किया है. इस समय, यह तय किया जा सकता है कि अमान्य प्रतिशत दर स्वीकार की जा सकती है या नहीं.

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

उदाहरण: अमान्य पता

पता डाला गया	क्षेत्र
21 45 40th street	यूएसए

फ़ैसला

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

छूटे हुए या पुष्टि नहीं किए गए कॉम्पोनेंट की समीक्षा करना

इस चरण में, मौजूद न होने वाले या जिनकी पुष्टि नहीं हुई है उन कॉम्पोनेंट की समीक्षा भी की जा सकती है. यह, सामान लौटाने के लिए दिए गए पते ऑब्जेक्ट का हिस्सा है. ये दो फ़ील्ड हैं missingComponentTypes और unconfirmedComponentTypes.

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

उदाहरण: ऐसा कॉम्पोनेंट जो मौजूद नहीं है और जिसकी पुष्टि नहीं की गई है

पता डाला गया	क्षेत्र
Fake St, New York, NY 10011	यूएसए

फ़ैसला

{
     "inputGranularity": "ROUTE",
     "validationGranularity": "OTHER",
     "geocodeGranularity": "OTHER",
     "hasUnconfirmedComponents": true
}

ऐसे कॉम्पोनेंट जो मौजूद नहीं हैं या जिनकी पुष्टि नहीं की गई है

"missingComponentTypes": [
    "street_number"
],
"unconfirmedComponentTypes": [
    "route"
]

सुधार किए गए पतों की समीक्षा करना

Address Validation API, इनपुट डेटा में सुधार कर सकता है. इसके लिए, वह संभावित रूप से अमान्य पते का इनपुट लेता है और मान्य पते का डेटा दिखाता है. एपीआई की वैल्यू बढ़ाने का यह एक तरीका है. इसलिए, इसे टेस्ट के हिस्से के तौर पर कैप्चर करना ज़रूरी है.

इन मुख्य सिग्नल पर ध्यान दें:

• inferred, replaced या spellCorrected को किसी भी addressComponents पर true पर सेट किया गया हो.
• verdict.hasInferredComponents या verdict.hasReplacedComponents को true पर सेट करें.

ज़्यादा जानकारी के लिए, पते की पुष्टि करना लेख पढ़ें.

इस एक्सरसाइज़ का आउटपुट, पते के उस डेटा का सबसेट होना चाहिए जिसमें एपीआई ने सुधार किया है.

इस डेटा के कुछ हिस्से की मैन्युअल तौर पर समीक्षा की जा सकती है. इससे यह पता चलता है कि एपीआई आपके डेटा में क्या बदलाव कर रहा है. इन बदलावों से, आपके डाउनस्ट्रीम वर्कफ़्लो में आने वाली समस्याओं को कम किया जा सकता है.

उदाहरण: सुधार किया गया पता

पता डाला गया	क्षेत्र
76 Bruckingm Palace Road, London SW1W 9TQ	यूके

रास्ता addressComponent

{
    "componentName": {
        "text": "Buckingham Palace Road",
        "languageCode": "en"
    },
    "componentType": "route",
    "confirmationLevel": "CONFIRMED",
    "spellCorrected": true
}

[सिर्फ़ अमेरिका के लिए] ऐसे पते की समीक्षा करना जिसमें सब-प्राइमिस का डेटा मौजूद न हो या गलत हो

पते की पुष्टि करने वाला एपीआई, यह पता लगा सकता है कि अमेरिका के पतों के लिए, कोई सब-प्राइमिस मौजूद है या नहीं या वह गलत है.

इन मुख्य सिग्नल पर ध्यान दें:

• पता ऑब्जेक्ट में:
  • unconfirmedComponentTypes में subpremise शामिल है
  • missingComponentTypes में subpremise शामिल है
• UspsData ऑब्जेक्ट में:
  • dpvConfirmation, D है (सब-प्राइमिस मौजूद नहीं है)
  • dpvConfirmation, S है (सब-प्राइमिस की पुष्टि नहीं की गई है)

ज़्यादा जानकारी के लिए, अमेरिका के पतों को मैनेज करना लेख पढ़ें.

इस जांच से पता चलेगा कि आपके डेटा में, सब-प्रॉपर्टी से जुड़ी कोई समस्या है या नहीं. जैसे, अपार्टमेंट नंबर की जानकारी मौजूद नहीं है या गलत है. इससे, डिलीवरी के इस्तेमाल के उदाहरणों में, डिवाइस के नीचे की ओर जाने वाली प्रोसेस में समस्याएं आ सकती हैं. पता की पुष्टि करने वाला एपीआई, इसकी पहचान पहले से करके आपके वर्कफ़्लो को बेहतर बना सकता है. इससे, आपको सही डेटा इकट्ठा करने के लिए ज़रूरी कदम उठाने में मदद मिलती है.

उदाहरण: सब-प्राइमिस मौजूद नहीं है

पता डाला गया	क्षेत्र
111 8th Avenue, Manhattan, NY 10011	अमेरिका

कॉम्पोनेंट मौजूद नहीं है

"missingComponentTypes": [
    "subpremise"
]

USPS डेटा की डीपीवी की पुष्टि

"dpvConfirmation": "D"

[सिर्फ़ अमेरिका के लिए] USPS standardizedAddress की समीक्षा करना

पते की पुष्टि करने वाला एपीआई, अमेरिका के पतों के लिए USPS का स्टैंडर्ड पता भी दिखाता है. यह खास तौर पर तब ज़रूरी है, जब आपको शिपिंग लेबल पर USPS फ़ॉर्मैट में पते प्रिंट करने हों.

इस डेटा को देखने के लिए, UspsAddress की समीक्षा की जा सकती है. साथ ही, यह भी तय किया जा सकता है कि यह आपके वर्कफ़्लो के लिए काम का है या नहीं.

उदाहरण: USPS का स्टैंडर्ड पता

"standardizedAddress": {
    "firstAddressLine": "111 8TH AVE FL 11",
    "cityStateZipAddressLine": "NEW YORK NY 10011-5201",
    "city": "NEW YORK",
    "state": "NY",
    "zipCode": "10011",
    "zipCodeExtension": "5201"
}

नतीजा

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

इसके बारे में और पढ़ने के लिए:

• Address Validation API के लिए डेवलपर दस्तावेज़
• ज़्यादा पतों को प्रोसेस करने के लिए, Address Validation API का इस्तेमाल करना
• ई-कॉमर्स चेकआउट के लिए पते की पुष्टि करना

योगदानकर्ता

हेनरिक वाल्व | DevX इंजीनियर