Address Validation API के बारे में खास जानकारी

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

Address Validation API: मुख्य बातें

  • प्रॉडक्ट: Address Validation API
  • कैटगरी: जगहें
  • प्लैटफ़ॉर्म: वेब सेवा (REST)
  • इस पर चलता है: सर्वर (बैकएंड कोड)
  • लॉन्च स्टेज: GA
  • लाइफ़साइकल: चालू है
  • खास जानकारी: Address Validation API के बारे में खास जानकारी
  • देश या इलाके के हिसाब से उपलब्धता: सीमित. यह सुविधा कुछ ही देशों में उपलब्ध है. साथ ही, डेटा क्वालिटी भी देश के हिसाब से अलग-अलग होती है. कुछ देशों में यह सुविधा, झलक के तौर पर उपलब्ध है. रिहायशी और व्यावसायिक मेटाडेटा, सिर्फ़ उन देशों के लिए दिखाया जाता है जिन्हें कवरेज पेज पर फ़्लैग किया गया है. USPS CASS का इस्तेमाल सिर्फ़ अमेरिका और प्योर्तो रिको के लिए किया जा सकता है. (कवरेज की जानकारी)

Address Validation API: इसका इस्तेमाल कब करें

Address Validation API का इस्तेमाल तब करें, जब:

  • आपको यह देखना होगा कि कोई पता किसी असल जगह का है या नहीं. साथ ही, यह पता लगाना होगा कि उसमें कौनसे कॉम्पोनेंट मौजूद नहीं हैं या गलत हैं.
  • आपको डाक या कूरियर भेजने के लिए, पते को स्टैंडर्ड फ़ॉर्मैट में और पूरा लिखना होगा. उदाहरण के लिए, चेकआउट प्रोसेस के दौरान.
  • अमेरिका या प्योर्तो रिको के पतों के लिए, आपके पास यूएसपीएस सीएएसएस सर्टिफ़िकेट और uspsData होना चाहिए.
  • कवरेज पेज पर मौजूद किसी देश के लिए, आपको रिहायशी या व्यावसायिक पते का मेटाडेटा देना होगा.

Address Validation API का इस्तेमाल तब न करें, जब:

  • आपको सिर्फ़ किसी पते को अक्षांश/देशांतर में बदलना है और पते के अलग-अलग कॉम्पोनेंट की पुष्टि करने की ज़रूरत नहीं है. इसके बजाय, Geocoding API का इस्तेमाल करें.
  • आपको मंज़िल की हाइपर-लोकल जानकारी चाहिए. जैसे, इमारत के अंदर जाने के रास्ते, इमारत की आउटलाइन या नेविगेशन पॉइंट. इसके बजाय, Geocoding API का इस्तेमाल करें.

Address Validation API: सेटअप

Address Validation API के आधिकारिक पैकेज:

  • npm: @googlemaps/addressvalidation
  • pypi: google-maps-addressvalidation
  • go: cloud.google.com/go/maps

Address Validation API: आम गलतियां

  • समस्या: जब addressComplete प्रॉपर्टी की वैल्यू false होती है, तब उसे नतीजे से हटा दिया जाता है. इसलिए, जिस कोड को फ़ील्ड के मौजूद होने की उम्मीद होती है वह अधूरे पतों को गलत तरीके से पढ़ सकता है. ठीक करने का तरीका: addressComplete प्रॉपर्टी मौजूद न होने पर, उसे false के तौर पर इस्तेमाल करें या देखें कि प्रॉपर्टी मौजूद है या नहीं. /maps/documentation/address-validation/understand-response देखें.
  • समस्या: अगर regionCode को शामिल नहीं किया जाता है, तो एपीआई पते से इलाके का अनुमान लगाता है. इससे खराब नतीजे मिल सकते हैं. ठीक करने का तरीका: जब आपको regionCode के बारे में पता हो, तब उसे PostalAddress में शामिल करें. /maps/documentation/address-validation/requests-validate-address देखें.
  • समस्या: इस बात की कोई गारंटी नहीं है कि अमेरिका के पुष्टि किए गए हर पते के लिए, uspsData ऑब्जेक्ट में पूरी जानकारी मौजूद हो. ठीक करने का तरीका: पुष्टि करने के लिए, सिर्फ़ uspsData पर भरोसा न करें. इसके बजाय, फ़ैसले और पते के कॉम्पोनेंट का भी इस्तेमाल करें. /maps/documentation/address-validation/handle-us-address देखें.
  • समस्या: provideValidationFeedback के साथ भेजे गए फ़ीडबैक में, क्रम में पहले validateAddress कॉल के responseId का रेफ़रंस होना चाहिए, न कि बाद वाले कॉल का. ठीक करने का तरीका: पहले validateAddress रिस्पॉन्स से responseId को सेव करें और उसे सुझाव/राय देने या शिकायत करने के अनुरोध में भेजें. /maps/documentation/address-validation/handle-updated-address देखें.

Address Validation API की मदद से क्या-क्या किया जा सकता है

हर टास्क के लिए, यहां लिंक की गई गाइड देखें या Capabilities Explorer में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.