Android के लिए Maps SDK का उपयोग करके, आप यह तय कर सकते हैं कि उपयोगकर्ता आपके मैप के साथ किस तरह से इंटरैक्ट कर सकते हैं. ऐसा आप कर सकते हैं कि मैप में कौनसे बिल्ट-इन यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट दिखाए जाते हैं और कौनसे जेस्चर इस्तेमाल किए जा सकते हैं.
कोड सैंपल
GitHub पर ApiDemos डेटा स्टोर करने की जगह में एक नमूना शामिल होता है, जिसमें कंट्रोल और हाथ के जेस्चर के विकल्पों को इस्तेमाल करने के बारे में बताया गया है:
- UiSettingsDemoActivity: Java सैंपल
- UiSettingsDemoActivity: Kotlin सैंपल
उपयोगकर्ता के कम से कम इंटरैक्शन के लिए लाइट मोड
अगर आपको कम उपयोगकर्ता इंटरैक्शन वाला लाइट-वेट मैप चाहिए, तो लाइट-मोड मैप का इस्तेमाल करें. लाइट मोड किसी खास जगह और ज़ूम के लेवल पर मैप की बिट मैप इमेज दिखाता है. लाइट मोड में, उपयोगकर्ता पैन या ज़ूम नहीं कर सकते हैं और जेस्चर काम नहीं करते हैं. ज़्यादा जानकारी के लिए, लाइट मोड गाइड पढ़ें.
यूज़र इंटरफ़ेस (यूआई) कंट्रोल
मैप एपीआई में पहले से मौजूद यूज़र इंटरफ़ेस (यूआई) कंट्रोल होते हैं, जो आपके Android फ़ोन पर Google Maps ऐप्लिकेशन में मिलते-जुलते होते हैं. UiSettings क्लास का इस्तेमाल करके इन कंट्रोल के दिखने की सेटिंग को टॉगल किया जा सकता है. यह क्लास, GoogleMap.getUiSettings से GoogleMap से मिल सकती है. इस श्रेणी में किए गए बदलाव मैप पर तुरंत दिखाई देने लगते हैं. इन सुविधाओं का उदाहरण देखने के लिए, नमूना ऐप्लिकेशन में यूज़र इंटरफ़ेस (यूआई) सेटिंग का डेमो देखें.
जब मैप को एक्सएमएल एट्रिब्यूट का इस्तेमाल करके या GoogleMapOptions क्लास का इस्तेमाल करके बनाया जाता है, तब भी इनमें से ज़्यादातर विकल्पों को कॉन्फ़िगर किया जा सकता है. ज़्यादा जानकारी के लिए, शुरुआती स्थिति कॉन्फ़िगर करना देखें.
मैप के किनारे से हर यूआई कंट्रोल की जगह पहले से तय होती है.
आप GoogleMap ऑब्जेक्ट में पैडिंग जोड़कर कंट्रोल को सबसे ऊपर, सबसे नीचे, बाएं या दाएं किनारे से दूर ले जा सकते हैं.
ज़ूम कंट्रोल
Maps API, कैमरे में पहले से मौजूद ज़ूम कंट्रोल की सुविधा देता है. यह कंट्रोल, मैप के निचले दाएं कोने में दिखता है. ये डिफ़ॉल्ट रूप से बंद होते हैं, लेकिन UiSettings.setZoomControlsEnabled(true) पर कॉल करके इसे चालू किया जा सकता है.
कंपास
Maps API, कंपास ग्राफ़िक देता है. यह कुछ खास स्थितियों में, मैप के सबसे ऊपर बाएं कोने में दिखता है. कंपास सिर्फ़ तब दिखता है
जब कैमरा सही तरीके से सेट किया गया हो. उदाहरण के लिए, यह सही नहीं है या इसका झुकाव शून्य नहीं है. जब उपयोगकर्ता कंपास पर क्लिक करता है, तो कैमरा उसे वापस वैसे ही दिखाता है जिस पर वह शून्य और डिफ़ॉल्ट ओरिएंटेशन (डिफ़ॉल्ट ओरिएंटेशन) को दिखाता है. इसके कुछ समय बाद कंपास गायब हो जाता है. कंपास UiSettings.setCompassEnabled(boolean) को कॉल करके पूरी तरह से बंद किया जा सकता है.
हालांकि, कंपास को हमेशा ज़बरदस्ती नहीं दिखाया जा सकता.
मेरी जगह की जानकारी वाला बटन
मेरा स्थान बटन स्क्रीन के ऊपरी दाएं कोने में केवल तब दिखाई देता है, जब मेरा स्थान परत सक्षम हो. ज़्यादा जानकारी के लिए, जगह की जानकारी का डेटा देखें.
लेवल पिकर
डिफ़ॉल्ट रूप से, जब कोई उपयोगकर्ता इनडोर मैप देख रहा होता है, तो स्क्रीन के बीच में दाईं ओर एक लेवल पिकर (फ़्लोर पिकर) दिखता है. जब दो या दो से ज़्यादा इनडोर मैप दिखाई देते हैं, तो लेवल पिकर उस इमारत पर लागू होगा जिस पर अभी फ़ोकस है. आम तौर पर, यह स्क्रीन के बीच में होता है. हर इमारत का एक डिफ़ॉल्ट लेवल होता है. पिकर को पहली बार दिखाए जाने पर, इसे चुना जाएगा. उपयोगकर्ता इसे पिकर से चुनकर कोई दूसरा लेवल चुन सकते हैं.
GoogleMap.getUiSettings().setIndoorLevelPickerEnabled(boolean) पर कॉल करके, लेवल पिकर का कंट्रोल बंद या चालू किया जा सकता है.
यह तब काम आता है, जब आप डिफ़ॉल्ट लेवल पिकर को अपने लेवल के पिकर से बदलना चाहते हैं.
मैप टूलबार
डिफ़ॉल्ट रूप से, टूलबार पर मैप के नीचे दाईं ओर एक टूलबार दिखाई देता है. टूलबार, उपयोगकर्ता को Google Maps मोबाइल ऐप्लिकेशन का क्विक ऐक्सेस देता है.
UiSettings.setMapToolbarEnabled(boolean) पर कॉल करके, टूलबार को चालू और बंद किया जा सकता है.
लाइट-मोड मैप में, टूलबार उपयोगकर्ता की कार्रवाइयों से अलग रहता है. पूरी तरह से इंटरैक्टिव मैप में, टूलबार तब स्लाइड करता है, जब उपयोगकर्ता किसी मार्कर पर टैप करता है. साथ ही, जब मार्कर फ़ोकस पर नहीं होता, तो वह वापस स्लाइड करता है.
टूलबार ऐसे आइकॉन दिखाता है जो Google Maps के मोबाइल ऐप्लिकेशन में मैप व्यू या निर्देश के अनुरोध को ऐक्सेस करने की सुविधा देते हैं. जब कोई उपयोगकर्ता टूलबार पर मौजूद किसी आइकॉन पर टैप करता है, तो एपीआई उस Google ऐक्टिविटी को Google Maps के मोबाइल ऐप्लिकेशन में लॉन्च करने के लिए एक इंटेंट बनाता है.
यह टूलबार, मैप के ऊपर दाईं ओर मौजूद स्क्रीनशॉट में दिखता है. मैप के कॉन्टेंट के आधार पर, मैप पर शून्य या एक या दोनों इंटेंट आइकॉन दिखेंगे, बशर्ते कि Google Maps मोबाइल ऐप्लिकेशन के नतीजे के इंटेंट सही हो.
मैप जेस्चर
Android के लिए Maps SDK टूल से बनाए गए मैप पर, हाथ के वही जेस्चर इस्तेमाल किए जा सकते हैं जो Google Maps ऐप्लिकेशन में काम करते हैं. हालांकि, ऐसा भी हो सकता है कि आप मैप की स्थिति बनाए रखने के लिए कुछ जेस्चर बंद करना चाहें. ज़ूम करने, पैन करने, झुकाने, और बियरिंग करने की सुविधा को प्रोग्राम के हिसाब से भी सेट किया जा सकता है. ज़्यादा जानकारी के लिए कैमरा और व्यू देखें. ध्यान दें कि हाथ के जेस्चर (हाव-भाव) बंद करने से, इस बात पर कोई असर नहीं पड़ता कि कैमरे की पोज़िशन में बदलाव किया जा सकता है या नहीं.
यूज़र इंटरफ़ेस (यूआई) कंट्रोल की तरह, UiSettings क्लास की मदद से जेस्चर को चालू/बंद किया जा सकता है. GoogleMap
को GoogleMap.getUiSettings कॉल करके हासिल किया जा सकता है. इस कक्षा में किए गए बदलाव, मैप पर तुरंत दिखने लगते हैं. इन सुविधाओं का उदाहरण देखने के लिए, सैंपल ऐप्लिकेशन में यूज़र इंटरफ़ेस (यूआई) सेटिंग का डेमो गतिविधि देखें (इसे इंस्टॉल करने का तरीका जानने के लिए यहां देखें).
इन विकल्पों को तब भी कॉन्फ़िगर किया जा सकता है, जब मैप को
एक्सएमएल एट्रिब्यूट की मदद से या GoogleMapOptions क्लास का इस्तेमाल करके बनाया गया हो.
ज़्यादा जानकारी के लिए मैप कॉन्फ़िगर करना देखें.
ज़ूम जेस्चर
मैप कई तरह के जेस्चर पर प्रतिक्रिया देता है, जिनसे कैमरे का ज़ूम लेवल बदल सकता है:
- ज़ूम स्तर को 1 (ज़ूम इन) करने के लिए दो बार टैप करें.
- ज़ूम लेवल को 1 (ज़ूम आउट) करने के लिए, दो उंगलियों से टैप करें.
- दो उंगलियों से पिंच करें
- एक उंगली से दो बार टैप करके ज़ूम इन किया जा सकता है, लेकिन दूसरे टैप पर नहीं छोड़ा जा सकता. इसके बाद, उंगली को ज़ूम आउट करने के लिए ऊपर स्लाइड करें या ज़ूम इन करने के लिए नीचे स्वाइप करें.
UiSettings.setZoomGesturesEnabled(boolean) पर कॉल करके ज़ूम जेस्चर बंद किए जा सकते हैं. इससे इस बात पर कोई असर नहीं पड़ेगा कि उपयोगकर्ता ज़ूम इन और आउट करने के लिए ज़ूम कंट्रोल का इस्तेमाल कर सकता है या नहीं.
स्क्रोल (पैन) जेस्चर
कोई उपयोगकर्ता, मैप को अपनी उंगली से खींचकर, मैप पर स्क्रोल (पैन) कर सकता है.
UiSettings.setScrollGesturesEnabled(boolean) पर कॉल करके, स्क्रोल करने की सुविधा बंद की जा सकती है.
झुकाव जेस्चर
उपयोगकर्ता मैप पर दो उंगलियों को रखकर और उसे नीचे या ऊपर एक साथ ले जाकर मैप को झुकाव कोण को बढ़ाने या घटाने के लिए झुका सकता है. UiSettings.setTiltGesturesEnabled(boolean) पर कॉल करके, हाथ के जेस्चर
बंद किए जा सकते हैं.
जेस्चर घुमाएं
मैप पर घूमने के लिए कोई भी व्यक्ति मैप पर दो उंगलियों का इस्तेमाल कर सकता है. UiSettings.setRotateGesturesEnabled(boolean)
को कॉल करके, रोटेशन बंद किया जा सकता है.