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

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

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

इस सेक्शन में ऐसे सामान्य उदाहरण दिए गए हैं जहां Address Validation API, पते की कम क्वालिटी वाली जानकारी देने वाले रिस्पॉन्स सिग्नल देता है.

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

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

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

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

इस स्थिति में, ऐसे पते के बारे में बताया गया है जिसमें सिर्फ़ सब-प्रमिस की जानकारी मौजूद नहीं है. जैसे, अपार्टमेंट या डिपार्टमेंट नंबर. अगर ऐसा नहीं है, तो 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,
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

address की क्वेरी से यह जानकारी मिलती है:

"missingComponentTypes": [
        "subpremise"
      ]

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