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

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

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

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

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

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

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

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

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

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

possibleNextAction, शुरुआती जानकारी देता है कि हो सकता है कि इस पते पर डिलीवरी न की जा सके. हाइलाइट किए गए अन्य कॉम्पोनेंट भी इस सुविधा के साथ काम करते हैं. ज़्यादा जानने के लिए, 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",
    "possibleNextAction": "FIX"
}

possibleNextAction, यह शुरुआती जानकारी देता है कि हो सकता है कि इस पते पर डिलीवरी न की जा सके. इसके अलावा, 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,
  "possibleNextAction": "ACCEPT"
}

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

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

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

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

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

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

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

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

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

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true,
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

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

"missingComponentTypes": [
        "subpremise"
      ]

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