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

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

सलाह: Address Validation का डेमो खोलें और उदाहरण के तौर पर दिए गए पतों की पुष्टि करके देखें.

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

इस सेक्शन में, ऐसे सामान्य उदाहरणों के बारे में बताया गया है जिनमें 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 के तौर पर दिखाता है. साथ ही, डेटा में कुछ ज़रूरी जानकारी शामिल नहीं करता है. जैसे, इलाका और पिन कोड.

कार्रवाई: इस पते के लिए, सुझाई गई कार्रवाई यह है कि उपयोगकर्ता से छूटी हुई जानकारी देने के लिए कहा जाए.

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

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

पता डाला गया	क्षेत्र
बकिंघम पैलेस रोड, SW1W 9TQ लंदन	यूके

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

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

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

"missingComponentTypes": [
        "street_number"
      ]

कार्रवाई: इस मामले में, सुझाई गई कार्रवाई यह है कि उपयोगकर्ता से छूटी हुई जानकारी देने के लिए कहा जाए.

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

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

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

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

पता डाला गया	क्षेत्र
84 बकिंघम पैलेस रोड, SW1W 9TQ, लंदन	यूके

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

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

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

ध्यान दें: कुछ देशों में, Address Validation API, सबप्रीमाइज़ की जानकारी मौजूद न होने का पता नहीं लगा सकता. वहीं, अमेरिका में SUB_PREMISE मौजूद न होने का मतलब है कि पते पर डिलीवरी नहीं की जा सकती.

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

पता डाला गया	क्षेत्र
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

कार्रवाई: इस पते के लिए, सुझाई गई कार्रवाई यह है कि उपयोगकर्ता से छूटी हुई जानकारी देने के लिए कहा जाए.