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

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

• VerifyAddress (REST)
• ConfirmAddress (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=YOUR_API_KEY"

आपके पास locality को छोड़ने और इसे addressLines ऐरे में एलिमेंट के तौर पर बताने का विकल्प भी होता है:

{
  "address": {
    "regionCode": "US",
    "addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
  },
}

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

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

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

पते की पुष्टि करने वाले एपीआई को address फ़ील्ड भेजते समय, आपको सिर्फ़ एक फ़ील्ड की ज़रूरत होगी: addressLines. हालांकि, सबसे आसान पता अनुरोध में ये सबफ़ील्ड होने चाहिए:

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

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

USPS CASSTM का विकल्प

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

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

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

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

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

---

1. Google Maps Platform, संयुक्त राज्य अमेरिका का नॉन-इक्सक्लूसिव लाइसेंसी है Postal Service®. ये ट्रेडमार्क, यूनाइटेड स्टेट्स पोस्टल सर्विस® के पास हैं और इनका इस्तेमाल अनुमति के साथ किया जाता है: यूनाइटेड स्टेट्स पोस्टल सर्विस®, CASSTM, CASS CertifiedTM. ↩