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

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

ध्यान दें: यहां दिए गए उदाहरण सिर्फ़ उदाहरण के तौर पर दिए गए हैं, लेकिन इसी तरह के और भी उदाहरण हो सकते हैं.

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

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

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

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

पता डाला गया	इलाका
21 45 40वीं सड़क	यूएसए

शहर और पिन कोड की जानकारी न होने पर नतीजा

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

{
  "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"
}

पते की पुष्टि करने वाला एपीआई, सिर्फ़ देश (अमेरिका) को CONFIRMED के तौर पर दिखाता है. यह पते के दूसरे सभी कॉम्पोनेंट को UNCONFIRMED_BUT_PLAUSIBLE के रूप में दिखाता है, लेकिन डेटा में कुछ ज़रूरी चीज़ें छूट जाती हैं, जैसे कि शहर और पिन कोड.

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

सड़क का नंबर मौजूद नहीं है

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

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

सड़क संख्या अनुपलब्ध होने पर निर्णय

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

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

"missingComponentTypes": [
        "street_number"
      ]

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

एज-केस के उदाहरण: ठीक करना

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

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

इस स्थिति में, पते की पुष्टि करने वाला एपीआई, दिए गए स्ट्रीट नंबर की पुष्टि नहीं कर सकता, फिर भी यह बताता है कि पता पूरा हो गया है.

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

कार्रवाई: आपने जो इनपुट डाला है उसे ठीक वैसे ही स्वीकार किया जा सकता है या ग्राहक से इसकी पुष्टि की जा सकती है, ताकि यह पता लगाया जा सके कि मोहल्ले का नंबर सही है या गड़बड़ी है. आपका जवाब, डिलीवरी से जुड़े जोखिम के लेवल पर निर्भर करता है. पुष्टि करने वाला लॉजिक बनाएं सेक्शन में, लागू करने के लिए सलाह देखें.

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

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

ध्यान दें: कुछ देशों में, पते की पुष्टि करने वाला एपीआई किसी ऐसे सब-प्रिंस का पता नहीं लगा सकता जो मौजूद नहीं है. वहीं, अमेरिका में, SUB_PREMISE के मौजूद न होने का मतलब है कि डिलीवर नहीं किया जा सकता.

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

पता डाला गया	इलाका
1 डॉक्टर कार्लटन बी गुडलेट प्लेस, सैन फ़्रांसिस्को, कैलिफ़ोर्निया 94102	यूएसए

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

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

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

}

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

"missingComponentTypes": [
        "subpremise"
      ]

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

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