दस्तावेज़ीकरण
प्लगइन कैसे सक्षम करें?
ग्रेविटी फॉर्म्स के लिए एड्रेस ऑटो-कंप्लीट खरीदने के बाद, आपको निम्नलिखित कार्य करने होंगे:
- इस प्लगइन को अपनी वर्डप्रेस वेबसाइट पर इंस्टॉल करें।.
- अपनी Google API कुंजी जनरेट करें और दर्ज करें।.
- किसी पते पर ऑटो-कंप्लीट सक्षम करें या एकल पंक्ति पाठ क्षेत्र।.
नीचे दिए गए निर्देशों से आपको पता चलेगा कि अपने प्लगइन को कैसे इंस्टॉल करें, एड्रेस ऑटो-कंप्लीट के लिए Google API कुंजी कैसे जनरेट करें और इसे एड्रेस फ़ील्ड या सिंगल लाइन टेक्स्ट फ़ील्ड पर कैसे सक्षम करें।.
प्लगइन को Plugin Brewery के साथ पंजीकृत करें
![]() | अपनी वर्डप्रेस वेबसाइट में लॉग इन करें और Plugins > Add Plugin > Upload Plugin पर जाएं > ज़िप फ़ाइल इंस्टॉल करें और उसे सक्रिय करें।. एक बार सक्रिय हो जाने पर, प्लगइन फॉर्म्स > ऐड-ऑन > इंस्टॉल्ड में दिखाई देता है और इसकी सेटिंग्स फॉर्म्स > सेटिंग्स > एड्रेस ऑटो-कंप्लीट के अंतर्गत उपलब्ध होती हैं।. |
![]() | बाईं ओर के नेविगेशन में, फ़ॉर्म > सेटिंग्स > पता ऑटो-कंप्लीट > लाइसेंस पर जाएं। अपना लाइसेंस कुंजी दर्ज करें और इसे सक्रिय करें। इसके बाद नीचे दिए गए Google API कुंजी जनरेशन सेटिंग्स पर जाएं।. |
Google API कुंजी जनरेट करें और दर्ज करें
एड्रेस ऑटो-कंप्लीट का उपयोग करने से पहले, आपको Google क्लाउड प्लेटफ़ॉर्म कंसोल में एक API कुंजी जनरेट करनी होगी।.
![]() | Google को सक्षम करें प्लेसेस एपीआई (नया) और गूगल मैप्स जावास्क्रिप्ट एपीआई. निर्देश देखें |
![]() | गूगल एपीआई कुंजी बनाएं और प्रतिबंधित करें।. निर्देश देखें |
![]() | गूगल एपीआई कुंजी दर्ज करें।. |
पता फ़ील्ड पर सक्षम करें
![]() | अपने फॉर्म में पता फ़ील्ड जोड़ें।. |
![]() | फ़ील्ड की सेटिंग खोलें, वहां जाएं विकसित अनुभाग, और सक्षम करें पता स्वतः पूर्ण चेकबॉक्स।. |
सिंगल लाइन टेक्स्ट फ़ील्ड पर सक्षम करें
![]() | अपने फॉर्म में एक सिंगल लाइन टेक्स्ट फ़ील्ड जोड़ें।. |
![]() | फ़ील्ड की सेटिंग खोलें, वहां जाएं विकसित अनुभाग, और सक्षम करें पता स्वतः पूर्ण चेकबॉक्स।. |
गूगल एपीआई कुंजी जनरेट करना
Google क्लाउड प्रोजेक्ट बनाएं या मौजूदा प्रोजेक्ट चुनें
Google API कुंजी प्राप्त करने से पहले, आपको निम्नलिखित कार्य करने होंगे: एक नया बनाएँ गूगल क्लाउड प्लेटफॉर्म प्रोजेक्ट (या यदि आपके पास पहले से कोई प्रोजेक्ट है तो उसे चुनें)।.
नोट: यदि आप कोई नया जीसीपी प्रोजेक्ट बना रहे हैं, तो हम अनुशंसा करते हैं कि आप इसे उस वेबसाइट के लिए सीमित करें जिस पर आप काम कर रहे हैं, ताकि यदि आपको उसी वेबसाइट के लिए अन्य Google एपीआई सेवाओं की आवश्यकता हो तो आप उनका उपयोग कर सकें।.

आवश्यक API सक्षम करें
Google Cloud प्रोजेक्ट बनाने या चुनने के बाद, APIs & Services > API Library पर जाएं और निम्नलिखित APIs को सक्षम करें:
ध्यान दें: प्लेसेस एपीआई को सक्रिय करने से पहले Google को आपके प्रोजेक्ट से एक बिलिंग खाता लिंक करने की आवश्यकता होती है। अधिकांश साइटों के लिए उपयोग Google के निःशुल्क टियर के अंतर्गत आता है, लेकिन भुगतान विधि फिर भी आवश्यक है।.
प्लेसेस एपीआई (नया)
आपको "प्लेसेस एपीआई" और "प्लेसेस एपीआई (नया)" दिखाई दे सकते हैं - हमारा प्लगइन "प्लेसेस एपीआई (नया)" के साथ संगत होने के लिए बनाया गया है।“

मैप्स जावास्क्रिप्ट एपीआई

कुंजी उत्पन्न करें
अब जबकि आपने अपने प्रोजेक्ट में दोनों API को सक्रिय कर दिया है, आप अपनी API कुंजी जनरेट कर सकते हैं।.
जाओ एपीआई और सेवाएं > क्रेडेंशियल, फिर “+ क्रेडेंशियल बनाएं” पर क्लिक करें और अंत में “एपीआई कुंजी” पर क्लिक करें।”

एक साइड डायलॉग विंडो खुलेगी जहां आप अपनी कुंजी का नाम दे सकते हैं।.
इस बिंदु पर, आप नीचे स्क्रॉल करके "बनाएँ" पर क्लिक कर सकते हैं और आपकी कुंजी तुरंत जनरेट हो जाएगी, हालाँकि... आपको अगले चरण में इस पर प्रतिबंध लगाना चाहिए ताकि आपकी कुंजी का अनधिकृत उपयोग रोका जा सके।.
ध्यान दें: यह बहुत महत्वपूर्ण है! कुंजी दिखाई देती हैं, इसलिए आप नहीं चाहेंगे कि कोई भी गलत व्यक्ति आपके मुफ्त उपयोग को चुरा ले।
संवाद विंडो में "एप्लिकेशन प्रतिबंध" तक स्क्रॉल करते रहें।.

“एप्लिकेशन प्रतिबंध” के अंतर्गत “वेबसाइटें” चुनें।”
"वेबसाइट प्रतिबंध" के अंतर्गत उन वेबसाइटों को जोड़ें जहाँ एपीआई कुंजी का उपयोग किया जाना चाहिए। HTTPS न जोड़ें।.
हम यह सुनिश्चित करने के लिए वाइल्डकार्ड डोमेन जोड़ने की सलाह देते हैं कि कुंजी www और गैर-www डोमेन दोनों पर काम करे, जैसा कि नीचे दिखाया गया है: *.example-website.com/*
क्रिएट पर क्लिक करें और आपकी कुंजी दिखाई देगी।.

अब आपकी एपीआई कुंजी बन गई है! इसे कॉपी करें और प्लगइन की एड्रेस ऑटो-कंप्लीट सेटिंग में पेस्ट करें, बस हो गया!

डोमेन फ़ॉर्मेटिंग: प्रत्येक डोमेन को अलग-अलग पंक्ति में निम्न प्रारूप का उपयोग करके दर्ज करें। example.com/* - नहीं https://, डोमेन में अंत में स्लैश नहीं होना चाहिए, लेकिन इसमें शामिल होना चाहिए। /* अंत में सभी पृष्ठों की अनुमति देने के लिए। सभी उपडोमेनों को कवर करने के लिए (जैसे www), एक अलग प्रविष्टि जोड़ें *.example.com/*. स्थानीय विकास के लिए, उपयोग करें localhost या localhost:3000/* यह आपके सेटअप पर निर्भर करता है।.
yourdomain.com/*
*.yourdomain.com/*
staging.yourdomain.com/*
localhost:8080/*गूगल की सेवा की शर्तें और गोपनीयता नीति
Plugin Brewery एड्रेस ऑटो-कंप्लीट, एड्रेस लुकअप को सक्षम करने के लिए फॉर्म डेटा को Google की सेवाओं पर भेजता है। Google के दिशानिर्देशों के अनुसार, Places API का उपयोग करने वाले किसी भी एप्लिकेशन को Google की वेबसाइट का लिंक प्रदर्शित करना चाहिए। सेवा की शर्तें और गोपनीयता नीति.
आपके देश या क्षेत्र के आधार पर, स्थान संबंधी डेटा एकत्र करने से पहले आपको उपयोगकर्ता की सहमति प्राप्त करने की भी आवश्यकता हो सकती है।.
विशेषता विवरण
समर्थित फ़ील्ड प्रकार
यह ग्रेविटी फॉर्म्स के दोनों प्रकार के फ़ील्ड पर काम करता है:
- पता फ़ील्ड (मल्टी-इनपुट)
- एकल पंक्ति पाठ (एक पंक्ति में पता दर्ज करना)
जब आप नेटिव जीएफ एड्रेस सबफील्ड चाहते हैं तो एड्रेस फील्ड का उपयोग करें, या जब आप सरल फॉर्म लेआउट चाहते हैं तो सिंगल लाइन टेक्स्ट का उपयोग करें।.
पार्स किया गया पता मैपिंग (नया)
चयनित पते के घटकों को अपने फ़ॉर्म में समर्पित फ़ील्ड में मैप करें:
- पता पंक्ति 1
- पता पंक्ति नं। 2
- डाक / ज़िप
- शहर / कस्बा
- राज्य / प्रांत / क्षेत्र
- देश
डिलीवरी-ज़ोन चेक, सीआरएम रूटिंग, सशर्त सूचनाओं और स्वचालन में उपयोग किए जाने वाले छिपे हुए फ़ील्ड के लिए बहुत अच्छा है।.
ज़िप/डाक कोड खोज (नया)
सिंगल लाइन टेक्स्ट फ़ील्ड को पोस्टल/ज़िप कोड सर्च में बदलें। एड्रेस ऑटो-कंप्लीट को सक्षम करें, फिर फ़ील्ड की एडवांस्ड सेटिंग्स में पोस्टल कोड लुकअप को चालू करें।.
- सुझाव केवल डाक/ज़िप कोड तक सीमित हैं।
- यह फ़ील्ड केवल चयनित कोड को ही रखता है (पूरा पता नहीं)।
- शहर, राज्य/क्षेत्र (और यदि मानचित्र में शामिल हो तो देश/काउंटी) स्वचालित रूप से भर जाते हैं, जिनमें छिपे हुए फ़ील्ड भी शामिल हैं।
- यह उन सभी देशों के लिए काम करता है जिनमें पोस्टल कोड होते हैं।
सेवा क्षेत्र की जांच, शिपिंग लॉजिक और आपके सीआरएम को सटीक स्थान डेटा भेजने के लिए बिल्कुल उपयुक्त।.
एकल पंक्ति पाठ डाक/ज़िप कोड हैंडलिंग
सिंगल लाइन टेक्स्ट फ़ील्ड के लिए, प्लगइन Google के फ़ॉर्मेटेड पते का उपयोग करता है और यदि पोस्टल/ज़िप कोड उपलब्ध है लेकिन प्रदर्शित टेक्स्ट में मौजूद नहीं है, तो उसे जोड़ देता है। यदि Google किसी परिणाम में पोस्टल कोड नहीं दिखाता है, तो उसे जोड़ा नहीं जा सकता।.
मेटाडेटा को एंट्री मेटा में सहेजा गया
जब उपयोगकर्ता किसी सुझाव का चयन करते हैं, तो प्लगइन निम्नलिखित जानकारी संग्रहीत करता है:
- स्थान आईडी
- अक्षांश
- देशान्तर
- स्वरूपित पता
देश संबंधी प्रतिबंध + अंतर्राष्ट्रीय सहायता
आप सुझावों को ISO अल्फा-2 कोड वाले विशिष्ट देशों तक सीमित कर सकते हैं (उदाहरण के लिए: US,CA,GB), या वैश्विक रूपों के लिए अप्रतिबंधित छोड़ दें।.
लेबल और मैपिंग विकल्प देश-निरपेक्ष हैं, इसलिए अमेरिकी और गैर-अमेरिकी टीमों के लिए कार्यप्रवाह स्पष्ट रहता है।.
प्रदर्शन + अनुकूलता
वास्तविक उत्पादन स्थलों के लिए डिज़ाइन किया गया:
- फ्रंट-एंड स्क्रिप्ट केवल वहीं आरंभ होती हैं जहां सक्षम फ़ील्ड मौजूद होते हैं
- यह स्टैंडर्ड और AJAX ग्रेविटी फॉर्म्स फ्लो के साथ काम करता है।
- अधिकांश कॉन्फ़िगरेशन में सामान्य कैशिंग/सीडीएन सेटअप के साथ संगत।
टैग मर्ज करें
जब कोई विज़िटर ऑटो-कंप्लीट सुझाव का चयन करता है, तो प्लगइन प्रविष्टि पर मेटाडेटा संग्रहीत कर सकता है। आप उस डेटा को पुष्टिकरण, सूचनाओं और अन्य स्थानों पर सम्मिलित कर सकते हैं जो ग्रेविटी फ़ॉर्म मर्ज टैग का समर्थन करते हैं।.
प्रारूप: {pb_aac:ID:KEY}
आईडी को उस एड्रेस या सिंगल लाइन टेक्स्ट फ़ील्ड की फ़ील्ड आईडी से बदलें जिसमें एड्रेस ऑटो-कंप्लीट सक्षम है (वही फ़ील्ड जहाँ सुझाव दिखाई देते हैं)।.
उपलब्ध कुंजियाँ (KEY):
| चाबी | इसका आउटपुट क्या है |
|---|---|
place_id | गूगल प्लेस आईडी |
lat | अक्षांश |
lng | देशान्तर |
formatted | फॉर्मेट किया गया पता (गूगल का फॉर्मेट किया गया स्ट्रिंग) |
google_maps_url | प्लेस आईडी (या प्लेस आईडी अनुपलब्ध होने पर अक्षांश/देशांश) से निर्मित गूगल मैप्स खोज यूआरएल। |
उदाहरण (यदि आपका ऑटो-कंप्लीट फ़ील्ड फ़ील्ड 12 है):
{pb_aac:12:place_id}{pb_aac:12:lat}{pb_aac:12:lng}{pb_aac:12:formatted}{pb_aac:12:google_maps_url}
पिकर: फॉर्म एडिटर में, सक्षम फ़ील्ड को मर्ज टैग पिकर में "पता स्वतः पूर्ण: ..." जैसे लेबल के अंतर्गत ये टैग भी मिलते हैं।.
टिप्पणी: केवल उन्हीं प्रविष्टियों के लिए मान मौजूद होते हैं जहां कोई सुझाव चुना गया था और मेटाडेटा सहेजा गया था; अन्यथा टैग खाली रहता है (डिज़ाइन के अनुसार)।.
पूछे जाने वाले प्रश्न
क्या गूगल प्लेसेस एपीआई मुफ्त है?
Google आपके खाते में स्वचालित रूप से $200 मासिक क्रेडिट जोड़ देता है, जिसका उपयोग Places API के लिए किया जाता है। अधिकांश साइटों के लिए, यह सभी खर्चों को कवर करता है - वर्तमान दरों पर, लगभग 10,000 ऑटो-कंप्लीट सेशन प्रति माह इस क्रेडिट के अंतर्गत आते हैं।.
हालांकि, कीमतों में बदलाव हो सकता है, इसलिए एक बार चेक कर लें। गूगल मैप्स प्लेटफॉर्म मूल्य निर्धारण तालिका नवीनतम आंकड़ों के लिए।.
क्या मैं इसे "सिंगल लाइन टेक्स्ट" फ़ील्ड के साथ उपयोग कर सकता हूँ?
जी हां! मानक पता फ़ील्ड के अलावा, आप किसी भी सिंगल लाइन टेक्स्ट फ़ील्ड पर ऑटो-कंप्लीट सुविधा चालू कर सकते हैं। यह उन फ़ॉर्मों के लिए आदर्श है जिनमें केवल एक ही पते की आवश्यकता होती है।.
क्या यह अंतरराष्ट्रीय पतों के लिए काम करता है?
बिल्कुल। यह प्लगइन Google से वैश्विक पते के डेटा का समर्थन करता है।.
क्या सेटअप करना जटिल है?
बिलकुल नहीं। बस प्लगइन सेटिंग्स में अपनी Google API कुंजी डालें, चुने हुए फ़ील्ड्स पर ऑटो-कंप्लीट चालू करें, और बस हो गया। यह इतना आसान है।.
क्या मैं परिणामों को विशिष्ट देशों तक सीमित कर सकता हूँ?
हाँ। फ़ील्ड सेटिंग्स में, ISO 3166-1 अल्फा-2 देश कोड की अल्पविराम से अलग की गई सूची प्रदान करें (उदाहरण के लिए, US,CA,GB).
मुझे Google Cloud में कौन सी Places API को सक्षम करना चाहिए?
“प्लेसेस एपीआई (नया)” को सक्षम करें क्योंकि पुराने “प्लेसेस एपीआई” और “मैप्स जावास्क्रिप्ट एपीआई” को बंद किया जाना निर्धारित है।.
क्या मैं नोटिफिकेशन या इंटीग्रेशन में एड्रेस मेटाडेटा का उपयोग कर सकता हूँ?
जी हां। एड्रेस ऑटो-कंप्लीट प्लेस आईडी, अक्षांश, देशांतर, फॉर्मेट किए गए पते और गूगल मैप्स यूआरएल के लिए मर्ज टैग जोड़ता है। किसी भी नोटिफिकेशन, कन्फर्मेशन या फ़ीड मैपिंग में ग्रेविटी फ़ॉर्म्स मर्ज-टैग पिकर का उपयोग करें।.
क्या डेवलपर Google द्वारा लौटाए जाने वाले परिणामों को अनुकूलित कर सकते हैं?
हाँ। इसका इस्तेमाल करें। pb_aac_request अनुरोध को समायोजित करने के लिए जावास्क्रिप्ट फ़िल्टर का उपयोग करना — उदाहरण के लिए, परिणामों को किसी क्षेत्र तक सीमित करना, एक सीमा बॉक्स जोड़ना, या व्यवसायों को शामिल करने के लिए इसका विस्तार करना।.
क्या मैं किसी फ़ील्ड का उपयोग ज़िप कोड/पोस्टल कोड खोज के रूप में कर सकता हूँ?
जी हां। सिंगल लाइन टेक्स्ट फ़ील्ड पर, एड्रेस ऑटो-कंप्लीट को सक्षम करें और फिर पोस्टल कोड लुकअप चालू करें। फ़ील्ड ज़िप कोड/पोस्टल कोड के सुझाव दिखाता है, और उनमें से किसी एक को चुनने पर आपके द्वारा चुने गए शहर और राज्य/क्षेत्र के फ़ील्ड (छिपे हुए फ़ील्ड सहित) भर जाते हैं। "अपने क्षेत्र की जांच करें" जैसे फ़ॉर्म और CRM रूटिंग के लिए यह बहुत उपयोगी है।.







