1. Google Maps API कुंजी प्राप्त करें

अगर आपका डोमेन 22 जून 2016 के बाद बनाया गया है, तो हर बार Google Maps API का इस्तेमाल करते समय, आपको अपने अनुरोध को मान्य करने के लिए एक कुंजी शामिल करनी होगी।
कुंजी प्राप्त करें और API सक्षम करें: https://developers.google.com/maps/documentation/javascript/get-api-key

अधिक जानकारी: https://developers.google.com/maps/documentation/javascript/usage?hl=en

पहला चरण एक प्रोजेक्ट बनाना है और फिर प्रोजेक्ट का नाम टाइप करना है।

यदि मैं mydomain से सभी अनुरोधों को अनुमति देना चाहता हूँ, तो अनुसरण करने का पैटर्न *.joomunited.com/* होगा।
यदि आप केवल एकल डोमेन को अनुमति देना चाहते हैं, उदाहरण के लिए mydomain.com, तो पैटर्न joomunited.com/* होगा।

लोकलहोस्ट वातावरण पर, आप कोई भी वैध कुंजी डाल सकते हैं और यह बिना किसी डोमेन संदर्भ के काम करेगा।

इसके बाद API कुंजी उत्पन्न होती है, यह वह कुंजी है जिसे आपको My Maps locationमें जोड़ने के लिए कॉपी करना होगा।

My Maps Locationमें कुंजी जोड़ें.

घटक > My Maps Location > विकल्प दृश्य से , आप कॉन्फ़िगरेशन में एक कुंजी जोड़ सकते हैं।

कुंजी चिपकाएँ.

चरण दर चरण बायोडाटा:

तो मैं जो कदम उठाता हूँ वे हैं

• Google API कंसोल पर जाएं
• कोई प्रोजेक्ट बनाएँ या चुनें
• API और किसी भी संबंधित सेवा को सक्षम करने के लिए जारी रखें पर क्लिक करें
• क्रेडेंशियल पृष्ठ पर, ब्राउज़र कुंजी (और API क्रेडेंशियल सेट करें)
• इन सर्वोत्तम प्रथाओं का पालन करके अपनी API कुंजी सुरक्षित करें

2. स्थान की श्रेणियों का प्रबंधन करें

स्थानों को श्रेणियों में वर्गीकृत किया जाता है। इन श्रेणियों को फ़्रंटएंड में फ़िल्टर के रूप में प्रदर्शित किया जा सकता है या कुछ वर्गीकृत स्थानों को लोड करने के लिए मेनू आइटम में पूर्वनिर्धारित पैरामीटर के रूप में उपयोग किया जा सकता है।
 

अगर आपके पास बहुत सारे स्थान हैं, तो श्रेणियों का उपयोग करने की सलाह दी जाती है। आप श्रेणियाँ और उप-श्रेणियाँ बना सकते हैं।
श्रेणी बनाने के लिए, कृपया My Maps location > श्रेणी में जाएँ और नया पर क्लिक करें।

फिर श्रेणी स्क्रीन से आपको एक शीर्षक और एक मूल श्रेणी जोड़नी होगी, यदि आप एक उपश्रेणी बनाना चाहते हैं

मार्कर चयन टैब का उपयोग करके श्रेणी में स्थान के लिए एक डिफ़ॉल्ट मार्कर भी परिभाषित कर सकते हैं

3. एक स्थान बनाएँ

स्थान बनाने के लिए, कृपया My Maps location > स्थान > नया

इसमें 3 अनिवार्य फ़ील्ड हैं:

• स्थान का नाम
• स्थान की श्रेणी
• स्थान विवरण (पता)      

पते को जोड़ने के लिए आपको 3 समाधान मिलेंगे:

• खोज फ़ील्ड का उपयोग करें (अनुशंसित)
• मानचित्र पर नेविगेट करें और किसी स्थान को इंगित करने के लिए कर्सर का उपयोग करें
• पता भरें (Google Maps पर मान्य होना चाहिए)

खोज इंजन के साथ कोई स्थान जोड़ने के लिए, उस स्थान का नाम लिखें जिसे आप जोड़ना चाहते हैं।

चयन करने पर, अक्षांश और देशांतर फ़ील्ड अपने आप भर जाएँगे। माई मैप्स गूगल प्लेस के साथ भी एकीकृत है! इसका मतलब है कि आप गूगल मैप्स पर पंजीकृत किसी दुकान या किसी अन्य चीज़ को खोज सकते हैं, हमारा घटक उस स्थान की सभी जानकारी प्राप्त कर लेगा।

आप मानचित्र पर आगे बढ़ सकते हैं और सीधे मार्कर लगा सकते हैं, परिणाम वही होगा और आपको अक्षांश और देशांतर स्वतः ही भर दिए जाएंगे।

यदि आप पता फ़ील्ड और ज़िप कोड को मैन्युअल रूप से भर रहे हैं तो सावधानी बरतें, यह गूगल मैप्स के ज्ञात पते से मेल खाना चाहिए।

स्थान की अन्य सभी जानकारी (विवरण, घंटे,...) स्थान के विस्तृत दृश्य में प्रदर्शित की जाती है।

स्थान विवरण संस्करण में संपर्क लिंक, प्रत्येक स्थान के लिए एक संपर्क लिंक, mailto या URL जोड़ने की सुविधा प्रदान करता है। फ़्रंटएंड पर, यह एक संपर्क बटन होगा जो URL खोलेगा या mailto क्रिया को क्रियान्वित करेगा।

4. अन्य स्थान की जानकारी

प्रत्येक स्थान पर आप एक छवि और एक मार्कर जोड़ सकते हैं। 

• स्थान छवि: छवि स्थान के टूलटिप में थंबनेल के रूप में और स्थान विवरण पृष्ठ पर बड़े आकार में प्रदर्शित की जाएगी।
• श्रेणी चिह्न का उपयोग करें: मेरे मानचित्र स्थानों के श्रेणी फ़ील्ड में आपके द्वारा डाले गए चिह्न का उपयोग करें
• मार्कर पृष्ठभूमि: अपने पृष्ठभूमि मार्कर के लिए रंग चुनें
• मार्कर मैप पर लोकेशन मार्कर आइकन के रूप में प्रदर्शित होगा। आपको My Maps Location एक्सटेंशन में अपने स्थानों के लिए कुछ अच्छे मार्कर सेट भी मिलेंगे।
• कस्टम लिंक का उपयोग करने से स्थान के विवरण के लिंक को कस्टम URL द्वारा ओवरराइड कर दिया जाएगा।

My Maps location जूमला की मूल बहुभाषी सुविधा का उपयोग कर रहा है। आप स्थान श्रेणियों और स्थानों में भाषा निर्धारित कर सकते हैं। भाषा बदलने पर, भाषा-अनुमोदित सामग्री प्रदर्शित करने के लिए स्थानों को किसी भी अन्य जूमला सामग्री की तरह फ़िल्टर किया जाएगा।

स्थान विवरण फ़ील्ड सबसे महत्वपूर्ण फ़ील्ड में से एक है।
यह स्थान विवरण पृष्ठ पर और, थीम के आधार पर, खोज परिणामों में स्थान के परिचयात्मक पाठ के रूप में प्रदर्शित होगा। इससे भी महत्वपूर्ण बात यह है कि विवरण एक WYSIWYG संपादक है जिसमें सभी प्लगइन्स लोड हैं, यानी आप इसमें अपनी इच्छानुसार कुछ भी (चित्र, वीडियो...) डाल सकते हैं।

यहां स्थान खोज परिणामों में प्रदर्शित परिचय पाठ दिया गया है।

टैग फ़ील्ड, जूमला जैसा ही टैग सिस्टम है। आप टैग और सब-टैग जोड़कर उसे फ़िल्टर के रूप में फ़्रंटएंड में लोड कर सकते हैं। सभी टैग प्रबंधित करने के लिए, बस जूमला टैग घटक लोड करें: मेनू घटक > टैग
फ़्रंटएंड पर, कॉन्फ़िगरेशन के आधार पर, टैग चेकबॉक्स (नीचे दिए गए की तरह) या ड्रॉपडाउन सूची के रूप में प्रदर्शित किए जा सकते हैं।

My Maps Location मेटा जानकारी भरने के लिए अतिरिक्त फ़ील्ड हैं (सर्च इंजन के लिए)। ये फ़ील्ड लोकेशन विवरण पृष्ठ पर लोड किए गए हैं।

5. फ्रंटएंड पर स्थान प्रदर्शित करें

अपने स्थानों को फ्रंटएंड पर प्रदर्शित करने के लिए आप उपयोग कर सकते हैं:

• स्थान खोज इंजन, एकल स्थान या स्थानों की श्रेणी प्रदर्शित करने के लिए एक मेनू
• खोज फ़ील्ड प्रदर्शित करने या स्थानों का एक सेट चुनने के लिए एक मॉड्यूल
• किसी भी संपादक में एकल या एकाधिक स्थानों को प्रदर्शित करने के लिए एक संपादक बटन

मेनू से स्थान लोड करें

"स्थान खोज और प्रदर्शन" टाइप करें यह फ़िल्टर के साथ स्थान खोज इंजन प्रदर्शित करेगा।
एक पूर्वनिर्धारित स्थान प्रदर्शित करने के लिए "स्थान विवरण दृश्य" चुनें

मेनू के मुख्य टैब से आप निम्न सेटअप कर सकते हैं:

• पता दर्ज करें: आप पृष्ठ लोड होने पर एक डिफ़ॉल्ट पता प्रदर्शित करने के लिए बाध्य कर सकते हैं। इसे खाली छोड़ा जा सकता है
• दूरी: ऊपर दिए गए पते का संदर्भ देते हुए, खोज को लॉक करने की दूरी। इसे -1 (डिफ़ॉल्ट) पर छोड़ा जा सकता है।
• श्रेणी: स्थान की एक विशिष्ट श्रेणी लोड करें
• खोज सीमा: खोज परिणामों की संख्या सीमित करें। 10 स्थान खोज पर केवल 10 पहले परिणाम लौटाएगा
• क्रम: खोज परिणामों को दिनांक, शीर्षक, दूरी (डिफ़ॉल्ट) के अनुसार क्रमित करें

My Maps Location मेनू टैब पर , आप सेटअप कर सकते हैं:

• घटक का चयन करें: My Maps Location या सभी तृतीय पक्ष एकीकरण जैसे K2, Jomsocial ...
• डिफ़ॉल्ट श्रेणी आईडी (तृतीय पक्ष एक्सटेंशन): जब किसी तृतीय पक्ष एक्सटेंशन का उपयोग किया जाता है, जैसे K2, Hikashop या Adsmanager, समुदाय बिल्डर के लिए CB सूची आईडी, तो लोड करने के लिए डिफ़ॉल्ट श्रेणी
• उपश्रेणी स्थान: उपश्रेणियों से खोज परिणाम स्थानों के रूप में भी प्रदर्शित करें, न कि केवल ऊपर चयनित स्थान के रूप में
• थीम: मेनू आइटम के लिए उपलब्ध खोज और परिणाम प्रदर्शन थीम के डिफ़ॉल्ट, पूर्ण चौड़ाई और साइडबार तीन थीमों में से एक का चयन करें
• मानचित्र प्रदाता: अपने मानचित्रों को स्टाइल देने के लिए Google Maps, Bing Maps, Mapbox, OpenStreetMap, Baidu या Mapquest चुनें
• खोज टैग सक्षम करें : स्थान टैग नामों का उपयोग करके खोज क्वेरी करने की अनुमति देता है
• डिज़ाइन: मानचित्र स्रोत के आधार पर आपके पास कई प्रकार के मानचित्र और रंग होते हैं
• मानचित्र परत: अपने मानचित्रों में कुछ डेटा (परत) जोड़ें। इसमें KML परत, ट्रैफ़िक परत, ट्रांज़िट परत और साइकिलिंग परत शामिल हैं।
• Google मानचित्र परत URL: अपने कस्टम डेटा को संग्रहीत करने के लिए या Google मानचित्र पर GeoJSON डेटा प्रदर्शित करने के लिए डेटा परत का उपयोग करें
• बिंग मैप्स प्रकार: यदि बिंग मैप्स आपका मानचित्र प्रदाता है, तो बिंग मैप्स का स्वरूप और डेटा चुनें
• OpenStreetMap प्रकार: यदि OpenStreetMap आपका मानचित्र प्रदाता है, तो आप अपने मानचित्रों में कुछ डेटा (परत) जोड़ सकते हैं
• स्थान टूलटिप: मानचित्र लोड होने पर, स्थान खोज के बाद स्वचालित रूप से स्थान टूलटिप खोलें
• मानचित्र ज़ूम: मानचित्र पर डिफ़ॉल्ट ज़ूम स्तर निर्धारित करें
• मानचित्र और खोज परिणामों की चौड़ाई और ऊँचाई के विकल्प

थीम पर आधारित फ्रंटएंड डिस्प्ले

एकल स्थान खोज प्रदर्शन के लिए परिणाम:

मॉड्यूल का उपयोग करके स्थान प्रदर्शित करें

My maps location मूल स्थानों के लिए 2 मॉड्यूल के साथ आता है + अन्य तीसरे पक्ष के एकीकरण के लिए (जैसे K2 आइटम स्थानों को प्रदर्शित करने के लिए एक मॉड्यूल)

मानचित्र मॉड्यूल आपको मेनू के समान फ़िल्टर के साथ, लेकिन मॉड्यूल स्थिति में, अपने स्थानों को प्रदर्शित करने की अनुमति देता है। स्थान मानचित्र या सूची के रूप में प्रदर्शित होंगे। आप स्थानों का एक समूह चुन सकते हैं या स्थान श्रेणियाँ चुन सकते हैं।

My Maps Location मानचित्र - खोज मॉड्यूल कुछ फिल्टर के साथ एक खोज इंजन प्रदर्शित करेगा जैसे कि मानचित्र की चौड़ाई या घटक जिसमें स्थान खोजा जाएगा (केवल उदाहरण के लिए K2 स्थान की खोज करें)।

फ्रंटएंड पर प्रदर्शन मॉड्यूल:

संपादक बटन का उपयोग करके स्थान प्रदर्शित करें

संपादक बटन आपके जूमला संपादक (आमतौर पर लेखों या HTML कस्टम मॉड्यूल में) में लोड हो जाएगा। आपको यह बटन आपके संपादक के नीचे दिखाई देगा।
क्लिक करने पर आपको एक लाइटबॉक्स दिखाई देगा जो आपको पहले से जोड़े गए एक या कई स्थानों को चुनने की सुविधा देता है।

फिर आप एक या कुछ स्थान चुनकर उसे अपने लेख में जोड़ने के लिए बटन दबा सकते हैं। अगर आप कोई ज़ूम स्तर निर्दिष्ट नहीं करते हैं, तो वह आपके स्थान क्षेत्र के अनुसार स्वचालित रूप से लोड हो जाएगा।
आपके WYSIWYG संपादक में आपको जो टैग कोड दिखाई देगा, वह इस मॉडल जैसा होगा: {mymaplocations mapid width height}

उदाहरण: {mymaplocation id=1 width=58% height=400px zoom=10 type=google} यह कोड लोकेशन ID=1, 58% चौड़ाई, 400px ऊँचाई, 10 गुना ज़ूम और Google प्रकार वाला एक मानचित्र प्रदर्शित करेगा। मानचित्र में एक से अधिक स्थान जोड़ने के लिए अल्पविराम का उपयोग करें। उदाहरण: {mymaplocation id=1 width=58% height=400px zoom=10 type=google} लोकेशन ID = 1, 2, 3।