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

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

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

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

• 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"]
  },
}

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

इसे आज़माएं!

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

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

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

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

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

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

USPS CASS™ विकल्प

United States Postal Service® (USPS®)¹, Coding Accuracy Support System (CASS™) को मैनेज करता है. इससे पते की पुष्टि करने वाली कंपनियों को मदद और सर्टिफ़िकेट मिलता है.

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

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

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

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

इसे आज़माएं!

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

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

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

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

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™. ↩