CameraUpdateFactory

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

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

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

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

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

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

डेवलपर गाइड

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

सार्वजनिक मेथड की खास जानकारी

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

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

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

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

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

पैरामीटर
कैमरा पोज़िशन
लौटाए गए आइटम

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

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

पैरामीटर
LatLng LatLng ऑब्जेक्ट, जिसमें मनचाहे अक्षांश और देशांतर हैं.
लौटाए गए आइटम

सार्वजनिक स्टैटिक CameraUpdate newLatLngBounds (LatLngBounds की सीमाएं, int चौड़ाई, int height, int padding)

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

newLatLngBounds(LatLngBounds, int) के उलट, आप मैप से पहले कैमरे को बदलने के लिए इस तरीके से लौटाया गया CameraUpdate इस्तेमाल करें.

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

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

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

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

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

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

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

पैरामीटर
LatLng LatLng ऑब्जेक्ट, जिसमें मनचाहे अक्षांश और देशांतर हैं.
zoom पसंदीदा ज़ूम लेवल, 2.0 से 21.0 के बीच होना चाहिए. इस रेंज से कम की वैल्यू 2.0 पर सेट की जाती हैं और इसके ऊपर की वैल्यू 21.0 पर सेट होती हैं. ज़ूम इन करने के लिए वैल्यू बढ़ाएं. सभी क्षेत्रों के सबसे बड़े ज़ूम लेवल पर टाइल नहीं होती हैं.
लौटाए गए आइटम

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

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

उदाहरण:

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

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

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

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

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

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

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

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

पैरामीटर
रकम ज़ूम लेवल बदलने के लिए रकम. पॉज़िटिव वैल्यू, पृथ्वी की सतह के करीब ज़ूम करने का संकेत देती हैं, जबकि नेगेटिव वैल्यू, धरती की सतह से ज़ूम आउट करने का संकेत देती हैं.
focus स्क्रीन पर पिक्सल की जगह जो ज़ूम करने की प्रक्रिया के बाद भी बनी रहेगी. कैमरे को मूव करने से पहले, उस जगह पर मौजूद अक्षांश/देशांतर में कोई बदलाव नहीं होता है.
लौटाए गए आइटम

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

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

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

पैरामीटर
रकम ज़ूम लेवल बदलने के लिए रकम. पॉज़िटिव वैल्यू, पृथ्वी की सतह के करीब ज़ूम करने का संकेत देती हैं, जबकि नेगेटिव वैल्यू, धरती की सतह से ज़ूम आउट करने का संकेत देती हैं.
लौटाए गए आइटम

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

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

लौटाए गए आइटम

सार्वजनिक स्टैटिक CameraUpdate ज़ूमआउट ()

CameraUpdate दिखाता है. यह व्यूपॉइंट, धरती की सतह से बहुत दूर ले जाता है और मैप पर ज़ूम आउट करता है. ज़ूम वृद्धि -1.0 है.

लौटाए गए आइटम

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

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

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