पृथ्वी की सतह पर एक गोला (गोलाकार टोपी).
किसी सर्कल में ये प्रॉपर्टी होती हैं.
- बीच में
- सर्कल का बीच,
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));
ध्यान दें कि अगर सर्कल, उत्तरी या दक्षिण ध्रुव को शामिल करता है, तो मौजूदा मैप रेंडरर उस सर्कल को नहीं भर पाएगा. हालांकि, आउटलाइन अब भी सही तरीके से बनाई जाएगी.
डेवलपर गाइड
ज़्यादा जानकारी के लिए, Shaps डेवलपर गाइड पढ़ें.
सार्वजनिक मेथड की खास जानकारी
LatLng | |
int |
getFillColor()
इस सर्कल का रंग भरता है.
|
स्ट्रिंग |
getId()
इस सर्कल की आईडी बनाता है.
|
दोगुनी |
get जोड़ें()
मीटर में, सर्कल'का दायरा दिखाता है.
|
int |
getStrokColor()
स्ट्रोक का रंग दिखाता है.
|
सूची<patternItem> |
getStrokpattern()
इस गोले के स्ट्रोक पैटर्न की जानकारी देता है.
|
फ़्लोट |
getStrokWidth()
स्ट्रोक की चौड़ाई दिखाता है.
|
अस्वीकार करें |
getTag()
सर्कल के लिए टैग हासिल करता है.
|
फ़्लोट |
getZindex()
zindex को पूरा करता है.
|
बूलियन |
isClickable()
सर्कल पर क्लिक करने की क्षमता मिलती है.
|
बूलियन |
isvisible()
जांचता है कि सर्कल दिखता है या नहीं.
|
शून्य |
हटाएं()
मैप से इस गोले को हटाता है.
|
शून्य | |
शून्य |
setClickable (बूलियन क्लिक किया जा सकता है)
सर्कल की क्लिक करने की क्षमता सेट करता है.
|
शून्य |
setFillColor(इंटर कलर)
फ़िल कलर सेट करता है.
|
शून्य |
setत्रिन (डबल रेडियस)
मीटर में दायरा सेट करता है.
|
शून्य |
setStrokColor(इंटर कलर)
स्ट्रोक का रंग सेट करता है.
|
शून्य | |
शून्य |
setStrokWidth (फ़्लोट विड्थ)
स्ट्रोक की चौड़ाई सेट करता है.
|
शून्य |
setTag(ऑब्जेक्ट टैग)
सर्कल के लिए टैग सेट करता है.
|
शून्य |
setvisible(बूलियन दिख रहा है)
सर्कल की दृश्यता सेट करता है.
|
शून्य |
setZindex(फ़्लो zindex)
zindex को सेट करता है.
|
इनहेरिट किए गए तरीके की खास जानकारी
सार्वजनिक तरीके
Public LatLng getCenter ()
Public int getFillColor ()
इस सर्कल का रंग भरता है.
लौटाए गए आइटम
- ARGB फ़ॉर्मैट में सर्कल का रंग.
public string getId ()
इस सर्कल की आईडी बनाता है. आईडी मैप पर सभी सर्कल के बीच अलग-अलग होगी.
सार्वजनिक डबल getScope ()
मीटर में, सर्कल'का दायरा दिखाता है.
लौटाए गए आइटम
- मीटर में त्रिज्या.
Public int getStrokColor ()
स्ट्रोक का रंग दिखाता है.
लौटाए गए आइटम
- ARGB फ़ॉर्मैट में सर्कल का रंग.
Public List<patternItem> getStrokpattern ()
इस गोले के स्ट्रोक पैटर्न की जानकारी देता है.
लौटाए गए आइटम
- स्ट्रोक पैटर्न.
public फ़्लोट getStrokWidth ()
स्ट्रोक की चौड़ाई दिखाता है.
लौटाए गए आइटम
- स्क्रीन पिक्सल में चौड़ाई.
public Object getTag ()
सर्कल के लिए टैग हासिल करता है.
लौटाए गए आइटम
- अगर
setTag
के साथ कोई टैग सेट होता है, तो टैग; अगर कोई टैग सेट नहीं किया गया है, तोnull
.
फ़ैमिली फ़्लोट getZindex ()
zindex को पूरा करता है.
लौटाए गए आइटम
- इस सर्कल का zindex.
Public बूलियन isClickable ()
सर्कल पर क्लिक करने की क्षमता मिलती है. अगर सर्कल पर क्लिक किया जा सकता है, तो आपके ऐप्लिकेशन को
GoogleMap.OnCircleClickListener
में तब सूचनाएं मिलेंगी, जब उपयोगकर्ता सर्कल पर क्लिक करेगा.
इवेंट लिसनर setOnCircleClickListener(GoogleMap.OnCircleClickListener)
के ज़रिए रजिस्टर किया गया है.
लौटाए गए आइटम
true
अगर सर्कल पर क्लिक किया जा सकता है, तोfalse
. अगर उस पर क्लिक नहीं किया जा सकता, तो.
सार्वजनिक बूलियन isvisible ()
जांचता है कि सर्कल दिखता है या नहीं.
लौटाए गए आइटम
- अगर सर्कल दिखता है, तो
true
; अगर नहीं दिख रहा है, तोfalse
.
Public प्रॉडक्ट हटाएं ()
मैप से इस गोले को हटाता है. किसी सर्कल को हटाने के बाद, उसकी सभी तरीकों के बारे में कोई जानकारी नहीं मिलती.
Public प्रॉडक्ट setCenter (LatLng केंद्र)
Public प्रॉडक्ट setClickable (बूलियन क्लिक किया जा सकता है)
सर्कल की क्लिक करने की क्षमता सेट करता है. अगर सर्कल पर क्लिक किया जा सकता है, तो आपके ऐप्लिकेशन को
GoogleMap.OnCircleClickListener
में तब सूचनाएं मिलेंगी, जब उपयोगकर्ता सर्कल पर क्लिक करेगा.
इवेंट लिसनर setOnCircleClickListener(GoogleMap.OnCircleClickListener)
के ज़रिए रजिस्टर किया गया है.
पैरामीटर
क्लिक करने योग्य | सर्कल के लिए क्लिक करने की नई सेटिंग. |
---|
Public प्रॉडक्ट setFillColor (int color)
Public प्रॉडक्ट setदाट (डबल रेडियस)
मीटर में दायरा सेट करता है.
दायरा शून्य या उससे ज़्यादा होना चाहिए.
पैरामीटर
दायरा | मीटर में त्रिज्या. |
---|
थ्रॉ
गैर-कानूनी अपवाद | अगर दायरा नेगेटिव है |
---|
Public प्रॉडक्ट setStrokColor (int color)
Public प्रॉडक्ट setStrikepattern (List<patternItem>pattern)
सर्कल के स्ट्रोक पैटर्न को सेट करता है. डिफ़ॉल्ट स्ट्रोक पैटर्न ठोस है, जिसे null
से दिखाया जाता है.
पैरामीटर
पैटर्न | स्ट्रोक पैटर्न. |
---|
Public प्रॉडक्ट setStrokWidth (फ़्लोट विड्थ)
स्ट्रोक की चौड़ाई सेट करता है.
स्ट्रोक की चौड़ाई, गोले की स्क्रीन की चौड़ाई (स्क्रीन पिक्सल में) है. यह शून्य या इससे ज़्यादा होना चाहिए. अगर यह शून्य है, तो कोई आउटलाइन नहीं बनाई जाती है. डिफ़ॉल्ट सीमा 10 है.
पैरामीटर
width | स्क्रीन पिक्सल में, स्ट्रोक की चौड़ाई. |
---|
थ्रॉ
गैर-कानूनी अपवाद | अगर चौड़ाई नेगेटिव है |
---|
Public प्रॉडक्ट setTag (ऑब्जेक्ट टैग)
सर्कल के लिए टैग सेट करता है.
आर्बिट्ररी Object
को इस सर्कल के साथ जोड़ने के लिए, इस प्रॉपर्टी का इस्तेमाल किया जा सकता है. उदाहरण के लिए, Object
में सर्कल के बारे में जानकारी देने वाला डेटा हो सकता है. यह एक अलग Map<Circle, Object>
सेव करने से ज़्यादा आसान है. दूसरे उदाहरण के तौर पर, आप डेटा सेट से, आईडी से जुड़े String
आईडी को जोड़ सकते हैं. Android के लिए Google Maps SDK टूल, इस प्रॉपर्टी को न तो पढ़ता है और न ही लिखता है. अगर अब आपको टैग की ज़रूरत न हो, तो उसे साफ़ करने के लिए setTag(null)
को कॉल करना आपकी ज़िम्मेदारी है. ऐसा करने से, ऐप्लिकेशन के स्टोरेज में जगह की जानकारी लीक होने से रोका जा सकता है.
पैरामीटर
टैग | अगर शून्य है, तो टैग को हटा दिया जाता है. |
---|
Public प्रॉडक्ट setvisible (बूलियन दिख रहे)
सर्कल की दृश्यता सेट करता है.
अगर यह सर्कल नहीं दिख रहा है, तो इसे ड्रॉ नहीं किया जाएगा. अन्य सभी राज्य संरक्षित हैं. मंडलियां डिफ़ॉल्ट रूप से दिखाई देती हैं.
पैरामीटर
दिख रहा है | इस सर्कल को दिखाने के लिए true ; इसे न दिखने लायक बनाने के लिए false .
|
---|
Public प्रॉडक्ट setZindex (फ़्लोट zindex)
zindex को सेट करता है.
ज़्यादा zIndices वाले ओवरले (जैसे कि सर्कल) कम इंडेक्स वाले क्षेत्रों के ऊपर बनाए जाते हैं.
पैरामीटर
zइंडेक्स | zindex वैल्यू. |
---|