CameraUpdateFactory

पब्लिक फ़ाइनल क्लास CameraUpdateFactory ऑब्जेक्ट
का विस्तार करता है

ऐसी क्लास जिसमें CameraUpdate ऑब्जेक्ट बनाने के तरीके शामिल हैं. ये ऑब्जेक्ट, मैप के कैमरे में बदलाव करते हैं. मैप का कैमरा बदलने के लिए, इस क्लास की मदद से बनाए गए CameraUpdate ऑब्जेक्ट का इस्तेमाल करके animateCamera(CameraUpdate), animateCamera(CameraUpdate, GoogleMap.CancelableCallback) या moveCamera(CameraUpdate) पर कॉल करें.

उदाहरण के लिए, किसी मैप पर ज़ूम इन करने के लिए, इस कोड का इस्तेमाल किया जा सकता है:

GoogleMap map = ...;
 map.animateCamera(CameraUpdateFactory.zoomIn());
 

इस क्लास की किसी भी वैल्यू का इस्तेमाल करने से पहले, आपको यह पक्का करने के लिए इनमें से कोई एक काम करना होगा: यह क्लास शुरू की गई है:

  • अपने आवेदन में जोड़े गए MapFragment या MapView से GoogleMap उपलब्ध होने का इंतज़ार करें. आपको GoogleMap मिल सकता है इंस्टेंस करने के लिए, getMapAsync() पर कॉल करें और onMapReady(GoogleMap map) कॉलबैक का इंतज़ार करें.
  • initialize(Context) पर कॉल करें. जब तक GooglePlayServicesNotAvailableException को फेंका नहीं जाता, तब तक यह क्लास सही तरीके से सेट होगी शुरू किया गया.

डेवलपर गाइड

ज़्यादा जानकारी के लिए, कैमरा और व्यू पढ़ें डेवलपर गाइड देखें.

सार्वजनिक तौर पर उपलब्ध तरीके के बारे में खास जानकारी

स्टैटिक CameraUpdate
newCameraPosition(CameraPosition CameraPosition)
CameraUpdate फ़ंक्शन को नतीजे के तौर पर दिखाता है, जो कैमरे को तय किए गए CameraPosition पर ले जाता है.
स्टैटिक CameraUpdate
newLatLng(LatLng latLng)
CameraUpdate देता है जो स्क्रीन के केंद्र को अक्षांश और देशांतर पर ले जाता है LatLng ऑब्जेक्ट ने तय किया.
स्टैटिक CameraUpdate
newLatLngBounds(LatLngBounds बाउंड, इंच चौड़ाई, int ऊंचाई, int पैडिंग)
एक CameraUpdate देता है जो कैमरे को इस तरह से बदल देता है कि तय किया गया अक्षांश/देशांतर की सीमाएं, स्क्रीन पर खास डाइमेंशन के बाउंडिंग बॉक्स के अंदर होती हैं पर ज़ूम करने की सुविधा चालू करें.
स्टैटिक CameraUpdate
newLatLngBounds(LatLngBounds बाउंड, int पैडिंग)
एक CameraUpdate देता है जो कैमरे को इस तरह से बदल देता है कि तय किया गया अक्षांश/देशांतर की सीमाएं स्क्रीन पर ज़्यादा से ज़्यादा ज़ूम लेवल पर केंद्रित होती हैं.
स्टैटिक CameraUpdate
newLatLngZoom(LatLng latLng, फ़्लोट ज़ूम)
CameraUpdate देता है जो स्क्रीन के केंद्र को अक्षांश और देशांतर पर ले जाता है LatLng ऑब्जेक्ट से तय किया जाता है और दिए गए ज़ूम लेवल पर जाता है.
स्टैटिक CameraUpdate
scrollBy(float xPixel, float yPixel)
एक CameraUpdate देता है जो कैमरे को मैप पर स्क्रोल करता है, जो कैमरे के केंद्र को शिफ़्ट होता है x और y दिशाओं में पिक्सल की दी गई संख्या के हिसाब से व्यू देखें.
स्टैटिक CameraUpdate
zoomBy(फ़्लोट रकम, पॉइंट फ़ोकस)
CameraUpdate फ़ंक्शन दिखाता है, जो कैमरे के मौजूदा व्यूपॉइंट के ज़ूम लेवल को बदलता है.
स्टैटिक CameraUpdate
zoomBy(फ़्लोट रकम)
CameraUpdate फ़ंक्शन दिखाता है, जो कैमरे के मौजूदा व्यूपॉइंट के ज़ूम लेवल को बदलता है.
स्टैटिक CameraUpdate
zoomIn()
व्यूपॉइंट की ऊंचाई को करीब ले जाकर, मैप पर ज़ूम इन करने वाला CameraUpdate दिखाता है पृथ्वी की सतह पर दिखाए जाते हैं.
स्टैटिक CameraUpdate
zoomOut()
दृश्य-बिंदु की ऊंचाई को स्थानांतरित करके मैप पर ज़ूम आउट करने वाला CameraUpdate देता है पृथ्वी की सतह से बहुत दूर ले जाते हैं.
स्टैटिक CameraUpdate
zoomTo(फ़्लोट ज़ूम)
CameraUpdate फ़ंक्शन दिखाता है, जो कैमरे के व्यूपॉइंट को किसी खास ज़ूम लेवल पर ले जाता है.

इनहेरिट किए गए तरीके की खास जानकारी

सार्वजनिक तरीके

सार्वजनिक स्टैटिक CameraUpdate newCameraPosition (CameraPosition CameraPosition)

CameraUpdate फ़ंक्शन को नतीजे के तौर पर दिखाता है, जो कैमरे को तय किए गए CameraPosition पर ले जाता है. तय सीमा में इफ़ेक्ट चुनने पर, यह CameraPosition ऑब्जेक्ट के अक्षांश से एक बदलाव बनाता है, देशांतर, ज़ूम लेवल, बियरिंग, और टिल्ट.

पैरामीटर
cameraPosition
रिटर्न
  • ट्रांसफ़ॉर्मेशन वाला CameraUpdate.

सार्वजनिक स्टैटिक CameraUpdate newLatLng (LatLng latLng)

CameraUpdate देता है जो स्क्रीन के केंद्र को अक्षांश और देशांतर पर ले जाता है LatLng ऑब्जेक्ट ने तय किया. इससे कैमरे को LatLng ऑब्जेक्ट पर फ़ोकस किया जाता है.

पैरामीटर
latLng LatLng ऑब्जेक्ट जिसमें मनचाहे अक्षांश और देशांतर शामिल हैं.
रिटर्न
  • ट्रांसफ़ॉर्मेशन वाला CameraUpdate.

सार्वजनिक स्टैटिक CameraUpdate newLatLngBounds (LatLngBounds बाउंड, पूर्णांक चौड़ाई, पूर्णांक की ऊंचाई, int पैडिंग)

एक CameraUpdate देता है जो कैमरे को इस तरह से बदल देता है कि तय किया गया अक्षांश/देशांतर की सीमाएं, स्क्रीन पर खास डाइमेंशन के बाउंडिंग बॉक्स के अंदर होती हैं पर ज़ूम करने की सुविधा चालू करें. इसे और सीमित करने के लिए, आपके पास अतिरिक्त पैडिंग (जगह) तय करने का विकल्प होता है बाउंडिंग बॉक्स का साइज़. लौटाए गए CameraUpdate के बेयरिंग 0 है और झुकाव 0 है 0 होना चाहिए.

newLatLngBounds(LatLngBounds, int) के उलट, आप CameraUpdate का इस्तेमाल कर सकते हैं इस तरीके से मैप के लेआउट फ़ेज़ से पहले कैमरा बदला जाता है, क्योंकि आर्ग्युमेंट, बाउंडिंग बॉक्स का मनचाहा साइज़ तय करते हैं.

पैरामीटर
सीमाएं बाउंडिंग बॉक्स में फ़िट होने वाला क्षेत्र
चौड़ाई बाउंडिंग बॉक्स की चौड़ाई पिक्सल में (पिक्सल)
ऊंचाई बाउंडिंग बॉक्स की ऊंचाई (पिक्सल में)
पैडिंग बाउंडिंग बॉक्स के साइज़ की अतिरिक्त पाबंदी (पिक्सल में)
रिटर्न
  • ट्रांसफ़ॉर्मेशन वाला CameraUpdate.

सार्वजनिक स्टैटिक CameraUpdate newLatLngBounds (LatLngBounds बाउंड, int पैडिंग)

एक CameraUpdate देता है जो कैमरे को इस तरह से बदल देता है कि तय किया गया अक्षांश/देशांतर की सीमाएं स्क्रीन पर ज़्यादा से ज़्यादा ज़ूम लेवल पर केंद्रित होती हैं. आप मैप व्यू के किनारों से बाउंडिंग बॉक्स को सेट करने के लिए, पैडिंग (जगह) तय करें. रिटर्न CameraUpdate के बेयरिंग 0 है और झुकाव 0 है.

कैमरे को इस अपडेट के साथ तब तक न बदलें, जब तक मैप का लेआउट इस विधि के लिए उचित बाउंडिंग बॉक्स और ज़ूम स्तर का सही ढंग से पता लगाने के लिए, मैप का आकार होना चाहिए). अगर ऐसा नहीं होता है, तो IllegalStateException को फेंक दिया जाएगा. नहीं मैप के उपलब्ध होने के लिए काफ़ी है; मैप वाले व्यू में भी ज़रूर होना चाहिए इस तरह बना सकते हैं कि इसके डाइमेंशन तय कर लिए जाएं. अगर आप पक्का नहीं कर पा रहे हैं कि इसके पास हो गया है, तो इसके बजाय newLatLngBounds(LatLngBounds, int, int, int) का इस्तेमाल करें और मैप के डाइमेंशन को मैन्युअल रूप से देख सकते हैं.

पैरामीटर
सीमाएं स्क्रीन पर फ़िट करने के लिए क्षेत्रफल
पैडिंग बाउंडिंग बॉक्स के किनारों और व्यू के किनारों के बीच छोड़ने के लिए स्पेस (पिक्सल में). यह वैल्यू को बाउंडिंग बॉक्स के सभी चारों तरफ़ लागू किया जाता है.
रिटर्न
  • ट्रांसफ़ॉर्मेशन वाला CameraUpdate.

सार्वजनिक स्टैटिक CameraUpdate newLatLngZoom (LatLng latLng, फ़्लोट ज़ूम)

CameraUpdate देता है जो स्क्रीन के केंद्र को अक्षांश और देशांतर पर ले जाता है LatLng ऑब्जेक्ट से तय किया जाता है और दिए गए ज़ूम लेवल पर जाता है.

पैरामीटर
latLng LatLng ऑब्जेक्ट जिसमें मनचाहे अक्षांश और देशांतर शामिल हैं.
ज़ूम ज़ूम करने का मनचाहा स्तर: 2.0 से 21.0 के बीच. इस सीमा से नीचे के मान ये हैं और इससे ऊपर की वैल्यू 21.0 पर सेट होती है. ज़ूम इन करने के लिए वैल्यू बढ़ाएं. ऐसा हो सकता है कि सभी पक्षों को क्षेत्रों में टाइल का अधिकतम ज़ूम स्तर होता है.
रिटर्न
  • ट्रांसफ़ॉर्मेशन वाला CameraUpdate.

सार्वजनिक स्टैटिक CameraUpdate scrollBy (फ़्लोट xPixel, फ़्लोट yPixel)

एक CameraUpdate देता है जो कैमरे को मैप पर स्क्रोल करता है, जो कैमरे के केंद्र को शिफ़्ट होता है x और y दिशाओं में पिक्सल की दी गई संख्या के हिसाब से व्यू देखें.

उदाहरण:

  • अगर xPixel = 5 और yPixel = 0 है, तो सिस्टम कैमरे को आगे की ओर स्क्रोल करके दाईं ओर स्क्रोल करता है, ताकि ऐसा लगता है कि मैप 5 पिक्सल बाईं ओर शिफ़्ट हो गया है.
  • अगर xPixel = 0 और yPixel = 5 है, तो सिस्टम कैमरे को नीचे की ओर स्क्रोल करके इस तरह नीचे की ओर स्क्रोल करता है कि ऐसा लगता है कि मैप 5 पिक्सल ऊपर की ओर शिफ़्ट हो गया है.

स्क्रोलिंग कैमरे के मौजूदा ओरिएंटेशन के हिसाब से होती है. उदाहरण के लिए, अगर कैमरा 90 डिग्री पर, फिर पूर्व की दिशा "ऊपर" है और दाईं ओर स्क्रोल करने से कैमरा दक्षिण की ओर जाएगा.

पैरामीटर
xPixel हॉरिज़ॉन्टल रूप से स्क्रोल करने के लिए पिक्सल की संख्या. पॉज़िटिव वैल्यू, कैमरे को दाईं ओर. नेगेटिव वैल्यू से कैमरा, बाईं ओर.
yPixel वर्टिकल तौर पर स्क्रोल करने के लिए पिक्सल की संख्या. पॉज़िटिव वैल्यू से कैमरा मूव करता है देखने के लिए, अपने मौजूदा ओरिएंटेशन के हिसाब से नीचे की ओर देखें. नेगेटिव वैल्यू से कैमरा मूव हो जाता है ऊपर दी गई है.
रिटर्न
  • ट्रांसफ़ॉर्मेशन वाला CameraUpdate.

सार्वजनिक स्टैटिक CameraUpdate zoomBy (फ़्लोट की मात्रा, पॉइंट फ़ोकस)

CameraUpdate फ़ंक्शन दिखाता है, जो कैमरे के मौजूदा व्यूपॉइंट के ज़ूम लेवल को बदलता है.

फ़ोकस के ज़रिए तय किया गया पॉइंट स्थिर रहेगा. इसका मतलब है कि यह एक ही अक्षांश/देशांतर से जुड़ा है ज़ूम प्रक्रिया से पहले और बाद में).

मौजूदा ज़ूम के मुकाबले यह तरीका zoomTo(float) से अलग है कैमरा.

उदाहरण के लिए, अगर LatLng (11.11, 22.22), फ़िलहाल स्क्रीन पर दी गई जगह पर है (23, 45). ज़ूम राशि और इस LatLng का इस्तेमाल करके इस तरीके को कॉल करने के बाद, स्क्रीन की जगह इतना LatLng अब भी (23, 45) होगा.

पैरामीटर
रकम मात्रा बदलें. पॉज़िटिव वैल्यू, कैमरे के पास ज़ूम करने का संकेत देती हैं पृथ्वी की सतह पर हैं, जबकि ऋणात्मक मान पृथ्वी की सतह से ज़ूम दूर होने का संकेत देते हैं Earth.
फ़ोकस स्क्रीन पर मौजूद पिक्सल की जगह की जानकारी दिखाता है, जो ज़ूमिंग प्रोसेस के बाद ठीक नहीं होती. कैमरे की जगह बदलने से पहले, उस पिक्सल की जगह के अक्षांश/देशांतर में कोई बदलाव नहीं होगा कैमरा मूव करने के बाद.
रिटर्न
  • ट्रांसफ़ॉर्मेशन वाला CameraUpdate.

सार्वजनिक स्टैटिक CameraUpdate zoomBy (फ़्लोट रकम)

CameraUpdate फ़ंक्शन दिखाता है, जो कैमरे के मौजूदा व्यूपॉइंट के ज़ूम लेवल को बदलता है.

मौजूदा ज़ूम के मुकाबले यह तरीका zoomTo(float) से अलग है कैमरा.

पैरामीटर
रकम मात्रा बदलें. पॉज़िटिव वैल्यू, कैमरे के पास ज़ूम करने का संकेत देती हैं पृथ्वी की सतह पर हैं, जबकि ऋणात्मक मान पृथ्वी की सतह से ज़ूम दूर होने का संकेत देते हैं Earth.
रिटर्न
  • ट्रांसफ़ॉर्मेशन वाला CameraUpdate.

सार्वजनिक स्टैटिक CameraUpdate zoomIn ()

व्यूपॉइंट की ऊंचाई को करीब ले जाकर, मैप पर ज़ूम इन करने वाला CameraUpdate दिखाता है पृथ्वी की सतह पर दिखाए जाते हैं. ज़ूम बढ़ाएं 1.0 है.

रिटर्न
  • ट्रांसफ़ॉर्मेशन वाला CameraUpdate.

सार्वजनिक स्टैटिक CameraUpdate zoomOut ()

दृश्य-बिंदु की ऊंचाई को स्थानांतरित करके मैप पर ज़ूम आउट करने वाला CameraUpdate देता है पृथ्वी की सतह से बहुत दूर ले जाते हैं. ज़ूम बढ़ाएं -1.0 है.

रिटर्न
  • ट्रांसफ़ॉर्मेशन वाला CameraUpdate.

सार्वजनिक स्टैटिक CameraUpdate zoomTo (फ़्लोट ज़ूम)

CameraUpdate फ़ंक्शन दिखाता है, जो कैमरे के व्यूपॉइंट को किसी खास ज़ूम लेवल पर ले जाता है.

पैरामीटर
ज़ूम ज़ूम करने का मनचाहा स्तर: 2.0 से 21.0 के बीच. इस सीमा से नीचे के मान ये हैं और इससे ऊपर की वैल्यू 21.0 पर सेट होती है. ज़ूम इन करने के लिए वैल्यू बढ़ाएं. ऐसा हो सकता है कि सभी पक्षों को क्षेत्रों में टाइल का अधिकतम ज़ूम स्तर होता है.