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

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

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

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

पता डाला गया	क्षेत्र
76 Buckingham Palace Road, London SW1W 9TQ	यूके

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

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

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

इसके अलावा, जवाब में यह जानकारी भी दी गई है:

hasUnconfirmedComponents में से false देखा जाना बाकी है
hasInferredComponents में से false देखा जाना बाकी है
hasReplacedComponents में से false देखा जाना बाकी है
hasSpellCorrectedComponents में से false देखा जाना बाकी है

इन सभी सिग्नल को मिलाकर, पते की अच्छी क्वालिटी का पता चलता है.

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

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

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

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

पता डाला गया	क्षेत्र
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italia	IT

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

{
  "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 Carson Dr, Sunnyvale, CA 94086	अमेरिका

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

{
   "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 कोड, ग्राहक को पते की पुष्टि करने या उसे ठीक करने के लिए एक मज़बूत सिग्नल देता है. इस मामले में, आपके चुने गए व्यवहार का फ़ैसला आपके ज़रूरी कॉन्फ़िडेंस लेवल पर निर्भर करता है. ज़्यादा जानकारी के लिए, पुष्टि करने का लॉजिक तैयार करना में लागू करने के बारे में दिशा-निर्देश देखें.

पुष्टि किए गए पते के लिए USPS का डेटा अधूरा है

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

पता डाला गया	क्षेत्र
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703	अमेरिका

पुष्टि किए गए ऐसे पते के लिए फ़ैसला जिसमें USPS का डेटा अधूरा है

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

पुष्टि किए गए ऐसे पते के लिए USPS का डेटा जिसमें USPS का डेटा अधूरा है

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

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