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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{
  "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 है.

सड़क के ऐसे नंबर के लिए 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",
}

पुष्टि किए गए पते के लिए USPS का डेटा पूरा नहीं है

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

पुष्टि किए गए ऐसे पते के लिए फ़ैसला जिसमें 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"
}