इस दस्तावेज़ में, असल दुनिया के कई ऐसे उदाहरणों के बारे में बताया गया है जहां पते की पुष्टि करने वाला एपीआई, जवाब के ऐसे सिग्नल देता है जिनसे आपके सिस्टम को स्वीकार करें वाला व्यवहार करने की अनुमति मिलती है. संदर्भ के लिए, पुष्टि के रिस्पॉन्स का इस्तेमाल करें में वर्कफ़्लो की खास जानकारी देखें.
सामान्य उदाहरण: accept
इस उदाहरण में, एक ऐसा पता दिखाया गया है जिसमें आपका सिस्टम, खरीदार के डाले गए पते को स्वीकार करेगा.
डाला गया पता | क्षेत्र |
---|---|
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 | अमेरिका |
पुष्टि किए गए ऐसे पते के लिए फ़ैसला जिसका यूएसपीएस डेटा अधूरा है
{
"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"
}