कैमरे के कंट्रोल कॉन्फ़िगर करना

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript

उपयोगकर्ता, मैप पर जेस्चर का इस्तेमाल करके कैमरे के ज़ूम, झुकाव, पोज़िशन, और रोटेशन को कंट्रोल कर सकते हैं. कैमरे को प्रोग्राम के हिसाब से भी कॉन्फ़िगर किया जा सकता है.

3D कैमरा मॉडल दिखाने वाला डायग्राम

कैमरे की स्थिति

मैप व्यू को 3D स्पेस में किसी खास पॉइंट को देखने वाले कैमरे के तौर पर मॉडल किया गया है. कैमरे की पोज़िशन और ओरिएंटेशन (इसलिए, मैप का रेंडरिंग) इन प्रॉपर्टी से तय होता है: केंद्र (कैमरे की ओर देखने वाली अक्षांश/देशांतर/ऊंचाई वाली जगह), हेडिंग, झुकाव, रेंज, और रोल.

बीच में (अक्षांश/देशांतर/ऊंचाई)

center, 3D स्पेस में उस खास पॉइंट की जानकारी देता है जिसे कैमरा देख रहा है. इसे LatLngAltitude क्लास का इस्तेमाल करके बताया जाता है, जो अक्षांश, देशांतर, और ऊंचाई की वैल्यू को जोड़ती है. इससे, कैमरे के फ़ोकल पॉइंट को तीन डाइमेंशन में सटीक ढंग से पोज़िशन किया जा सकता है.

अक्षांश -90 से 90 डिग्री के बीच हो सकता है. देशांतर -180 से 180 डिग्री के बीच होता है. ऊंचाई को समुद्र तल से ऊपर मीटर में बताया जाता है.

दिशा

कैमरे की हेडिंग से पता चलता है कि कैमरा किस दिशा में है. इसे उत्तर से घड़ी की दिशा में डिग्री में मेज़र किया जाता है. उत्तर 0 डिग्री, पूर्व 90 डिग्री, दक्षिण 180 डिग्री, और पश्चिम 270 डिग्री होता है. इससे सेंटर पॉइंट के वर्टिकल ऐक्सिस के आस-पास, कैमरे के ओरिएंटेशन का पता चलता है.

झुकाएं

टिल्ट से, वर्टिकल ऐक्सिस के हिसाब से कैमरे के ऐंगल के बारे में पता चलता है. इसे डिग्री में मेज़र किया जाता है. 0 डिग्री का झुकाव होने का मतलब है कि कैमरा सीधे नीचे की ओर, Earth (नादिर) की ओर है. 90 डिग्री के झुकाव का मतलब है कि कैमरा, हेडिंग में बताई गई दिशा में, हॉरिज़ॉन्टल तौर पर घुमाया गया है.

सीमा

रेंज से, कैमरे की पोज़िशन और सेंटर पॉइंट के बीच की दूरी का पता चलता है. इसकी रेंज शून्य से लेकर 630 लाख मीटर तक हो सकती है. इससे, बहुत करीब से लेकर पूरी दुनिया के नज़रिए तक के व्यू देखे जा सकते हैं. इससे यह कंट्रोल किया जाता है कि मैप "ज़ूम इन" या "ज़ूम आउट" कैसे दिखे.

घुमाएं

रोल, कैमरे के ऐंगल को हॉरिज़ॉन्ट के हिसाब से सेट करता है. इसे डिग्री में मेज़र किया जाता है. इस पैरामीटर का इस्तेमाल, फ़्लाइट सिम्युलेशन के दौरान बैंकिंग या फ़ुल बैरल रोल जैसे इफ़ेक्ट बनाने के लिए किया जा सकता है. इसके लिए, कैमरे को उसके व्यू ऐक्सिस के चारों ओर घुमाया जाता है.

कैमरे को कंट्रोल करना

यहां दिए गए कोड सैंपल में, setCamera तरीके को कॉल करके, कैमरे को प्रोग्राम के हिसाब से कंट्रोल करने का तरीका बताया गया है. इस कोड सैंपल का इस्तेमाल करने के लिए, सेटअप में दिए गए निर्देशों का पालन करें. साथ ही, अपने Android Studio प्रोजेक्ट को बुनियादी 3D मैप के साथ सेट अप करने के लिए, अपने ऐप्लिकेशन में 3D मैप जोड़ें. इसके बाद, MainActivity.kt फ़ाइल में यह कोड जोड़ें:

// Add imports
import com.google.android.gms.maps3d.model.latLngAltitude

...

// Add to the onMap3DViewReady method, after the googleMap3D object has been initialized
googleMap3D.setCamera(
    camera {
        center = latLngAltitude {
            latitude = 38.743502
            longitude = -109.499374
            altitude = 1467.0
        }
        heading = 350.0
        tilt = 58.1
        range = 138.2
        roll = 0.0
    }
)