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: सेटअप
- चालू की जाने वाली सेवा:
addressvalidation.googleapis.com - पुष्टि करना: एपीआई पासकोड, OAuth 2.0, सेवा खाता
- शुरू करें: Address Validation API सेट अप करें
- रेफ़रंस: Address Validation API का रेफ़रंस
- कीमत: Address Validation API का इस्तेमाल और बिलिंग
- नीतियां: Address Validation 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 में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.
- किसी पते या अधूरे पते के लिए, पुष्टि किया गया पता दिखाता है.
- पुष्टि किए गए पते के लिए, अक्षांश/देशांतर के निर्देशांक दिखाता है.
- पुष्टि किए गए पते के लिए, Google प्लेस आइडेंटिफ़ायर दिखाएं.
- पते की पुष्टि करने के लिए, United States Postal Service (USPS) के Coding Accuracy Support System (CASS) सर्टिफ़िकेशन का इस्तेमाल करें.
- यह जानकारी देना कि पुष्टि किया गया पता किसी कारोबार का है, घर का है या पीओ बॉक्स है.
- पुष्टि किए गए पते के लिए, यूनाइटेड स्टेट्स पोस्टल सर्विस (यूएसपीएस) का डिलीवरी मेटाडेटा दिखाना.
- पुष्टि किए गए पते का अंग्रेज़ी वर्शन दिखाएं. झलक
- पुष्टि किए गए पते के लिए Plus Code दिखाना.