ऐसी क्लास जिसमें CameraUpdate
ऑब्जेक्ट बनाने के तरीके शामिल हैं. ये ऑब्जेक्ट, मैप के कैमरे में बदलाव करते हैं.
मैप के कैमरे में बदलाव करने के लिए, इस क्लास से बनाए गए CameraUpdate
ऑब्जेक्ट का इस्तेमाल करके, animateCamera(CameraUpdate)
, animateCamera(CameraUpdate, GoogleMap.CancelableCallback)
या moveCamera(CameraUpdate)
को कॉल करें.
उदाहरण के लिए, मैप पर ज़ूम इन करने के लिए, इस कोड का इस्तेमाल किया जा सकता है:
GoogleMap map = ...;
map.animateCamera(CameraUpdateFactory.zoomIn());
इस क्लास के किसी तरीके का इस्तेमाल करने से पहले, आपको इनमें से कोई एक काम करना होगा, ताकि यह पक्का हो सके कि यह क्लास शुरू हो चुकी है:
- ऐप्लिकेशन में जोड़े गए
MapFragment
याMapView
में,GoogleMap
मिलने तक इंतज़ार करें.getMapAsync()
को कॉल करके औरonMapReady(GoogleMap map)
कॉलबैक का इंतज़ार करके,GoogleMap
इंस्टेंस पाया जा सकता है. initialize(Context)
पर कॉल करें. जब तकGooglePlayServicesNotAvailableException
को थ्रो नहीं किया जाता, तब तक यह क्लास सही तरीके से शुरू हो जाएगी.
डेवलपर गाइड
ज़्यादा जानकारी के लिए, कैमरा और व्यू से जुड़ी डेवलपर गाइड पढ़ें.
सार्वजनिक तरीके से जुड़ी खास जानकारी
स्टैटिक CameraUpdate |
newCameraPosition(CameraPosition CamPosition)
ऐसा
CameraUpdate देता है जो कैमरे को तय CameraPosition पर ले जाता है. |
स्टैटिक CameraUpdate |
newLatLng(LatLng latLng)
ऐसा
CameraUpdate देता है जो स्क्रीन के बीच वाले हिस्से को LatLng ऑब्जेक्ट के बताए गए अक्षांश और देशांतर पर ले जाता है. |
स्टैटिक CameraUpdate |
newLatLngBounds(LatLngBounds बाउंड, int चौड़ाई, int length, int पैडिंग)
ऐसा
CameraUpdate दिखाता है जो कैमरे को इस तरह बदलता है कि स्क्रीन पर दिए गए अक्षांश/देशांतर की सीमा, तय किए गए डाइमेंशन के बाउंडिंग बॉक्स में सबसे ज़्यादा ज़ूम लेवल पर दिखाई दे. |
स्टैटिक CameraUpdate |
newLatLngBounds(LatLngBounds बाउंड, int पैडिंग)
यह
CameraUpdate दिखाता है, जो कैमरे का फ़ॉर्मैट इस तरह बदलता है
कि स्क्रीन पर तय किए गए अक्षांश/देशांतर की सीमाएं, ज़ूम के सबसे बड़े लेवल पर होती हैं. |
स्टैटिक CameraUpdate |
newLatLngZoom(LatLng latLng, फ़्लोट ज़ूम)
ऐसा
CameraUpdate दिखाता है जो स्क्रीन के बीच वाले हिस्से को उस अक्षांश और देशांतर पर ले जाता है जिसे LatLng ऑब्जेक्ट ने तय किया है. साथ ही, यह स्क्रीन के दिए गए ज़ूम लेवल पर ले जाता है. |
स्टैटिक CameraUpdate |
scrollBy(फ़्लोट xPixel, फ़्लोट yPixel)
ऐसा
CameraUpdate दिखाता है जो कैमरे को मैप पर स्क्रोल करता है. इस तरीके से व्यू के बीच के हिस्से को x और y की दिशा में पिक्सल की तय संख्या के हिसाब से शिफ़्ट किया जाता है. |
स्टैटिक CameraUpdate |
zoomBy(फ़्लोट मात्रा, पॉइंट फ़ोकस)
ऐसा
CameraUpdate दिखाता है जो कैमरे के मौजूदा व्यू पॉइंट के ज़ूम लेवल को शिफ़्ट करता है. |
स्टैटिक CameraUpdate |
zoomBy(फ़्लोट अ मात्रा)
ऐसा
CameraUpdate दिखाता है जो कैमरे के मौजूदा व्यू पॉइंट के ज़ूम लेवल को शिफ़्ट करता है. |
स्टैटिक CameraUpdate |
zoomIn()
व्यू पॉइंट की ऊंचाई को पृथ्वी की सतह के पास ले जाकर, मैप पर ज़ूम इन करने वाला
CameraUpdate दिखाता है. |
स्टैटिक CameraUpdate |
zoomOut()
व्यू पॉइंट की ऊंचाई को पृथ्वी की सतह से दूर ले जाकर, मैप पर ज़ूम आउट करने वाला
CameraUpdate दिखाता है. |
स्टैटिक CameraUpdate |
zoomTo(फ़्लोट ज़ूम)
यह
CameraUpdate दिखाता है, जो कैमरे के व्यूपॉइंट को एक खास ज़ूम लेवल पर ले जाता है. |
इनहेरिट किए गए तरीके की खास जानकारी
सार्वजनिक तरीके
सार्वजनिक स्टैटिक CameraUpdate newCameraPosition (CameraPosition कैमरे की पोज़िशन)
ऐसा CameraUpdate
देता है जो कैमरे को तय CameraPosition
पर ले जाता है. इससे,
यह CameraPosition
ऑब्जेक्ट के अक्षांश, देशांतर, ज़ूम लेवल, बियरिंग, और टिल्ट के आधार पर ट्रांसफ़ॉर्मेशन ऐक्शन बनाता है.
पैरामीटर
cameraPosition |
---|
रिटर्न
- ट्रांसफ़ॉर्मेशन वाला
CameraUpdate
.
सार्वजनिक स्टैटिक CameraUpdate newLatLng (LatLng latLng)
ऐसा CameraUpdate
देता है जो स्क्रीन के बीच वाले हिस्से को LatLng
ऑब्जेक्ट के बताए गए अक्षांश और देशांतर पर ले जाता है. ऐसा करने से, कैमरे को LatLng
ऑब्जेक्ट पर सेंटर कर दिया जाता है.
पैरामीटर
latLng | LatLng ऑब्जेक्ट, जिसमें मनचाहे अक्षांश और देशांतर होते हैं. |
---|
रिटर्न
- ट्रांसफ़ॉर्मेशन वाला
CameraUpdate
.
सार्वजनिक स्टैटिक CameraUpdate newLatLngBounds (LatLngBounds बाउंड, int चौड़ाई, int length, int पैड)
ऐसा CameraUpdate
दिखाता है जो कैमरे को इस तरह बदलता है कि स्क्रीन पर दिए गए अक्षांश/देशांतर की सीमा, तय किए गए डाइमेंशन के बाउंडिंग बॉक्स में सबसे ज़्यादा ज़ूम लेवल पर दिखाई दे. बाउंडिंग बॉक्स के साइज़ को सीमित करने के लिए, अतिरिक्त पैडिंग (जगह) तय की जा सकती है. दिए गए CameraUpdate
का झुकाव 0 और झुकाव 0 है.
newLatLngBounds(LatLngBounds, int)
के उलट, मैप के लेआउट फ़ेज़ से पहले, कैमरे को बदलने के लिए इस तरीके से लौटाए गए CameraUpdate
का इस्तेमाल किया जा सकता है. ऐसा इसलिए, क्योंकि तर्क
बाउंडिंग बॉक्स का मनपसंद साइज़ तय करते हैं.
पैरामीटर
सीमा | बाउंडिंग बॉक्स में फ़िट होने वाला क्षेत्र |
---|---|
width | पिक्सल में बाउंडिंग बॉक्स की चौड़ाई (पिक्सल) |
ऊंचाई | पिक्सल में बाउंडिंग बॉक्स की ऊंचाई (पिक्सल) |
padding | बाउंडिंग बॉक्स के साइज़ की अतिरिक्त पाबंदी (पिक्सल में) |
रिटर्न
- ट्रांसफ़ॉर्मेशन वाला
CameraUpdate
.
सार्वजनिक स्टैटिक CameraUpdate newLatLngBounds (LatLngBounds बाउंड, int पैड)
यह CameraUpdate
दिखाता है, जो कैमरे का फ़ॉर्मैट इस तरह बदलता है
कि स्क्रीन पर तय किए गए अक्षांश/देशांतर की सीमाएं, ज़ूम के सबसे बड़े लेवल पर होती हैं. मैप व्यू के किनारों से बाउंडिंग बॉक्स को इनसेट करने के लिए, पैडिंग (जगह) तय की जा सकती है. दिखाए गए
CameraUpdate
का झुकाव 0 और झुकाव 0 है.
इस अपडेट के बाद कैमरा तब तक न बदलें, जब तक मैप का लेआउट न बन जाए (इस तरीके से बाउंडिंग बॉक्स और ज़ूम के लेवल को सही तरीके से तय करने के लिए, मैप का साइज़ होना ज़रूरी है). ऐसा न करने पर, IllegalStateException
फेंक दिया जाएगा. मैप उपलब्ध होने के लिए
यह काफ़ी नहीं है; मैप वाले व्यू को भी
इस तरह का लेआउट बनाना होगा जिससे इसके डाइमेंशन तय किए गए हों. अगर आपको पक्के तौर पर पता नहीं है कि
ऐसा हुआ है, तो newLatLngBounds(LatLngBounds, int, int, int)
का इस्तेमाल करें और मैप के
डाइमेंशन को मैन्युअल तरीके से दें.
पैरामीटर
सीमा | स्क्रीन पर फ़िट करने के लिए क्षेत्र |
---|---|
padding | बाउंडिंग बॉक्स के किनारों और व्यू के किनारों के बीच खाली जगह (पिक्सल में) रखें. यह वैल्यू, बाउंडिंग बॉक्स के चारों तरफ़ लागू होती है. |
रिटर्न
- ट्रांसफ़ॉर्मेशन वाला
CameraUpdate
.
सार्वजनिक स्टैटिक CameraUpdate newLatLngZoom (LatLng latLng, फ़्लोट ज़ूम)
ऐसा CameraUpdate
दिखाता है जो स्क्रीन के बीच वाले हिस्से को उस अक्षांश और देशांतर पर ले जाता है जिसे LatLng
ऑब्जेक्ट ने तय किया है. साथ ही, यह स्क्रीन के दिए गए ज़ूम लेवल पर ले जाता है.
पैरामीटर
latLng | LatLng ऑब्जेक्ट, जिसमें मनचाहे अक्षांश और देशांतर होते हैं. |
---|---|
ज़ूम | अपनी पसंद का ज़ूम लेवल 2.0 से 21.0 की रेंज में रखें. इस रेंज से नीचे की वैल्यू 2.0 पर और इससे ऊपर की वैल्यू 21.0 पर सेट हैं. ज़ूम इन करने के लिए वैल्यू बढ़ाएं. सभी इलाकों में सबसे ज़्यादा ज़ूम लेवल वाली टाइल नहीं हैं. |
रिटर्न
- ट्रांसफ़ॉर्मेशन वाला
CameraUpdate
.
सार्वजनिक CameraUpdate scrollBy (फ़्लोट xPixel, फ़्लोट yPixel)
ऐसा CameraUpdate
दिखाता है जो कैमरे को मैप पर स्क्रोल करता है. इस तरीके से व्यू के बीच के हिस्से को x और y की दिशा में पिक्सल की तय संख्या के हिसाब से शिफ़्ट किया जाता है.
उदाहरण:
- अगर xPixel = 5 और yPixel = 0 हो, तो सिस्टम कैमरे को मूव करके दाईं ओर स्क्रोल करता है. इससे, ऐसा लगता है कि मैप 5 पिक्सल बाईं ओर शिफ़्ट हो गया है.
- अगर xPixel = 0 और yPixel = 5 हैं, तो सिस्टम कैमरे को इधर-उधर स्क्रोल करके नीचे की ओर स्क्रोल करता है. इससे ऐसा लगता है कि मैप पांच पिक्सल ऊपर की ओर शिफ़्ट हो गया है.
स्क्रोलिंग, कैमरे के मौजूदा ओरिएंटेशन के हिसाब से है. उदाहरण के लिए, अगर कैमरा 90 डिग्री पर है, तो पूर्व "ऊपर" होगा और दाईं ओर स्क्रोल करने से कैमरे दक्षिण की ओर बढ़ जाएगा.
पैरामीटर
xPixel | हॉरिज़ॉन्टल रूप से स्क्रोल करने के लिए पिक्सल की संख्या. पॉज़िटिव वैल्यू, कैमरे के मौजूदा ओरिएंटेशन के हिसाब से कैमरे को दाईं ओर ले जाती है. नेगेटिव वैल्यू, कैमरे के मौजूदा ओरिएंटेशन के हिसाब से कैमरे को बाईं ओर ले जाती है. |
---|---|
yPixel | वर्टिकल स्क्रोल करने के लिए पिक्सल की संख्या. पॉज़िटिव वैल्यू, कैमरे को उसके मौजूदा ओरिएंटेशन के हिसाब से नीचे की ओर ले जाती है. नेगेटिव वैल्यू, कैमरे के मौजूदा ओरिएंटेशन के हिसाब से कैमरे को ऊपर की ओर ले जाती है. |
रिटर्न
- ट्रांसफ़ॉर्मेशन वाला
CameraUpdate
.
सार्वजनिक स्टैटिक CameraUpdate zoomBy (फ़्लोट संख्या, पॉइंट फ़ोकस)
ऐसा CameraUpdate
दिखाता है जो कैमरे के मौजूदा व्यू पॉइंट के ज़ूम लेवल को शिफ़्ट करता है.
फ़ोकस के ज़रिए तय किया गया बिंदु स्थिर रहेगा (यानी, यह ज़ूम की प्रोसेस के पहले और बाद में एक ही अक्षांश/देशांतर से मेल खाता है).
यह तरीका zoomTo(float)
से अलग है, क्योंकि ज़ूम मौजूदा कैमरे के मुकाबले
है.
उदाहरण के लिए, अगर LatLng
(11.11, 22.22) फ़िलहाल स्क्रीन की जगह (23,
45) पर है. ज़ूम किए गए इस तरीके और इस LatLng
को कॉल करने के बाद भी, इस LatLng
की स्क्रीन की जगह (23, 45) ही रहेगी.
पैरामीटर
रकम | राशि सेट करें. पॉज़िटिव वैल्यू से यह पता चलता है कि लोग पृथ्वी की सतह के ज़्यादा करीब हैं. वहीं, नेगेटिव वैल्यू का मतलब है कि लोग कैमरे को पृथ्वी की सतह से ज़्यादा ज़ूम कर रहे हैं. |
---|---|
focus | स्क्रीन पर पिक्सल की जगह तय की जा सकती है, जो ज़ूम करने की प्रोसेस के बाद स्थिर रहती है. कैमरे को मूव करने से पहले, उस पिक्सल की जगह पर जो अक्षांश/देशांतर होता था वह कैमरा मूव होने के बाद भी पहले जैसा ही रहेगा. |
रिटर्न
- ट्रांसफ़ॉर्मेशन वाला
CameraUpdate
.
सार्वजनिक स्टैटिक CameraUpdate zoomBy (फ़्लोट संख्या)
ऐसा CameraUpdate
दिखाता है जो कैमरे के मौजूदा व्यू पॉइंट के ज़ूम लेवल को शिफ़्ट करता है.
यह तरीका zoomTo(float)
से अलग है, क्योंकि ज़ूम मौजूदा कैमरे के मुकाबले
है.
पैरामीटर
रकम | राशि सेट करें. पॉज़िटिव वैल्यू से यह पता चलता है कि लोग पृथ्वी की सतह के ज़्यादा करीब हैं. वहीं, नेगेटिव वैल्यू का मतलब है कि लोग कैमरे को पृथ्वी की सतह से ज़्यादा ज़ूम कर रहे हैं. |
---|
रिटर्न
- ट्रांसफ़ॉर्मेशन वाला
CameraUpdate
.
सार्वजनिक स्टैटिक CameraUpdate zoomIn ()
व्यू पॉइंट की ऊंचाई को पृथ्वी की सतह के पास ले जाकर, मैप पर ज़ूम इन करने वाला CameraUpdate
दिखाता है. ज़ूम इंक्रीमेंट 1.0 है.
रिटर्न
- ट्रांसफ़ॉर्मेशन वाला
CameraUpdate
.
सार्वजनिक स्टैटिक CameraUpdate zoomOut ()
व्यू पॉइंट की ऊंचाई को पृथ्वी की सतह से दूर ले जाकर, मैप पर ज़ूम आउट करने वाला CameraUpdate
दिखाता है. ज़ूम की बढ़ोतरी -1.0 है.
रिटर्न
- ट्रांसफ़ॉर्मेशन वाला
CameraUpdate
.
सार्वजनिक स्टैटिक CameraUpdate zoomTo (फ़्लोट ज़ूम)
यह CameraUpdate
दिखाता है, जो कैमरे के व्यूपॉइंट को एक खास ज़ूम लेवल पर ले जाता है.
पैरामीटर
ज़ूम | अपनी पसंद का ज़ूम लेवल 2.0 से 21.0 की रेंज में रखें. इस रेंज से नीचे की वैल्यू 2.0 पर और इससे ऊपर की वैल्यू 21.0 पर सेट हैं. ज़ूम इन करने के लिए वैल्यू बढ़ाएं. सभी इलाकों में सबसे ज़्यादा ज़ूम लेवल वाली टाइल नहीं हैं. |
---|