नीचे दिए गए किसी एक एंडपॉइंट पर पोस्ट अनुरोध जारी करके, पते की पुष्टि करने का अनुरोध भेजें:
- VerifyAddress (REST)
- ConfirmAddress (gRPC)
आपके अनुरोध में एक 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=YOUR_API_KEY"
आपके पास locality
को छोड़ने और इसे addressLines
ऐरे में एलिमेंट के तौर पर बताने का विकल्प भी होता है:
{
"address": {
"regionCode": "US",
"addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
},
}
पते के अनुरोध के फ़ील्ड
अनुरोध के मुख्य हिस्से में एक फ़ील्ड होता है:
address
—PostalAddress
टाइप का फ़ील्ड है, जिसमेंaddressLines
में कम से कम एक एंट्री होनी चाहिए.
पते की पुष्टि करने वाले एपीआई को address
फ़ील्ड भेजते समय, आपको सिर्फ़ एक फ़ील्ड की ज़रूरत होगी: addressLines
. हालांकि, सबसे आसान पता अनुरोध
में ये सबफ़ील्ड होने चाहिए:
regionCode
— सुझाया गया. यह एक वैकल्पिक फ़ील्ड है. हालांकि, अगर इसे मिटाया जाता है, तो Address Verified API, पते से इलाके का पता लगाता है. हालांकि, अगर आपको पता है, तो सबसे अच्छे नतीजों के लिएregionCode
शामिल करें. यह सुविधा किन इलाकों में उपलब्ध है, इसकी सूची देखने के लिए, इन देशों और इलाकों में मान्य है.addressLines
— ज़रूरी है. पते की निचली संरचना बताने वाली सूची.
रेफ़रंस गाइड में PostalAddress देखें. |
USPS CASSTM का विकल्प
यूनाइटेड स्टेट्स पोस्टल सर्विस® (USPS®) 1, पते की पुष्टि करने वाली कंपनियों की मदद करने और उन्हें सर्टिफ़िकेट देने के लिए, कोडिंग के सटीक होने की जानकारी देने वाले सिस्टम (CASSTM) को मैनेज करता है.
सिर्फ़ अमेरिका और प्योर्तो रिको (PR) क्षेत्रों के लिए, अनुरोध के मुख्य हिस्से में enableUspsCass
को true
पर सेट करके, CASS प्रोसेसिंग चालू की जा सकती है. CASS का इस्तेमाल करते समय अच्छे नतीजों के लिए ऐसा पता दें जिसमें शहर, राज्य, और पिन कोड के साथ सड़क और मोहल्ले का नंबर शामिल हो:
{
"address": {
"regionCode": "US",
"locality": "Mountain View",
"administrativeArea": "CA",
"postalCode": "94043",
"addressLines": ["1600 Amphitheatre Pkwy"]
},
"enableUspsCass": true
}
-
Google Maps Platform, संयुक्त राज्य अमेरिका का नॉन-इक्सक्लूसिव लाइसेंसी है Postal Service®. ये ट्रेडमार्क, यूनाइटेड स्टेट्स पोस्टल सर्विस® के पास हैं और इनका इस्तेमाल अनुमति के साथ किया जाता है: यूनाइटेड स्टेट्स पोस्टल सर्विस®, CASSTM, CASS CertifiedTM. ↩