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

इस दस्तावेज़ में, कई ऐसे उदाहरण दिए गए हैं जिनमें 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 अमेरिका

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

{
   "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",
}

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

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