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

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

आम तौर पर होने वाले उदाहरण: ठीक करना

इस सेक्शन में, आम तौर पर होने वाले उन उदाहरणों के बारे में बताया गया है जिनमें Address Validation API, जवाब के सिग्नल देता है. इन सिग्नल से पता चलता है कि पते की जानकारी की क्वालिटी कम है.

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

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

डाला गया पता क्षेत्र
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 नंबर वाली सड़क से मेल नहीं खाती. वहीं, संभव का मतलब है कि कॉम्पोनेंट का डेटा अब भी मान्य हो सकता है.

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

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

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

डाला गया पता क्षेत्र
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 है. इससे भी पता चलता है कि सब-प्रिमाइज़ मौजूद नहीं है.