पता ठीक करें - उदाहरण

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

ध्यान दें: यहां दिए गए उदाहरण सिर्फ़ जानकारी देने के लिए हैं. हालांकि, ऐसे और भी उदाहरण हो सकते हैं.

सामान्य उदाहरण: ठीक करें

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

शहर और पिन कोड मौजूद नहीं है

इस उदाहरण में, सिर्फ़ सड़क का पता दिया गया है. इसमें शहर या पिन कोड नहीं दिया गया है.

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

शहर और पिन कोड मौजूद न होने पर मिलने वाला फ़ैसला

नीचे दिए गए उदाहरण में, रिस्पॉन्स से मिले अहम सिग्नल पर ज़ोर दिया गया है.

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

इन सिग्नल से पता चलता है कि ईमेल पते पर ईमेल डिलीवर नहीं किया जा सकता. ज़्यादा जानने के लिए, addressComponents से संपर्क करें:

{
  "componentName": {
    "text": "21",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "45 40th street",
    "languageCode": "en"
  },
  "componentType": "route",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "United States",
    "languageCode": "en"
  },
  "componentType": "country",
  "confirmationLevel": "CONFIRMED"
}

Address Validation API, CONFIRMED के तौर पर सिर्फ़ देश (अमेरिका) की जानकारी दिखाता है. यह पते के सभी अन्य कॉम्पोनेंट को UNCONFIRMED_BUT_PLAUSIBLE के तौर पर दिखाता है. साथ ही, डेटा में कुछ अहम जानकारी को शामिल नहीं करता, जैसे कि इलाका और पिन कोड.

कार्रवाई: इस पते के लिए, सुझाई गई कार्रवाई यह है कि उपयोगकर्ता को उस जानकारी के लिए कहा जाए जो मौजूद नहीं है.

सड़क का नंबर मौजूद नहीं है

इस उदाहरण में, गली का नंबर नहीं दिया गया है.

डाला गया पता	क्षेत्र
Buckingham Palace Road, SW1W 9TQ London	यूनाइटेड किंगडम

सड़क का नंबर मौजूद न होने पर मिलने वाला फ़ैसला

{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

validationGranularity ROUTE है, जिससे पता चलता है कि यह सड़क से मेल खाती है, लेकिन प्रॉपर्टी तक पहुंचने के लिए ज़रूरत के मुताबिक जानकारी नहीं है. इसके अलावा, नतीजे में addressComplete प्रॉपर्टी मौजूद नहीं है. इसलिए, यह false है. address ऑब्जेक्ट की एक और क्वेरी से पता चलता है कि कॉम्पोनेंट टाइप मौजूद नहीं है:

"missingComponentTypes": [
        "street_number"
      ]

कार्रवाई: इस मामले में, सुझाई गई कार्रवाई यह है कि उपयोगकर्ता को, छूटी हुई जानकारी के लिए कहा जाए.

कभी-कभी होने वाले मामले के उदाहरण: ठीक करें

कुछ मामलों में, कारोबार की स्थिति के हिसाब से यह तय किया जाता है कि पते को ठीक करना है, उसकी पुष्टि करनी है या उसे स्वीकार करना है. यहां दिए गए उदाहरणों में ऐसी स्थितियां दिखाई गई हैं जो शायद किसी कैटगरी में पूरी तरह से फ़िट न हों.

सड़क का ऐसा नंबर जिसकी पुष्टि नहीं हुई है

इस स्थिति में, Address Validation API, सड़क के दिए गए नंबर की पुष्टि नहीं कर सकता. हालांकि, यह पता चलता है कि पता पूरा है.

डाला गया पता	क्षेत्र
84 Buckingham Palace Road, SW1W 9TQ, London	यूनाइटेड किंगडम

सड़क के पते की पुष्टि न होने पर मिलने वाला फ़ैसला

नीचे दिए गए उदाहरण में, अहम सिग्नल पर ज़ोर दिया गया है.

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

पुष्टि करने के तरीके के बारे में ज़्यादा जानकारी के साथ-साथ, पुष्टि नहीं किए गए कॉम्पोनेंट के आधार पर, प्राइमिस लेवल के अनुमान के लिए जांच करना ज़रूरी है. addressComponents प्रॉपर्टी की क्वेरी से, पुष्टि नहीं किए गए ये componentType दिखते हैं:

{
  "componentName": {
    "text": "84",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

यहां, street_number का confirmation_level, UNCONFIRMED_BUT_PLAUSIBLE पर सेट है. पुष्टि नहीं की गई का मतलब है कि सेवा, अपने डेटासेट में 84 वाली सड़क की संख्या से मेल नहीं खा सकती. वहीं, संभावित का मतलब है कि कॉम्पोनेंट का डेटा अब भी मान्य हो सकता है.

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

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

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

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

उदाहरण के लिए, मान लें कि कोई ग्राहक सैन फ़्रांसिस्को शहर के असेसोर के ऑफ़िस का मान्य पता डालता है, लेकिन इनपुट में कमरे का नंबर नहीं डालता.

डाला गया पता	क्षेत्र
1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102	यूएसए

सब-प्राइमिस मौजूद न होने पर फ़ैसला

इस उदाहरण में, नतीजे में addressComplete प्रॉपर्टी नहीं दिखती है. इसलिए, यह false है. इस वजह से, आपको पता चलता है कि कम से कम एक पता एलिमेंट अनचाहा है, हल नहीं हुआ है या मौजूद नहीं है.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true

}

address क्वेरी से ये चीज़ें पता चलती हैं:

"missingComponentTypes": [
        "subpremise"
      ]

ज़्यादा जानकारी के लिए, USPS के डेटा में dpvConfirmation कोड का D पता चलता है. इससे यह भी पता चलता है कि सब-प्राइमिस मौजूद नहीं है.

कार्रवाई: इस पते के लिए, सुझाई गई कार्रवाई यह है कि उपयोगकर्ता को उस जानकारी के लिए कहा जाए जो मौजूद नहीं है.