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

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

आपके अनुरोध में, 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"]
  },
}

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

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

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

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

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

USPS CASSTM का विकल्प

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

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

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

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