अपने MonstarX ऐप से Google Maps कनेक्ट करें

संक्षेप मेंआपका ऐप पहले से मुफ़्त में मैप दिखा सकता है। Google Maps तब कनेक्ट करें, जब आपको Google का डेटा चाहिए — जगहें खोजना, टाइप करते समय पता अपने-आप भरना, बिज़नेस की जानकारी और रिव्यू, या रास्ते। Google Cloud में API कुंजी बनाएँ, उसे बैकएंड → क्लाउड में पेस्ट करें और सुविधा माँगें।

Google के मैप, जगहों की खोज और रास्ते।

प्रकार: आपके ऐप के लिए
श्रेणी: मैप और जगहें
कनेक्ट करने का तरीका: API कुंजी

Google Maps Platform, मैप के डेटा के लिए Google की सेवा है: Google Maps के पीछे की जगहें, पते, खुलने का समय, रिव्यू और रास्ते। इसे कनेक्ट करें, तो आपका ऐप उस डेटा में चीज़ें खोज सकता है।

सिर्फ़ मैप दिखाने के लिए इसकी ज़रूरत नहीं है। हर MonstarX ऐप मुफ़्त में सड़कों वाला मैप दिखा सकता है, जिसे खिसकाया और ज़ूम किया जा सकता है और जिस पर पिन लगाए जा सकते हैं — देखें आपके ऐप में मैप। Google Maps उन चीज़ों के लिए है जो वे मैप खुद नहीं जान सकते।

इससे आप क्या बना सकते हैं?

पते का ऑटोकम्प्लीट: लोग पता टाइप करना शुरू करते हैं और Google के सुझावों में से उसे चुन लेते हैं।
जगहों की खोज: “मेरे आस-पास के कैफ़े”, “Fitzroy में फ़िज़ियोथेरेपिस्ट” — सूची में भी और मैप पर भी।
बिज़नेस की जानकारी: किसी जगह के खुलने का समय, फ़ोन नंबर, रेटिंग और रिव्यू।
मैप पर पते: टाइप किए गए पते को पिन में बदलना (इसे जियोकोडिंग कहते हैं)।
ड्राइविंग के रास्ते — दो जगहों के बीच।

शुरू करने से पहले

एक Google Cloud खाता, जिससे बिलिंग खाता जुड़ा हो। Google Maps Platform को इसकी ज़रूरत होती है, चाहे आपका इस्तेमाल हर महीने के मुफ़्त कोटे के अंदर ही क्यों न हो (देखें Google की कीमतें)।
आपके ऐप के लिए एक Google Cloud प्रोजेक्ट।

अपनी कुंजी पाएँ

Google Cloud console में कोई प्रोजेक्ट चुनें या बनाएँ, और Google Maps Platform खोलें।
वे API चालू करें जिन्हें आपका ऐप इस्तेमाल करेगा। ऊपर दिए आइडिया के लिए: खोज और ऑटोकम्प्लीट के लिए Maps JavaScript API और Places API (New), पतों के लिए Geocoding API, और रास्तों के लिए Routes API।
Keys & Credentials खोलें और एक API कुंजी बनाएँ। उसे कॉपी करें (यह AIza से शुरू होती है)।
कुंजी पर पाबंदी लगाएँ। API restrictions में सिर्फ़ वही API चुनें जो आपने चालू किए हैं।

यह कुंजी ब्राउज़र तक पहुँचती है, इसलिए कोई भी इसे कॉपी कर सकता है। इसे अपने API तक सीमित रखने से यह किसी और काम के लिए इस्तेमाल नहीं हो पाती। Google आपको कुंजी को अपनी वेबसाइट के पतों तक सीमित करने का विकल्प भी देता है — लेकिन तब Google वे लुकअप ठुकरा देता है जो आपका ऐप अपने सर्वर से करता है, जैसे किसी पते को मैप की लोकेशन में बदलना। अगर आपका ऐप ऐसा करता है, तो सिर्फ़ API के हिसाब से पाबंदी लगाएँ, या MonstarX से सर्वर के लिए दूसरी कुंजी इस्तेमाल करने को कहें।

MonstarX में कनेक्ट करें

अपना प्रोजेक्ट खोलें, ऊपर की बार में बैकएंड पर क्लिक करें, फिर क्लाउड पर।
कनेक्टर सेक्शन में Google Maps के बगल में कनेक्ट करें पर क्लिक करें।
कुंजी को API कुंजी में पेस्ट करें।
Google Maps कनेक्ट करें पर क्लिक करें। पंक्ति में कनेक्ट है दिखता है, और आपका प्रीव्यू कुंजी के साथ फिर से शुरू होता है।

MonstarX से इसका इस्तेमाल करवाएँ

आप लिखते हैं	क्या होता है
“बुकिंग फ़ॉर्म पर Google Maps से पते का ऑटोकम्प्लीट लगाएँ।”	लोगों के टाइप करते ही सुझाव दिखते हैं; चुना गया पता सेव हो जाता है।
“Google Places खोज के साथ ‘अपने पास का स्टूडियो ढूँढें’ पेज जोड़ें।”	एक खोज बॉक्स और नतीजे — नाम, पते और रेटिंग के साथ, मैप पर पिन किए हुए।
“Google से हर कैफ़े के खुलने का समय और रेटिंग दिखाएँ।”	हर जगह के लिए Google से लाई गई बिज़नेस की जानकारी।
“ड्राइवरों को डिपो से हर डिलीवरी पते तक का रास्ता दिखाएँ।”	दूरी और समय के साथ एक रास्ता।

सुरक्षा और गोपनीयता

यह कुंजी एक सार्वजनिक कुंजी है: यह लोगों के ब्राउज़र में इस्तेमाल होती है, इसलिए छिपी नहीं रहती। इसे सुरक्षित रखने का तरीका है Google Cloud में इस पर पाबंदी लगाना।
यह सिर्फ़ इसी ऐप के साथ रखी जाती है। इसका नाम बैकएंडसीक्रेट में दिखता है।
सिर्फ़ प्रोजेक्ट का मालिक ही Google Maps को कनेक्ट, अपडेट या डिस्कनेक्ट कर सकता है।
कुंजी बदलने के लिए Google Cloud में नई कुंजी बनाएँ, Google Maps की पंक्ति में कुंजियाँ अपडेट करें पर क्लिक करें, उसे पेस्ट करें और कुंजियाँ सहेजें पर क्लिक करें। फिर से प्रकाशित करें, फिर पुरानी कुंजी हटा दें।

जानने लायक बातें

आपके मैप का लुक वही रहता है: Google Maps आपके ऐप में डेटा और खोज जोड़ता है, Google के मैप टाइल नहीं।
हर महीने के मुफ़्त कोटे के बाद Google हर अनुरोध के पैसे लेता है। Google Cloud बिलिंग में बजट अलर्ट लगाएँ।
इसकी जगह सैटेलाइट व्यू या Mapbox के मैप स्टाइल चाहिए? देखें Mapbox।
Google की शर्तों में उसके जगहों वाले डेटा को दिखाने के नियम हैं, जैसे नतीजों के बगल में Google को श्रेय देना। अगर आपका ऐप जगहों की सूची दिखाता है, तो MonstarX से यह श्रेय जोड़ने को कहें।

अक्सर पूछे जाने वाले सवाल

क्या मैप दिखाने के लिए Google Maps ज़रूरी है?

नहीं। हर MonstarX ऐप बिना कुंजी के, मुफ़्त में मैप दिखा सकता है। Google Maps सिर्फ़ जगहों, ऑटोकम्प्लीट, बिज़नेस की जानकारी या रास्तों के लिए कनेक्ट करें।

Google क्यों कहता है कि API चालू नहीं है?

Google Maps की हर सेवा को आपके Google Cloud प्रोजेक्ट में अलग से चालू करना पड़ता है। त्रुटि में जिसका नाम है, उसे चालू करें, जैसे Places API (New)।

क्या कुंजी का ब्राउज़र में होना सुरक्षित है?

हाँ, जब उस पर सिर्फ़ उन्हीं API की पाबंदी हो जिन्हें आपका ऐप इस्तेमाल करता है। Google ने ये कुंजियाँ वेब पेजों में इस्तेमाल होने के लिए ही बनाई हैं।

Google Maps या Mapbox?

जगहों, बिज़नेस की जानकारी और रिव्यू के लिए Google Maps। कस्टम मैप स्टाइल और सैटेलाइट व्यू के लिए Mapbox। दोनों पतों को पिन में बदल सकते हैं और रास्ते दिखा सकते हैं।