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

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

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

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

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

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

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

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

{
  "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 के तौर पर दिखाता है. हालांकि, इसमें डेटा से जुड़ी कुछ ज़रूरी जानकारी शामिल नहीं होती है. जैसे, इलाका और पिन कोड.

गली नंबर मौजूद नहीं है

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

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

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

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

"missingComponentTypes": [
        "street_number"
      ]

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

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

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

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

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

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

{
  "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 होता है. इसलिए, यह फ़ैसले की मैन्युअल जांच में मौजूद नहीं होता.

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

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

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

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

}

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

"missingComponentTypes": [
        "subpremise"
      ]

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