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

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

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

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

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

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

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

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

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

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

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

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

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

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

"missingComponentTypes": [
        "street_number"
      ]

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

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

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

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

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

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

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

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

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

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

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

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

"missingComponentTypes": [
        "subpremise"
      ]

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