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

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

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

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

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

डाला गया पता	क्षेत्र
76 Buckingham Palace Road, London 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 Via Condado Way, Palm Beach Gardens, FL 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 इस बात का संकेत देता है कि यह एक मान्य पता है. हालांकि, ज़्यादा कॉन्फ़िडेंस लेवल के लिए, ग्राहक से पते की पुष्टि करने के लिए कहा जा सकता है. ज़्यादा जानकारी के लिए, पुष्टि करने का लॉजिक बनाएं में लागू करने से जुड़े दिशा-निर्देश देखें.

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