नीचे दिए गए एंडपॉइंट में से किसी एक पर पोस्ट अनुरोध जारी करके, पते की पुष्टि करने का अनुरोध भेजें:
- validateAddress (REST)
- ValidateAddress (जीआरपीसी)
आपके अनुरोध में, JSON अनुरोध का मुख्य हिस्सा भी पास होना चाहिए जिससे पुष्टि करने के लिए पता तय किया जाता है. नीचे दिए गए अनुरोध के मुख्य हिस्से में एक फ़ील्ड और तीन सबफ़ील्ड होते हैं:
curl -X POST -d '{ "address": { "regionCode": "US", "locality": "Mountain View", "addressLines": ["1600 Amphitheatre Pkwy"] } }' \ -H 'Content-Type: application/json' \ "https://addressvalidation.googleapis.com/v1:validateAddress?key=API_KEY"
locality
को छोड़ा भी जा सकता है और इसे addressLines
कैटगरी में एलिमेंट के तौर पर बताया जा सकता है:
{
"address": {
"regionCode": "US",
"addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
},
}
पते के अनुरोध के फ़ील्ड
अनुरोध के मुख्य हिस्से में एक फ़ील्ड होता है:
address
—PostalAddress
टाइप का ऐसा फ़ील्ड जिसमेंaddressLines
में कम से कम एक एंट्री होनी चाहिए.
पते की पुष्टि करने वाले एपीआई को address
फ़ील्ड भेजते समय, आपको सिर्फ़ एक फ़ील्ड भरना होगा: addressLines
. हालांकि, पते के सबसे आसान अनुरोध में ये सबफ़ील्ड होने चाहिए:
regionCode
— सुझाया गया. यह एक वैकल्पिक फ़ील्ड है, लेकिन अगर इसे छोड़ा जाता है, तो Address Validation API, पते से क्षेत्र का पता लगाता है. हालांकि, सबसे अच्छे नतीजों के लिए, अगर आपकोregionCode
पता है, तो उसे शामिल करें. जिन इलाकों में यह सुविधा उपलब्ध है उनकी सूची देखने के लिए, इन देशों और इलाकों में मान्य है देखें.addressLines
— ज़रूरी है. पतों का कलेक्शन, जो पते के निचले स्ट्रक्चर के बारे में बताता है.
रेफ़रंस गाइड में PostalAddress देखें. |
USPS CASSTM का विकल्प
यूनाइटेड स्टेट्स पोस्टल सर्विस® (USPS®)1, पते की पुष्टि करने वाली कंपनियों की मदद करने और उन्हें सर्टिफ़िकेट देने के लिए कोडिंग ऐक्यूरसी सपोर्ट सिस्टम (सीएएसएसटीएम) का इस्तेमाल करती है.
सिर्फ़ अमेरिका और पीआर के क्षेत्रों के लिए, अनुरोध के मुख्य हिस्से में enableUspsCass
को true
पर सेट करके, सीएएसएस प्रोसेस को चालू किया जा सकता है. CASS का इस्तेमाल करते समय सबसे अच्छे नतीजे पाने के लिए, शहर, राज्य, और पिन कोड के साथ-साथ मोहल्ले और सड़क का नंबर शामिल करने वाला पता दें:
{
"address": {
"regionCode": "US",
"locality": "Mountain View",
"administrativeArea": "CA",
"postalCode": "94043",
"addressLines": ["1600 Amphitheatre Pkwy"]
},
"enableUspsCass": true
}
इसे आज़माएं!
एपीआई एक्सप्लोरर से आपको सैंपल के तौर पर अनुरोध करने की सुविधा मिलती है. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है.
पेज के दाईं ओर मौजूद, एपीआई आइकॉन को चुनें.
विकल्प के तौर पर, स्टैंडर्ड पैरामीटर दिखाएं को बड़ा करें और
fields
पैरामीटर को फ़ील्ड मास्क पर सेट करें.विकल्प के तौर पर, अनुरोध के मुख्य हिस्से में बदलाव करें.
लागू करें बटन चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके अनुरोध करना है.
एपीआई एक्सप्लोरर पैनल में, एपीआई एक्सप्लोरर की विंडो को बड़ा करने के लिए, 'बड़ा करें' आइकॉन को चुनें.
-
Google Maps Platform संयुक्त राज्य अमेरिका की डाक सेवा का लाइसेंस रखने वाला(लाइसेंस रखने वाला) नहीं है. नीचे दिए गए ट्रेडमार्क का मालिकाना हक संयुक्त राज्य अमेरिका पोस्टल सर्विस® के पास है और इनका इस्तेमाल अनुमति के साथ किया जाता है: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩