का विस्तार करता है
पृथ्वी की सतह पर एक वृत्त (गोलाकार कैप).
सर्कल में ये प्रॉपर्टी होती हैं.
- बीच में
- सर्कल के बीच का हिस्सा
LatLng
के तौर पर बताया गया है. - दायरा
- सर्कल की रेडियस, मीटर में दी गई है. यह शून्य या उससे बड़ा होना चाहिए.
- स्ट्रोक की चौड़ाई
- स्क्रीन पिक्सल में सर्कल की आउटलाइन की चौड़ाई. चौड़ाई स्थिर और स्वतंत्र है ज़ूम लेवल कम या ज़्यादा हो सकता है. डिफ़ॉल्ट तौर पर, यह वैल्यू 10 होती है.
- स्ट्रोक का रंग
- वृत्त के आउटलाइन का रंग ARGB फ़ॉर्मैट में होता है. इसी फ़ॉर्मैट का इस्तेमाल
Color
करता है. डिफ़ॉल्ट मान काला (0xff000000
) है. - स्ट्रोक पैटर्न
- सॉलिड (डिफ़ॉल्ट, जिसे
null
से दिखाया जाता है) याPatternItem
ऑब्जेक्ट का क्रम जिन्हें सर्कल की आउटलाइन के साथ दोहराया जा सकता है. उपलब्धPatternItem
टाइप:Gap
(पिक्सल में गैप लंबाई से तय किया गया),Dash
(इसमें स्ट्रोक की चौड़ाई और डैश की लंबाई से तय किया गया है) पिक्सल) औरDot
(गोलाकार, सर्कल की आउटलाइन पर फ़ोकस किया गया, व्यास (डायमीटर)) स्ट्रोक की चौड़ाई (पिक्सल में). - रंग भरें
- सर्कल का रंग ARGB फ़ॉर्मैट में भरा होता है. इसी फ़ॉर्मैट का इस्तेमाल
Color
करता है. डिफ़ॉल्ट वैल्यू पारदर्शी होती है (0x00000000
). - Z-इंडेक्स
- अन्य ओवरले के हिसाब से इस टाइल ओवरले को बनाने का क्रम (इसमें ये शामिल हैं
GroundOverlay
,TileOverlay
,Polyline
, औरPolygon
s, लेकिन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()
इस सर्कल के रंग को दिखाता है.
|
स्ट्रिंग |
getId()
इस मंडली की आईडी प्राप्त करता है.
|
दोगुनी |
getRadius()
मीटर में, वृत्त की त्रिज्या देता है.
|
int |
getStrokeColor()
स्ट्रोक का रंग दिखाता है.
|
सूची<PatternItem> |
getStrokePattern()
इस सर्कल की आउटलाइन का स्ट्रोक पैटर्न दिखाता है.
|
फ़्लोट |
getStrokeWidth()
स्ट्रोक की चौड़ाई दिखाता है.
|
ऑब्जेक्ट |
getTag()
मंडली के लिए टैग प्राप्त करता है.
|
फ़्लोट |
getZIndex()
zIndex देता है.
|
बूलियन |
isClickable()
सर्कल की क्लिक करने की योग्यता की जानकारी देता है.
|
बूलियन |
isVisible()
जांचता है कि क्या वृत्त दिखाई दे रहा है.
|
अमान्य |
remove()
इस सर्कल को मैप से हटाता है.
|
अमान्य | |
अमान्य |
setClickable(बूलियन क्लिक किया जा सकता है)
मंडली की क्लिक करने की योग्यता सेट करता है.
|
अमान्य |
setFillColor(int color)
भरने का रंग सेट करता है.
|
अमान्य |
setRadius(दोगुने दायरा)
मीटर में रेडियस सेट करता है.
|
अमान्य |
setStrokeColor(इंट रंग)
स्ट्रोक का रंग सेट करता है.
|
अमान्य | |
अमान्य |
setStrokeWidth(फ़्लोट की चौड़ाई)
स्ट्रोक की चौड़ाई सेट करता है.
|
अमान्य |
setTag(ऑब्जेक्ट टैग)
मंडली के लिए टैग सेट करता है.
|
अमान्य |
setVisible(boolean visible)
मंडली की दृश्यता सेट करता है.
|
अमान्य |
setZIndex(फ़्लोट zIndex)
zइंडेक्स सेट करता है.
|
इनहेरिट किए गए तरीके की खास जानकारी
सार्वजनिक तरीके
सार्वजनिक LatLng getCenter ()
सार्वजनिक आईएनटी getFillColor ()
इस सर्कल के रंग को दिखाता है.
रिटर्न
- ARGB फ़ॉर्मैट में सर्कल का रंग.
सार्वजनिक स्ट्रिंग getId ()
इस मंडली की आईडी प्राप्त करता है. यह आईडी, मैप पर मौजूद सभी सर्कल के लिए यूनीक होगा.
सार्वजनिक डबल getRadius ()
मीटर में, वृत्त की त्रिज्या देता है.
रिटर्न
- मीटर में दायरा.
सार्वजनिक आईएनटी getStrokeColor ()
स्ट्रोक का रंग दिखाता है.
रिटर्न
- ARGB फ़ॉर्मैट में सर्कल का रंग.
सार्वजनिक सूची<PatternItem> getStrokePattern ()
इस सर्कल की आउटलाइन का स्ट्रोक पैटर्न दिखाता है.
रिटर्न
- स्ट्रोक पैटर्न.
सार्वजनिक फ़्लोट getStrokeWidth ()
स्ट्रोक की चौड़ाई दिखाता है.
रिटर्न
- स्क्रीन पिक्सल में चौड़ाई.
सार्वजनिक ऑब्जेक्ट getTag ()
मंडली के लिए टैग प्राप्त करता है.
रिटर्न
- अगर कोई टैग
setTag
के साथ सेट किया गया था, तो टैग; अगर कोई टैग सेट नहीं किया गया है, तोnull
.
सार्वजनिक फ़्लोट getZIndex ()
zIndex देता है.
रिटर्न
- इस मंडली का zIndex.
सार्वजनिक बूलियन isClickable ()
सर्कल की क्लिक करने की योग्यता की जानकारी देता है. अगर सर्कल पर क्लिक किया जा सकता है, तो आपके ऐप्लिकेशन को
उपयोगकर्ता के सर्कल पर क्लिक करने पर, GoogleMap.OnCircleClickListener
को सूचनाएं भेजी जाएगी.
इवेंट लिसनर को setOnCircleClickListener(GoogleMap.OnCircleClickListener)
तक रजिस्टर किया गया है.
रिटर्न
- अगर सर्कल पर क्लिक किया जा सकता है, तो
true
; अगर क्लिक करने लायक न हो, तोfalse
.
सार्वजनिक बूलियन isVisible ()
जांचता है कि क्या वृत्त दिखाई दे रहा है.
रिटर्न
- अगर सर्कल दिख रहा है, तो
true
; अगर यह नहीं दिख रहा है, तोfalse
.
सार्वजनिक अमान्य हटाएं ()
इस सर्कल को मैप से हटाता है. किसी मंडली को निकाल दिए जाने के बाद, उसके सभी तरीके के बारे में नहीं बताया गया है.
सार्वजनिक अमान्य setCenter (LatLng केंद्र)
सार्वजनिक अमान्य setClickable (बूलियन क्लिक किया जा सकता है)
मंडली की क्लिक करने की योग्यता सेट करता है. अगर सर्कल पर क्लिक किया जा सकता है, तो आपके ऐप्लिकेशन को
उपयोगकर्ता के सर्कल पर क्लिक करने पर, GoogleMap.OnCircleClickListener
को सूचनाएं भेजी जाएगी.
इवेंट लिसनर को setOnCircleClickListener(GoogleMap.OnCircleClickListener)
तक रजिस्टर किया गया है.
पैरामीटर
क्लिक करने योग्य | मंडली के लिए नई क्लिक करने की सेटिंग. |
---|
सार्वजनिक अमान्य setFillColor (इंट रंग)
सार्वजनिक अमान्य setRadius (दोगुना दायरा)
मीटर में रेडियस सेट करता है.
दायरा शून्य या उससे ज़्यादा होना चाहिए.
पैरामीटर
दायरा | मीटर में, दायरा. |
---|
थ्रो
IllegalArgumentException | अगर दायरा ऋणात्मक है |
---|
सार्वजनिक अमान्य setStrokeColor (इंट रंग)
सार्वजनिक अमान्य setStrokePattern (सूची<PatternItem> पैटर्न)
सर्कल की आउटलाइन का स्ट्रोक पैटर्न सेट करता है. डिफ़ॉल्ट स्ट्रोक पैटर्न सॉलिड है,
null
से दिखाया जाता है.
पैरामीटर
पैटर्न | स्ट्रोक पैटर्न. |
---|
सार्वजनिक अमान्य setStrokeWidth (फ़्लोट की चौड़ाई)
स्ट्रोक की चौड़ाई सेट करता है.
स्ट्रोक की चौड़ाई, सर्कल की आउटलाइन की चौड़ाई (स्क्रीन पिक्सल में) होती है. यह शून्य या बड़ा. अगर यह शून्य है, तो कोई आउटलाइन नहीं बनाई जाती. डिफ़ॉल्ट तौर पर, यह वैल्यू 10 होती है.
पैरामीटर
चौड़ाई | स्ट्रोक की चौड़ाई, स्क्रीन पिक्सल में. |
---|
थ्रो
IllegalArgumentException | अगर चौड़ाई ऋणात्मक है |
---|
सार्वजनिक अमान्य setTag (ऑब्जेक्ट टैग)
मंडली के लिए टैग सेट करता है.
आप इस प्रॉपर्टी के साथ किसी आर्बिट्ररी Object
को जोड़ने के लिए, इस प्रॉपर्टी का इस्तेमाल कर सकते हैं. इसके लिए
उदाहरण के लिए, Object
में यह डेटा हो सकता है कि सर्कल क्या दिखाता है. यह ज़्यादा आसान है
अलग Map<Circle, Object>
संग्रहित करने के मुकाबले. एक अन्य उदाहरण के रूप में, आपके पास
String
आईडी, किसी डेटा सेट की आईडी से जुड़ा होता है. Android के लिए Google Maps SDK टूल में से कोई भी नहीं
इस प्रॉपर्टी को पढ़ता है या लिखता है. मिटाने के लिए, setTag(null)
को कॉल करने की ज़िम्मेदारी आपकी है
ताकि आपको अपने ऐप्लिकेशन में मेमोरी लीक होने से रोकने के लिए टैग की ज़रूरत न पड़े.
पैरामीटर
टैग | अगर यह खाली है, तो टैग हटा दिया जाता है. |
---|
सार्वजनिक अमान्य setVisible (बूलियन के तौर पर दिख रहा है)
मंडली की दृश्यता सेट करता है.
अगर यह वृत्त दिखाई नहीं देता है, तो इसे बनाया नहीं जाएगा. दूसरी सभी स्थितियों को सुरक्षित रखा जाता है. मंडलियां डिफ़ॉल्ट रूप से दृश्यमान होती हैं.
पैरामीटर
दिख रहा है | इस मंडली को दृश्यमान बनाने के लिए true ; इसे ग्लोब पर दिखाने के लिए false .
|
---|
सार्वजनिक अमान्य setZIndex (फ़्लोट zइंडेक्स)
zइंडेक्स सेट करता है.
ज़्यादा zIndice वाले ओवरले (जैसे कि वृत्त) कम इंडेक्स वाले ओवरले के ऊपर बनाए जाते हैं.
पैरामीटर
zIndex | zIndex मान. |
---|