पते की पुष्टि करने वाले एपीआई की खास जानकारी

पते की पुष्टि करने के बारे में खास जानकारी

पता पुष्टि एपीआई एक ऐसी सेवा है जो पते की जानकारी स्वीकार करती है. यह पते के कॉम्पोनेंट की पहचान करता है और उनकी पुष्टि करता है. यह डाक के लिए पते को मानक बनाता है और इसके लिए सबसे अच्छे अक्षांश/देशांतर निर्देशांक ढूंढता है. विकल्प के तौर पर, अमेरिका और प्योर्तो रिको के पतों के लिए, कोडिंग एक्युरसी सपोर्ट सिस्टम (CASSTM) चालू किया जा सकता है.

पते की पुष्टि करने वाले एपीआई का इस्तेमाल क्यों करना चाहिए

पते की पुष्टि करने वाले एपीआई की मदद से, डिलीवरी में लगने वाले समय को कम किया जा सकता है. साथ ही, डिलीवरी में लगने वाली दिक्कतों को कम किया जा सकता है. इससे, खरीदारों को बेहतर अनुभव मिलता है. ऐसा करने के लिए, आप खराब पतों पर रहते हैं और पते की विशेषताओं के बारे में बेहतर जानकारी पाते हैं.

अगर आपको अपने अनुरोध के लिए अलग-अलग पते के कॉम्पोनेंट की पुष्टि करने की ज़रूरत नहीं है, तो आपकी ज़रूरतों के लिए जियोकोडिंग एपीआई बेहतर मिलान हो सकता है. जियोकोडिंग एपीआई, पतों को अक्षांश/देशांतर निर्देशांकों में बदल देता है, और पते की पुष्टि करने वाले एपीआई, पतों के सही होने की पुष्टि करते हैं. ज़्यादा जानकारी के लिए, नीचे दिए गए पते की पुष्टि करने वाले एपीआई की खास जानकारी देखें. साथ ही, यह भी देखें कि पते की पुष्टि करने वाला एपीआई कैसे काम करता है.

पते की पुष्टि करने वाले एपीआई की मदद से क्या किया जा सकता है

पते की पुष्टि करने वाले एपीआई की मदद से, यह पता लगाया जा सकता है कि पता, असल जगह का है या नहीं. अगर पता किसी असली जगह के बारे में नहीं है, तो एपीआई ऐसे गलत कॉम्पोनेंट की पहचान कर सकता है जो आपके ग्राहकों को दिखाए जा सकते हैं. यहां एपीआई का इस्तेमाल करके, एक वर्कफ़्लो दिया गया है:

  1. ग्राहक पता दर्ज करता है – यह इमेज एक आसान फ़ॉर्म दिखाता है, जो खरीदार को चेकआउट फ़्लो के दौरान पता डालने की अनुमति देता है.
    ग्राहक का पता.

  2. ऐप्लिकेशन, एपीआई को पता भेजता है – ऐप्लिकेशन इस पते को पते की पुष्टि करने वाले एपीआई के इनपुट के तौर पर पास करता है.

  3. एपीआई, पते की पुष्टि और स्टैंडर्डाइज़ करता है – इसके जवाब में, पता की पुष्टि करने वाला एपीआई, एपीआई से भरा हुआ पूरा पता दिखाता है और यह बताता है कि कहां पर जानकारी मौजूद नहीं है.

  4. ग्राहक सुझाए गए पते को सही करता है या उसकी पुष्टि करता है – एपीआई के ज़रिए दिए गए पते के आधार पर, ग्राहक को ये निर्देश दिए जा सकते हैं:

    • ग्राहक को सुझाया गया पता दें, ताकि इस बात की पुष्टि की जा सके:
      ग्राहक से पते की पुष्टि करने के लिए कहें, जैसा कि एपीआई ने तय किया है.

    • ग्राहक से ऐसी जानकारी जोड़ने के लिए कहें जो मौजूद नहीं है:
      ग्राहक से, पते की जानकारी न डालने का अनुरोध करें.

    • अगर एपीआई इनपुट में पते की पुष्टि नहीं कर पाता है, तो उपयोगकर्ता से पते में सुधार करने का अनुरोध करें:
      पते की जानकारी ठीक करने के लिए, ग्राहक से अनुरोध करें.

पते की पुष्टि करने वाला एपीआई कैसे काम करता है

पते की पुष्टि करने के बाद, पते के तौर पर JSON के मुख्य भाग में पते को अपडेट कर दिया जाता है. यह पते को उसके अलग-अलग कॉम्पोनेंट में बांट देता है और फिर नीचे दी गई जांचें करता है और उनमें सुधार करता है:

  • जहां भी उपलब्ध हो, वहां कंपनी की इमारत स्तर की जांच भी शामिल है.
  • ऐसी जानकारी जो मौजूद नहीं है या गलत पते वाले कॉम्पोनेंट का पता लगाती है.
  • पते के कॉम्पोनेंट के फ़ॉर्मैट को साफ़ करता है और उसे स्टैंडर्डाइज़ करता है.

पते की पुष्टि करने से जुड़ा एपीआई देखने के लिए, डेमो आज़माएं.

रिसॉर्स

नीचे दी गई टेबल में, पते की पुष्टि करने वाले एपीआई की मदद से दिए गए डेटा की खास जानकारी दी गई है. इसमें दिए गए डेटा के बारे में भी बताया गया है. खास जानकारी के लिए, पते की पुष्टि करने वाला एपीआई का रेफ़रंस देखें.

डेटा संसाधन डेटा लौटाया गया

JSON फ़ॉर्मैट में पते के कॉम्पोनेंट.

पते की पुष्टि करना देखें.

पूरा (पुष्टि किया गया) पता (अगर हो सके).

पते के हर कॉम्पोनेंट की पुष्टि की स्थिति.

किसी पते पर:

  • जियोकोड
  • पते की सटीक जानकारी
  • डाक सेवाओं का डेटा, जहां उपलब्ध हो.

पुष्टि के जवाब को समझना देखें.

पते की पुष्टि करने वाले एपीआई को इस्तेमाल करने का तरीका

1 डेमो आज़माएं सही और गलत, दोनों तरह के पतों के साथ, डेमो के बारे में जानें. डेमो से यह पता चलता है कि सर्विस से रिटर्न के मान के साथ-साथ, JSON के फ़ॉर्मैट वाले एपीआई रिस्पॉन्स का भी पता लगाया जा सकता है.
2 सेट अप करें. सबसे पहले, अपना Google Cloud प्रोजेक्ट सेट अप करें और इसके बाद दिए गए निर्देशों का पालन करें.
3 पते की पुष्टि करना एक आसान पते से शुरू करें, फिर ज़्यादा सटीक जानकारी के लिए, सीएएसएस चालू करें (सिर्फ़ अमेरिका और पीआर पतों के लिए). पते की पुष्टि करना देखें.
4 जवाब को प्रोसेस करना पते की पुष्टि करने वाले एपीआई के रिस्पॉन्स में दो प्रॉपर्टी होती हैं. हर प्रॉपर्टी को अलग-अलग तरीके से इस्तेमाल किया जाएगा. पुष्टि के जवाब को समझना देखें.
5 पुष्टि करने की प्रोसेस को ज़्यादा सटीक बनाएं पते की पुष्टि करने वाले एपीआई के रिस्पॉन्स पर सुझाव देकर, हमें पते की सटीक जानकारी को बेहतर बनाने में मदद की जा सकती है. पते की पुष्टि करने के बारे में सुझाव, शिकायत या राय दें देखें.

उपलब्ध क्लाइंट लाइब्रेरी

पते की पुष्टि करने वाले एपीआई के लिए उपलब्ध क्लाइंट लाइब्रेरी की सूची के लिए, क्लाइंट लाइब्रेरी देखें.

CASSTM के बारे में जानकारी

पते की पुष्टि करने वाली कंपनियों की मदद करने और उन्हें प्रमाणित करने के लिए, United States Postal Service® (USPS®)1 कोडिंग एक्ज़ीक्यूट सपोर्ट सिस्टम (CASSTM) बनाता है. एक CAS प्रमाणितTM सेवा, जैसे कि पता की पुष्टि करने वाले एपीआई को इस बात की पुष्टि कर दी गई है कि वह किसी पते में जानकारी नहीं भर रही है. साथ ही, उसे स्टैंडर्ड और स्टैंडर्ड जानकारी देने के लिए अपडेट कर सकती है.

CASS डिफ़ॉल्ट रूप से चालू नहीं होता है. यह सिर्फ़ "US" और "PR" क्षेत्र के लिए मौजूद है. CASS चालू करने के लिए, पुष्टि करने के अनुरोध के हिस्से के तौर पर enableUspsCass को true पर सेट करें. ज़्यादा जानकारी के लिए, पते की पुष्टि करना देखें.

यूएसपीएस सेवाओं के इस्तेमाल के हिस्से के तौर पर, यूएसपीएस, कृत्रिम रूप से बनाए गए पतों के अनुरोधों का मूल्यांकन करता है. अगर USPS किसी इनपुट पते को कृत्रिम रूप से बनाए गए के रूप में पहचानता है, तो Google को ग्राहक के लिए पते की पुष्टि करने को बंद करना होगा और ग्राहक की संपर्क जानकारी (नाम और पता), सही इनपुट पते, और इस्तेमाल के डेटा को USPS में रिपोर्ट करना होगा. एपीआई का इस्तेमाल करने का मतलब है कि आप इन सेवा की खास शर्तों से सहमत हैं.

अगला कदम क्या है


  1. Google Maps Platform, अमेरिका की Postal Service® का नॉन-इक्सक्लूसिव लाइसेंस है. नीचे दिए गए ट्रेडमार्क का मालिकाना हक अमेरिका का