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

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

ध्यान दें: यहां दिए गए उदाहरण सिर्फ़ जानकारी देने के लिए हैं. हालांकि, ऐसे और भी उदाहरण हो सकते हैं.

सामान्य उदाहरण: accept

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

डाला गया पता	क्षेत्र
76 बकिंघम पैलेस रोड, लंदन SW1W 9TQ	यूनाइटेड किंगडम

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

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

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

इसके अलावा, जवाब से यह जानकारी भी मिलती है:

• hasUnconfirmedComponents बचे हुए false
• hasInferredComponents बाकी है false
• hasReplacedComponents बचे हुए false

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

कार्रवाई: स्वीकार करें.

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

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

ध्यान दें: यहां दिए गए उदाहरणों के अलावा, और भी उदाहरण हो सकते हैं.

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

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

डाला गया पता	क्षेत्र
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italia	आईटी (सूचना प्रौद्योगिकी)

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

{
  "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 वाया कोंडाडो वे, पाम बीच गार्डन, फ़्लोरिडा 33418-1703	अमेरिका

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

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

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