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

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

• validateAddress (REST)
• ValidateAddress (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 — ज़रूरी है. यह एक ऐसा कलेक्शन होता है जिसमें पते के बारे में जानकारी होती है.

USPS CASS™ विकल्प

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

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

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

इसे आज़माएं!

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

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

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

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

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