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

इस दस्तावेज़ में, असल दुनिया की ऐसी कई स्थितियों के बारे में बताया गया है जहां 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	अमेरिका

बिना पुष्टि वाले स्ट्रीट नंबर के लिए यूएसपीएस डेटा

{
   "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 Via Condado Way, Palm Beach Gardens, FL 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"
}

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

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