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

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

• 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 — सुझाया गया. यह फ़ील्ड ज़रूरी नहीं है. हालांकि, अगर इसे शामिल नहीं किया जाता है, तो पता की पुष्टि करने वाला एपीआई, पते से क्षेत्र का अनुमान लगाता है. हालांकि, बेहतर नतीजों के लिए, अगर आपको regionCode पता है, तो उसे शामिल करें. जिन देशों/इलाकों में यह सुविधा उपलब्ध है उनकी सूची देखने के लिए, यह सुविधा किन देशों/इलाकों में उपलब्ध है लेख पढ़ें.
• addressLines — ज़रूरी है. पते के छोटे स्ट्रक्चर की जानकारी देने वाले पतों का कलेक्शन.

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

USPS CASS™ का विकल्प

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

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

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

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

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

इसे आज़माएं!

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

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

2. इसके अलावा, स्टैंडर्ड पैरामीटर दिखाएं को बड़ा करें और fields पैरामीटर को फ़ील्ड मास्क पर सेट करें.

3. अनुरोध के मुख्य हिस्से में बदलाव करें. हालांकि, ऐसा करना ज़रूरी नहीं है.

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

5. एपीआई एक्सप्लोरर पैनल में, एपीआई एक्सप्लोरर विंडो को बड़ा करने के लिए, बड़ा करें आइकॉन, चुनें.

---

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