पता स्वीकार करें - उदाहरण

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

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

सामान्य उदाहरण: स्वीकार करें

यह उदाहरण एक ऐसा पता दिखाता है जिसमें आपका सिस्टम, ग्राहक के डाले गए पते को स्वीकार करता है.

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

स्वीकार किए जाने वाले पते के बारे में फ़ैसला

नीचे दिए गए उदाहरण में अहम सिग्नल को हाइलाइट किया गया है.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

इसके अलावा, जवाब में नीचे दी गई जानकारी भी शामिल होती है:

• hasUnconfirmedComponents बाकी है false
• hasInferredComponents बाकी है false
• hasReplacedComponents बाकी है false

एक साथ जोड़ने पर, ये सिग्नल एक अच्छी क्वालिटी वाले पते का संकेत देते हैं.

कार्रवाई: स्वीकार करें.

एज केस के उदाहरण: स्वीकार करें

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

ध्यान दें: इन उदाहरणों के अलावा, और भी उदाहरण हो सकते हैं, लेकिन ये सभी उदाहरण हैं.

अमेरिका के बाहर के मोहल्ले का नंबर

इस उदाहरण में एक ऐसे इटैलियन पते की जानकारी दी गई है जिसमें पते के सभी कॉम्पोनेंट मौजूद हैं. साथ ही, इसमें कोई अनुमानित या बदला गया कॉम्पोनेंट नहीं दिखाया गया है. हालांकि, validationGranularity, ROUTE है.

पता डाला गया	इलाका
वाया फ़ॉन्ते ग्रग्नले, 14 यूनिट 2, 66054 वास्तो सीएच, इटालिया	इटली

बिना पुष्टि वाली सड़क के नंबर के लिए नतीजा

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "ROUTE",
  "geocodeGranularity": "ROUTE",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
}

पते के कॉम्पोनेंट की आगे की जांच से पता चला है कि सड़क का नंबर UNCONFIRMED_BUT_PLAUSIBLE है.

{
   "text": "14",
   "componentType": "street_number",
   "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

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

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

इस उदाहरण में, अमेरिका के एक ऐसे पते की जानकारी दी गई है जिसमें पते के सभी कॉम्पोनेंट मौजूद हैं. इनमें, कोई अनुमानित या बदला गया कॉम्पोनेंट शामिल नहीं है. हालांकि, validationGranularity, PREMISE_PROXIMITY है.

पता डाला गया	इलाका
975 कार्सन डॉ॰ सनीवेल, कैलिफ़ोर्निया 94086	अमेरिका

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

{
   "firstAddressLine": "975 CARSON DR",
   "cityStateZipAddressLine": "SUNNYVALE CA 94086",
   "city": "SUNNYVALE",
   "state": "CA",
   "zipCode": "94086"
   "dpvConfirmation": "N",
   "dpvFootnote": "AAM3",
   "carrierRoute": "C031",
   "carrierRouteIndicator": "D",
   "postOfficeCity": "SUNNYVALE",
   "postOfficeState": "CA",
   "fipsCountyCode": "085",
   "county": "SANTA CLARA",
}

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

पुष्टि किए गए पते के लिए यूएसपीएस का अधूरा डेटा

इस उदाहरण में एक अमेरिका के पते की जानकारी दी गई है, जिसमें पते के सभी कॉम्पोनेंट की पुष्टि की गई है. साथ ही, इसमें कोई अनुमानित या बदला गया कॉम्पोनेंट नहीं है और PREMISE का validationGranularity है. हालांकि, uspsData पूरी तरह से नहीं भरा होता है और इसमें dpvConfirmation की वैल्यू नहीं होती है.

पता डाला गया	इलाका
155 वाया कोंडाडो वे, पाम बीच गार्डन, फ़्लोरिडा 33418-1703	अमेरिका

अधूरे यूएसपीएस डेटा के साथ पुष्टि किए गए पते के लिए नतीजा

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true,
}

पुष्टि किए गए पते के लिए यूएसपीएस का डेटा, जिसमें अधूरा यूएसपीएस डेटा भी शामिल है

{
  "standardizedAddress": {
    "firstAddressLine": "155 VIA CONDADO WAY",
    "cityStateZipAddressLine": "PALM BEACH GARDENS",
    "city": "PALM BEACH GARDENS",
    "state": "FL",
    "zipCode": "33418"
  },
  "carrierRoute": "H018",
  "postOfficeCity": "PALM BEACH GARDENS",
  "postOfficeState": "FL"
}

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

ध्यान दें: सेवा को समय-समय पर, यूएसपीएस का अपडेट किया गया डेटा मिलता है. इसलिए, हो सकता है कि इस उदाहरण में अब अधूरा यूएसपीएस डेटा न दिखे. यह उदाहरण, इस पते के लिए एपीआई से मिले रिस्पॉन्स को सटीक तरीके से दिखाने के बजाय, उदाहरण के तौर पर दिखाया गया है.