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

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

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

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

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

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

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

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

इसके अलावा, verdict से यह भी पता चलता है:

  • hasUnconfirmedComponents में से false देखा जाना बाकी है
  • hasInferredComponents में से false देखा जाना बाकी है
  • hasReplacedComponents में से 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",
}

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

इस उदाहरण में, अमेरिका के एक ऐसे पते की एंट्री दिखाई गई है जिसके सभी कॉम्पोनेंट की पुष्टि हो चुकी है. इसमें कोई भी कॉम्पोनेंट अनुमानित या बदला नहीं गया है. साथ ही, इसमें PREMISE का validationGranularity है. हालांकि, 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"
}