मकसद
इस दस्तावेज़ में, हम Google Sheets में पता की पुष्टि करने वाले एपीआई का इस्तेमाल करने का तरीका जानेंगे, ताकि इस सेवा की जांच आसानी से और कम समय में की जा सके.
अगर आप डेवलपर नहीं हैं और आपको Google Maps Platform से मिलने वाले डेटा, जैसे कि पते की पुष्टि करने वाले एपीआई का इस्तेमाल करना है, तो हो सकता है कि आप तकनीकी टीम की ज़्यादा मदद के बिना, इस सेवा का इस्तेमाल शुरू करने का तरीका ढूंढना चाहें.
उपयोग के उदाहरण
अब उन इस्तेमाल के उदाहरणों को समझते हैं जहां Google Sheets में मौजूद पते की पुष्टि करने वाले एपीआई का इस्तेमाल फ़ायदेमंद होता है:
- मुफ़्त में आज़माएं: कारोबार के तौर पर, हो सकता है कि आप अपने पतों का इस्तेमाल करके, पते की पुष्टि करने वाले एपीआई की सुविधाओं की तुरंत जांच करना चाहें.
- तुलना करें: Address Validation API के नतीजों की तुलना, Geocoding API या Places API जैसे अन्य एंडपॉइंट के नतीजों से करें.
- A/B टेस्ट: एक ही डेटासेट के वैरिएंट का A/B टेस्ट, ताकि यह समझा जा सके कि कौनसे वैरिएंट से बेहतर नतीजे मिल सकते हैं.
Google Sheets टेंप्लेट
यह समाधान Google Sheets है. इसमें पसंद के मुताबिक Apps Script फ़ंक्शन मिलता है. यह पते की पुष्टि करने वाले एपीआई के क्रम में अनुरोध करता है.
एपीआई की मदद से पते चलाने के लिए, नीचे दिया गया तरीका अपनाएं. इसके लिए, आपके पास Google खाता और एपीआई पासकोड होना चाहिए:
- सैंपल स्प्रेडशीट पर जाएं और मेन्यू से, फ़ाइल > कॉपी बनाएं
चुनें. इसके लिए, आपको अपने Google खाते में लॉग इन करना होगा या नया खाता बनाना होगा - पते की पुष्टि करने वाले एपीआई को चालू करें और Cloud Console से एपीआई पासकोड जनरेट करें.
- Sheets के “एपीआई पासकोड + डैशबोर्ड” टैब में, B2 सेल को अपने एपीआई पासकोड से बदलें.
- टेंप्लेट में पते कॉपी करें/चिपकाएं (डेटा फ़ॉर्मैट करने के लिए, किसी अलग शीट में: सड़क का नंबर, नाम, शहर, पोस्टकोड जोड़ें)
- शीट की सेल चुनें. इसके बाद, मेन्यू में जाकर “पते की पुष्टि करें” >
“पते की पुष्टि करने के लिए एपीआई चुनें”
को चुनें - पहली बार चलाने पर, आपको Apps Script का ऐक्सेस देने के लिए, “अनुमति ज़रूरी है” मैसेज दिखेगा.
Google Maps Platform की सेवा की शर्तें
यह समाधान, कुछ खास पतों पर टेस्ट के मकसद से उपलब्ध कराया गया है:
कैश मेमोरी में सेव करने की अनुमति वाली अवधि: लगातार 30 दिन, इसके बाद ग्राहक को (1) कैश मेमोरी में सेव किया गया Google Maps कॉन्टेंट मिटाना होगा या (2) असली उपयोगकर्ता की पुष्टि या सुधार के ज़रिए दिए गए असली उपयोगकर्ता के डेटा से बदलना होगा. Google Maps Platform की सेवा की शर्तों की टेबल 11.3.1 (कैश मेमोरी में सेव करने की अनुमतियां) देखें:
- placeId
- जगह की जानकारी: अक्षांश की वैल्यू, देशांतर की वैल्यू
- verdict
- formattedAddress
- postalAddress
- पता कॉम्पोनेंट: कॉम्पोनेंट का नाम
- USPS Data standardizedAddress
ज़रूरी बातें
- परफ़ॉर्मेंस: एक बार में 1,000 से ज़्यादा पंक्तियों के ग्रुप में डेटा डालें. स्क्रिप्ट आखिर में रुक सकती है. उदाहरण के लिए, हर सेकंड में एपीआई कोटा से ज़्यादा इस्तेमाल करने पर, स्क्रिप्ट जहां रुकी थी वहां से फिर से शुरू करें.
- मेन्यू > एक्सटेंशन > Apps Script से कोड को ऐक्सेस किया जा सकता है. साथ ही, अपनी ज़रूरत के हिसाब से स्क्रिप्ट का अपना वर्शन बनाया जा सकता है
- पते की पुष्टि करने वाले एपीआई के लिए, कीमत.
नतीजा
Google Sheets में मौजूद पते की पुष्टि करने वाले एपीआई की मदद से, डेवलपर के अलावा अन्य लोग भी पते की पुष्टि करने वाले एपीआई से क्वेरी कर सकते हैं. साथ ही, यह भी समझ सकते हैं कि यह उनके कारोबार के लिए कैसे फ़ायदेमंद हो सकता है. इस दस्तावेज़ में यह दिखाने की कोशिश की गई है कि एपीआई पासकोड बनाकर और दिए गए Google Sheets टेंप्लेट का इस्तेमाल करके, कोई भी व्यक्ति एपीआई से क्वेरी कैसे कर सकता है.
अगली कार्रवाइयां
इसके बारे में और पढ़ने के लिए, ये लेख पढ़ें:
योगदानकर्ता
इस लेख को Google मैनेज करता है. इसे मूल रूप से इन लोगों ने लिखा था.
मुख्य लेखक:
थॉमस एंगलरेट | सलूशन इंजीनियर\