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

इस दस्तावेज़ में असल दुनिया की ऐसी कई स्थितियों के बारे में बताया गया है जिनमें 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 बताता है कि इस बात का संकेत देते हैं कि यह पता मान्य है. हालांकि, ज़्यादा भरोसे के साथ के स्तर पर, तो आप ग्राहक से पते की पुष्टि करने के लिए कह सकते हैं. यहां जाएं: लागू करने के लिए सलाह ज़्यादा जानकारी के लिए, पुष्टि करने वाला लॉजिक बनाएं सेक्शन पर जाएं.

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