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