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

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

• validateAddress (REST)
• ValidateAddress (जीआरपीसी)

आपके अनुरोध में, 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 फ़ील्ड भेजते समय, आपको सिर्फ़ एक फ़ील्ड भरना होगा: addressLines. हालांकि, पते के सबसे आसान अनुरोध में ये सबफ़ील्ड होने चाहिए:

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

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

USPS CASSTM का विकल्प

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

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

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

इसे आज़माएं!

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

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

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

3. विकल्प के तौर पर, अनुरोध के मुख्य हिस्से में बदलाव करें.

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

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