सर्कल

पब्लिक फ़ाइनल क्लास Circle ऑब्जेक्ट
में शामिल है

पृथ्वी की सतह पर बना एक गोल आकार.

सर्कल में नीचे दिए गए गुण होते हैं.

सेंटर
सर्कल का केंद्र LatLng के रूप में तय किया गया है.
दायरा
सर्कल का दायरा, मीटर में बताया गया है. यह संख्या शून्य या इससे ज़्यादा होनी चाहिए.
स्ट्रोक की चौड़ाई
स्क्रीन पिक्सल में सर्कल की आउटलाइन की चौड़ाई. चौड़ाई, कैमरे के ज़ूम लेवल पर स्थिर और स्वतंत्र है. डिफ़ॉल्ट वैल्यू 10 है.
स्ट्रोक रंग
एआरजीबी फ़ॉर्मैट में सर्कल आउटलाइन का रंग, वही फ़ॉर्मैट जिसे Color इस्तेमाल करते हैं. डिफ़ॉल्ट वैल्यू ब्लैक (0xff000000) है.
स्ट्रोक पैटर्न
ठोस (डिफ़ॉल्ट, जिसे null से दिखाया जाता है) या PatternItem ऑब्जेक्ट का क्रम, जिसे सर्कल की आउटलाइन में दोहराया जाना है. PatternItem टाइप उपलब्ध हैं: Gap (इसके लिए, पिक्सल में गैप की लंबाई से तय किया गया), Dash (इसमें स्ट्रोक की चौड़ाई और डैश की लंबाई पिक्सल में तय की जाती है) और Dot (सर्कुलर, सर्कल की आउटलाइन के बीच में, व्यास को पिक्सल में स्ट्रोक की चौड़ाई के हिसाब से तय किया जाता है).
रंग भरें
सर्कल का रंग ARGB फ़ॉर्मैट में भरा जाता है. यह वही फ़ॉर्मैट है जिसका इस्तेमाल Color करती हैं. डिफ़ॉल्ट वैल्यू पारदर्शी है (0x00000000).
Z-इंडेक्स
वह क्रम जिसमें यह टाइल ओवरले दूसरे ओवरले के हिसाब से बनाया जाता है (इसमें GroundOverlay, TileOverlay, Polyline, और Polygon शामिल हैं, लेकिन Marker नहीं). बड़े z-इंडेक्स वाला एक ओवरले, छोटे z इंडेक्स वाले ओवरले पर बनाया जाता है. एक ही z-इंडेक्स के साथ ओवरले का क्रम मनचाहे तरीके से नहीं होता है. डिफ़ॉल्ट zIndex 0 है.
किसको दिखे
यह बताता है कि सर्कल दिख रहा है या नहीं. इसका मतलब है कि सर्कल को मैप पर बनाया गया है या नहीं. एक न दिखने वाला सर्कल बनाया नहीं जाता, लेकिन उसकी अन्य सभी प्रॉपर्टी को बनाए रखता है. डिफ़ॉल्ट तौर पर, यह true पर सेट होता है. इसका मतलब है कि यह सभी स्क्रीन पर दिखता है.
टैग करें
सर्कल से जुड़ा Object. उदाहरण के लिए, Object में ऐसा डेटा हो सकता है जिससे पता चलता है कि सर्कल किस बारे में है. यह एक अलग Map<Circle, Object> को स्टोर करने से ज़्यादा आसान है. दूसरे उदाहरण के तौर पर, किसी डेटा सेट के आईडी से जुड़ा String आईडी जोड़ा जा सकता है. Android के लिए Google Maps SDK टूल, इस प्रॉपर्टी को न तो पढ़ता है और न ही लिखता है.

इस क्लास के तरीके, Android यूज़र इंटरफ़ेस (यूआई) थ्रेड पर ही इस्तेमाल किए जाने चाहिए. अगर ऐसा नहीं है, तो रनटाइम के दौरान IllegalStateException को थ्रो किया जाएगा.

उदाहरण

GoogleMap map;
 // ... get a map.
 // Add a circle in Sydney
 Circle circle = map.addCircle(new CircleOptions()
     .center(new LatLng(-33.87365, 151.20689))
     .radius(10000)
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));

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

डेवलपर गाइड

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

सार्वजनिक तरीके से जुड़ी खास जानकारी

LatLng
getCenter()
सेंटर को LatLng के तौर पर दिखाता है.
int
getFillColor()
इस सर्कल का फ़िल कलर दिखाता है.
String
getId()
इस मंडली का आईडी पाता है.
दोगुनी
getRadius()
सर्कल की रेडियस को मीटर में दिखाता है.
int
getStrokeColor()
स्ट्रोक का रंग दिखाता है.
List<PatternItem>
getStrokePattern()
इस मंडली की आउटलाइन का स्ट्रोक पैटर्न देता है.
float
getStrokeWidth()
स्ट्रोक की चौड़ाई दिखाता है.
ऑब्जेक्ट
getTag()
मंडली के लिए टैग पाता है.
float
getZIndex()
zIndex दिखाता है.
boolean
isClickable()
सर्कल पर क्लिक करने की सुविधा देता है.
boolean
isVisible()
जांच करता है कि मंडली दिखाई दे रही है या नहीं.
void
हटाएं()
इस सर्कल को मैप से हटाता है.
void
setCenter(LatLng सेंटर)
LatLng का इस्तेमाल करके सेंटर सेट करता है.
void
setClickable(बूलियन क्लिक करने लायक)
सर्कल पर क्लिक करने की योग्यता सेट करता है.
void
setFillColor(इंट कलर)
फ़िल कलर सेट करता है.
void
setRadius(डबल रेडियस)
दायरे को मीटर में सेट करता है.
void
setStrokeColor(इंट कलर)
स्ट्रोक का रंग सेट करता है.
void
setStrokePattern(List<PatternItem> पैटर्न)
सर्कल की आउटलाइन का स्ट्रोक पैटर्न सेट करता है.
void
setStrokeWidth(फ़्लोट की चौड़ाई)
स्ट्रोक की चौड़ाई सेट करता है.
void
setTag(ऑब्जेक्ट टैग)
सर्कल के लिए टैग सेट करता है.
void
setVisible(बूलियन विज़ुअल)
मंडली की दृश्यता सेट करता है.
void
setZIndex(फ़्लोट zIndex)
zIndex सेट करता है.

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

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

सार्वजनिक LatLng getCenter ()

सेंटर को LatLng के तौर पर दिखाता है.

रिटर्न
  • LatLng के तौर पर भौगोलिक केंद्र.

Public int getFillColor ()

इस सर्कल का फ़िल कलर दिखाता है.

रिटर्न
  • सर्कल का फ़िल कलर एआरजीबी फ़ॉर्मैट में होना चाहिए.

सार्वजनिक स्ट्रिंग getId ()

इस मंडली का आईडी पाता है. यह आईडी, मैप पर सभी सर्कल के लिए खास होगी.

पब्लिक डबल getRadius ()

सर्कल की रेडियस को मीटर में दिखाता है.

रिटर्न
  • मीटर में दायरा.

Public int getStrokeColor ()

स्ट्रोक का रंग दिखाता है.

रिटर्न
  • ARGB फ़ॉर्मैट में सर्कल का रंग.

सार्वजनिक सूची<PatternItem> getStrokePattern ()

इस मंडली की आउटलाइन का स्ट्रोक पैटर्न देता है.

रिटर्न
  • स्ट्रोक पैटर्न.

सार्वजनिक फ़्लोट getStrokeWidth ()

स्ट्रोक की चौड़ाई दिखाता है.

रिटर्न
  • स्क्रीन पिक्सल में चौड़ाई.

सार्वजनिक ऑब्जेक्ट getTag ()

मंडली के लिए टैग पाता है.

रिटर्न
  • अगर किसी टैग को setTag के साथ सेट किया गया था, तो टैग. अगर कोई टैग सेट नहीं किया गया है, तो null.

सार्वजनिक फ़्लोट getZIndex ()

zIndex दिखाता है.

रिटर्न
  • इस सर्कल का zIndex.

सार्वजनिक बूलियन isClickable ()

सर्कल पर क्लिक करने की सुविधा देता है. अगर सर्कल पर क्लिक किया जा सकता है, तो सर्कल पर क्लिक करने पर आपके ऐप्लिकेशन को GoogleMap.OnCircleClickListener पर सूचनाएं मिलेंगी. इवेंट लिसनर का रजिस्ट्रेशन setOnCircleClickListener(GoogleMap.OnCircleClickListener) तक किया गया है.

रिटर्न
  • अगर सर्कल पर क्लिक किया जा सकता है, तो true. अगर सर्कल क्लिक नहीं किया जा सकता, तो false.

सार्वजनिक बूलियन isVisible ()

जांच करता है कि मंडली दिखाई दे रही है या नहीं.

रिटर्न
  • अगर सर्कल दिख रहा है, तो true और अगर वह नहीं दिख रही है, तो false.

Public void हटाएं ()

इस सर्कल को मैप से हटाता है. सर्कल को हटाने के बाद, उसके सभी तरीकों का व्यवहार तय नहीं होता.

Public void setCenter (LatLng सेंटर)

LatLng का इस्तेमाल करके सेंटर सेट करता है.

केंद्र शून्य नहीं होना चाहिए, क्योंकि कोई डिफ़ॉल्ट वैल्यू नहीं है.

पैरामीटर
बीच में सर्कल का भौगोलिक केंद्र, जिसे LatLng के तौर पर दिखाया जाता है.
थ्रो
NullPointerException अगर केंद्र शून्य है

Public void setClickable (बूलियन क्लिक किया जा सकने वाला)

सर्कल पर क्लिक करने की योग्यता सेट करता है. अगर सर्कल पर क्लिक किया जा सकता है, तो सर्कल पर क्लिक करने पर आपके ऐप्लिकेशन को GoogleMap.OnCircleClickListener पर सूचनाएं मिलेंगी. इवेंट लिसनर का रजिस्ट्रेशन setOnCircleClickListener(GoogleMap.OnCircleClickListener) तक किया गया है.

पैरामीटर
क्लिक करने योग्य सर्कल के लिए, क्लिक करने की नई सेटिंग.

Public void setFillColor (int color)

फ़िल कलर सेट करता है.

फ़िल कलर, सर्कल के अंदर का रंग होता है. यह रंग, Color के बताए गए पूर्णांक फ़ॉर्मैट में होता है. अगर TRANSPARENT का इस्तेमाल किया जाता है, तो कोई फ़िल नहीं बनाया जाता.

पैरामीटर
रंग Color फ़ॉर्मैट में रंग.

सार्वजनिक शून्य setRadius (दोगुना रेडियस)

दायरे को मीटर में सेट करता है.

दायरा शून्य या उससे ज़्यादा होना चाहिए.

पैरामीटर
दायरा मीटर में दायरा.
थ्रो
IllegalArgumentException अगर त्रिज्या ऋणात्मक हो

Public void setStrokeColor (int color)

स्ट्रोक का रंग सेट करता है.

स्ट्रोक रंग इस सर्कल की आउटलाइन का रंग है, जो Color के बताए गए पूर्णांक फ़ॉर्मैट में होता है. अगर TRANSPARENT का इस्तेमाल किया जाता है, तो कोई आउटलाइन नहीं बनाई जाती.

पैरामीटर
रंग Color फ़ॉर्मैट में स्ट्रोक का रंग.

Public void setStrokePattern (List<PatternItem> पैटर्न)

सर्कल की आउटलाइन का स्ट्रोक पैटर्न सेट करता है. डिफ़ॉल्ट स्ट्रोक पैटर्न सॉलिड होता है, जिसे null से दिखाया जाता है.

पैरामीटर
पैटर्न स्ट्रोक पैटर्न.

Public void setStrokeWidth (फ़्लोट की चौड़ाई)

स्ट्रोक की चौड़ाई सेट करता है.

स्ट्रोक की चौड़ाई, सर्कल की आउटलाइन की चौड़ाई (स्क्रीन पिक्सल में) होती है. यह संख्या शून्य या इससे ज़्यादा होनी चाहिए. अगर यह शून्य है, तो कोई आउटलाइन नहीं बनाई जाती. डिफ़ॉल्ट वैल्यू 10 है.

पैरामीटर
width स्क्रीन पिक्सल में, स्ट्रोक की चौड़ाई.
थ्रो
IllegalArgumentException अगर चौड़ाई ऋणात्मक है

Public void setTag (ऑब्जेक्ट टैग)

सर्कल के लिए टैग सेट करता है.

इस प्रॉपर्टी का इस्तेमाल करके, इस सर्कल के साथ किसी आर्बिट्रेरी Object को असोसिएट किया जा सकता है. उदाहरण के लिए, Object में यह डेटा शामिल हो सकता है कि सर्कल क्या दिखाता है. यह एक अलग Map<Circle, Object> को स्टोर करने से ज़्यादा आसान है. दूसरे उदाहरण के तौर पर, किसी डेटा सेट के आईडी से जुड़े String आईडी को जोड़ा जा सकता है. Android के लिए Google Maps SDK टूल, इस प्रॉपर्टी को न तो पढ़ता है और न ही लिखता है. यह आपकी ज़िम्मेदारी है कि जब आपको ज़रूरत न हो, तो setTag(null) को कॉल करके टैग को हटाएं. इससे ऐप्लिकेशन में मेमोरी लीक होने से बचा जा सकता है.

पैरामीटर
टैग अगर यह शून्य है, तो टैग को हटा दिया जाता है.

Public void setVisible (boolean visible)

मंडली की दृश्यता सेट करता है.

अगर यह मंडली दिखाई नहीं दे रही है, तो इसे बनाया नहीं जाएगा. बाकी सभी राज्यों को सुरक्षित रखा गया है. मंडलियां डिफ़ॉल्ट रूप से दृश्यमान होती हैं.

पैरामीटर
दिख रहा है इस मंडली को दृश्यमान बनाने के लिए true; इसे अदृश्य बनाने के लिए false.

Public void setZIndex (फ़्लोट zIndex)

zIndex सेट करता है.

ज़्यादा zइंडेक्स वाले ओवरले, कम इंडेक्स वाले ओवरले के ऊपर बनाए जाते हैं. जैसे, सर्कल.

पैरामीटर
zIndex zIndex वैल्यू.