Android के लिए Maps SDK टूल का इस्तेमाल करके, आप पसंद के मुताबिक यह तय कर सकते हैं कि उपयोगकर्ता आपके मैप के साथ कैसे इंटरैक्ट करें. इसके लिए आप यह तय कर सकते हैं कि कौनसे बिल्ट-इन यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट मैप पर दिखेंगे और किन जेस्चर की अनुमति है.
कोड सैंपल
GitHub पर ApiDemos डेटा स्टोर करने की जगह में एक सैंपल शामिल है, जो कंट्रोल और हाथ के जेस्चर के विकल्पों का इस्तेमाल दिखाता है:
- UiSettingsDemoActivity: Java सैंपल
- UiSettingsDemoActivity: Kotlin सैंपल
कम से कम उपयोगकर्ता इंटरैक्शन के लिए लाइट मोड
अगर आपको कम से कम उपयोगकर्ता इंटरैक्शन के साथ लाइट-वेट मैप चाहिए, तो लाइट-लाइट मैप का इस्तेमाल करें. लाइट मोड एक खास जगह और ज़ूम लेवल पर मैप की बिट मैप इमेज दिखाता है. लाइट मोड में, उपयोगकर्ता मैप को पैन या ज़ूम नहीं कर सकते हैं और हाथ के जेस्चर काम नहीं करते हैं. ज़्यादा जानकारी के लिए, लाइट मोड की गाइड देखें.
यूज़र इंटरफ़ेस (यूआई) कंट्रोल
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 मोबाइल ऐप्लिकेशन में मैप व्यू या दिशा-निर्देश का अनुरोध करते हैं. जब कोई उपयोगकर्ता टूलबार पर किसी आइकॉन पर टैप करता है, तब एपीआई 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) को कॉल करके,
रोटेशन बंद किया जा सकता है.