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

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

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

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

USPS CASS™ का विकल्प

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

सिर्फ़ अमेरिका और प्योर्तो रिको के लिए, अनुरोध के मुख्य हिस्से में 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. एपीआई एक्सप्लोरर पैनल में, एपीआई एक्सप्लोरर विंडो को बड़ा करने के लिए, बड़ा करें आइकॉन, चुनें.