पते की पुष्टि करने के लिए अनुरोध भेजें

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

अगर आपका बिलिंग पता यूरोपियन इकनॉमिक एरिया में है, तो 8 जुलाई, 2025 से, सेवाओं के आपके इस्तेमाल पर Google Maps Platform की ईईए से जुड़ी सेवा की शर्तें लागू होंगी. यह सुविधा, देश/इलाके के हिसाब से अलग-अलग हो सकती है. ज़्यादा जानें.

नीचे दिए गए किसी एक एंडपॉइंट पर POST अनुरोध भेजकर, पते की पुष्टि करने का अनुरोध भेजें:

• validateAddress (REST)
• ValidateAddress (gRPC)

ध्यान दें: इस दस्तावेज़ में दिए गए उदाहरणों में REST का इस्तेमाल किया गया है. हालांकि, 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=API_KEY"

locality को हटाया भी जा सकता है. इसके बजाय, इसे addressLines ऐरे में एलिमेंट के तौर पर सेट किया जा सकता है:

{
  "address": {
    "regionCode": "US",
    "addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
  },
}

एपीआई एक्सप्लोरर की मदद से, लाइव अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है:

इसे आज़माएं!

पते के अनुरोध वाले फ़ील्ड

अनुरोध के मुख्य हिस्से में एक फ़ील्ड होता है:

• address — यह PostalAddress टाइप का फ़ील्ड होता है. इसमें addressLines में कम से कम एक एंट्री होनी चाहिए.

Address Validation API को address फ़ील्ड भेजते समय, आपको सिर्फ़ एक फ़ील्ड देना होगा: addressLines. हालांकि, पते के लिए किए गए सबसे आसान अनुरोध में ये सब-फ़ील्ड शामिल होने चाहिए:

• regionCode — सुझाई गई वैल्यू. यह फ़ील्ड भरना ज़रूरी नहीं है. हालांकि, इसे न भरने पर Address Validation API, पते से क्षेत्र का पता लगाता है. हालांकि, सबसे अच्छे नतीजों के लिए, अगर आपको regionCode पता है, तो उसे शामिल करें. जिन देशों/इलाकों में यह सुविधा उपलब्ध है उनकी सूची देखने के लिए, उन देशों/इलाकों की सूची देखें.
• addressLines — ज़रूरी है. यह एक ऐसा कलेक्शन होता है जिसमें पते के बारे में जानकारी होती है.

रेफ़रंस गाइड में PostalAddress देखें.

USPS CASS™ विकल्प

यूनाइटेड स्टेट पोस्टल सर्विस® (यूएसपीएस®)¹, पते की पुष्टि करने वाली कंपनियों की मदद करने और उन्हें सर्टिफ़िकेट देने के लिए, कोडिंग ऐक्युरसी सपोर्ट सिस्टम (सीएएसएस™) का इस्तेमाल करता है.

ध्यान दें: Address Validation API को CASS-Certified™ सेवा के तौर पर पुष्टि की गई है. इसका मतलब है कि यह सेवा, पते की छूटी हुई जानकारी को भरने, उसे स्टैंडर्ड बनाने, और उसे सबसे नए और सटीक पते के हिसाब से अपडेट करने की पुष्टि करती है.

सिर्फ़ अमेरिका और प्यूर्टो रिको के लिए, अनुरोध के मुख्य हिस्से में enableUspsCass को true पर सेट करके, CASS प्रोसेसिंग चालू की जा सकती है. CASS का इस्तेमाल करते समय सबसे अच्छे नतीजे पाने के लिए, ऐसा पता दें जिसमें सड़क और सड़क का नंबर, शहर, राज्य, और पिन कोड शामिल हो:

{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "administrativeArea": "CA",
    "postalCode": "94043",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  },
  "enableUspsCass": true
}

ध्यान दें: अगर आपको CASS प्रोसेसिंग की ज़रूरत नहीं है या आपको अमेरिका और प्योर्टो रिको के बाहर के पते की पुष्टि करनी है, तो Google इस सुविधा को चालू करने का सुझाव नहीं देता.

इसे आज़माएं!

APIs Explorer की मदद से, सैंपल अनुरोध किए जा सकते हैं. इससे आपको एपीआई और एपीआई के विकल्पों के बारे में जानकारी मिलती है.

1. पेज की दाईं ओर मौजूद, एपीआई आइकॉन api चुनें.

2. अनुरोध के पैरामीटर में बदलाव करें. यह ज़रूरी नहीं है.

3. लागू करें बटन को चुनें. डायलॉग बॉक्स में, वह खाता चुनें जिसका इस्तेमाल करके आपको अनुरोध करना है.

4. APIs Explorer पैनल में, फ़ुलस्क्रीन आइकॉन fullscreen को चुनें, ताकि APIs Explorer विंडो को बड़ा किया जा सके.

---

1. Google Maps Platform, United States Postal Service® का नॉन-एक्सक्लूसिव लाइसेंसधारी है. यहां दिए गए ट्रेडमार्क, United States Postal Service® के मालिकाना हक में हैं और इनका इस्तेमाल अनुमति लेकर किया जाता है: United States Postal Service®, CASS™, CASS Certified™. ↩