में शामिल है
पृथ्वी की सतह पर बना एक गोल आकार.
सर्कल में नीचे दिए गए गुण होते हैं.
- सेंटर
- सर्कल का केंद्र
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 | |
int |
getFillColor()
इस सर्कल का फ़िल कलर दिखाता है.
|
String |
getId()
इस मंडली का आईडी पाता है.
|
दोगुनी |
getRadius()
सर्कल की रेडियस को मीटर में दिखाता है.
|
int |
getStrokeColor()
स्ट्रोक का रंग दिखाता है.
|
List<PatternItem> |
getStrokePattern()
इस मंडली की आउटलाइन का स्ट्रोक पैटर्न देता है.
|
float |
getStrokeWidth()
स्ट्रोक की चौड़ाई दिखाता है.
|
ऑब्जेक्ट |
getTag()
मंडली के लिए टैग पाता है.
|
float |
getZIndex()
zIndex दिखाता है.
|
boolean |
isClickable()
सर्कल पर क्लिक करने की सुविधा देता है.
|
boolean |
isVisible()
जांच करता है कि मंडली दिखाई दे रही है या नहीं.
|
void |
हटाएं()
इस सर्कल को मैप से हटाता है.
|
void | |
void |
setClickable(बूलियन क्लिक करने लायक)
सर्कल पर क्लिक करने की योग्यता सेट करता है.
|
void |
setFillColor(इंट कलर)
फ़िल कलर सेट करता है.
|
void |
setRadius(डबल रेडियस)
दायरे को मीटर में सेट करता है.
|
void |
setStrokeColor(इंट कलर)
स्ट्रोक का रंग सेट करता है.
|
void | |
void |
setStrokeWidth(फ़्लोट की चौड़ाई)
स्ट्रोक की चौड़ाई सेट करता है.
|
void |
setTag(ऑब्जेक्ट टैग)
सर्कल के लिए टैग सेट करता है.
|
void |
setVisible(बूलियन विज़ुअल)
मंडली की दृश्यता सेट करता है.
|
void |
setZIndex(फ़्लोट zIndex)
zIndex सेट करता है.
|
इनहेरिट किए गए तरीके की खास जानकारी
सार्वजनिक तरीके
सार्वजनिक LatLng getCenter ()
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 सेंटर)
Public void setClickable (बूलियन क्लिक किया जा सकने वाला)
सर्कल पर क्लिक करने की योग्यता सेट करता है. अगर सर्कल पर क्लिक किया जा सकता है, तो सर्कल पर क्लिक करने पर आपके ऐप्लिकेशन को GoogleMap.OnCircleClickListener
पर सूचनाएं मिलेंगी.
इवेंट लिसनर का रजिस्ट्रेशन setOnCircleClickListener(GoogleMap.OnCircleClickListener)
तक किया गया है.
पैरामीटर
क्लिक करने योग्य | सर्कल के लिए, क्लिक करने की नई सेटिंग. |
---|
Public void setFillColor (int color)
सार्वजनिक शून्य setRadius (दोगुना रेडियस)
दायरे को मीटर में सेट करता है.
दायरा शून्य या उससे ज़्यादा होना चाहिए.
पैरामीटर
दायरा | मीटर में दायरा. |
---|
थ्रो
IllegalArgumentException | अगर त्रिज्या ऋणात्मक हो |
---|
Public void setStrokeColor (int 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 वैल्यू. |
---|