बहुभुज

पब्लिक फ़ाइनल क्लास पॉलीगॉन ऑब्जेक्ट
का विस्तार करता है

पृथ्वी की सतह पर मौजूद एक पॉलीगॉन. कोई पॉलीगॉन, उत्तल या अवतल हो सकता है, यह 180 मेरिडियन तक फैला हो सकता है और इसमें ऐसे छेद हो सकते हैं जो भरे नहीं गए हैं. इसमें ये प्रॉपर्टी शामिल होती हैं:

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

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

उदाहरण

GoogleMap map;
 // ... get a map.
 // Add a triangle in the Gulf of Guinea
 Polygon polygon = map.addPolygon(new PolygonOptions()
     .add(new LatLng(0, 0), new LatLng(0, 5), new LatLng(3, 5), new LatLng(0, 0))
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));

डेवलपर गाइड

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

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

boolean
इसके बराबर है(अन्य ऑब्जेक्ट)
यह टेस्ट करता है कि यह Polygon, दूसरे के बराबर है या नहीं.
int
getFillColor()
इस पॉलीगॉन के फ़िल कलर का पता लगाता है.
List<List<LatLng>>
getHoles() से
इस समय इस बहुभुज के छेदों का स्नैपशॉट देता है .
String
getId()
इस पॉलीगॉन का आईडी पाता है.
List<LatLng>
getPoints()
इस समय इस बहुभुज के शीर्षों का स्नैपशॉट देता है .
int
getStrokeColor()
इस पॉलीगॉन का स्ट्रोक रंग पाता है.
int
getStrokeJointType()
पॉलीगॉन के आउटलाइन के सभी शीर्षों पर इस्तेमाल किए जाने वाले स्ट्रोक जॉइंट टाइप को दिखाता है.
List<PatternItem>
getStrokePattern()
इस पॉलीगॉन की आउटलाइन का स्ट्रोक पैटर्न मिलता है.
float
getStrokeWidth()
इस पॉलीगॉन की स्ट्रोक चौड़ाई की जानकारी मिलती है.
ऑब्जेक्ट
getTag()
पॉलीगॉन के लिए टैग पाता है.
float
getZIndex()
इस पॉलीगॉन का zIndex मिलता है.
int
hashCode()
boolean
isClickable()
पॉलीगॉन पर क्लिक करने की योग्यता हासिल करता है.
boolean
isGeodesic()
यह पता लगाता है कि लाइन का हर सेगमेंट, जियोडिसिक के तौर पर बनाया गया है या नहीं.
boolean
isVisible()
इस पॉलीगॉन को दिखाता है.
void
हटाएं()
मैप से पॉलीगॉन हटाता है.
void
setClickable(बूलियन क्लिक करने लायक)
पॉलीगॉन पर क्लिक करने की योग्यता सेट करता है.
void
setFillColor(इंट कलर)
इस पॉलीगॉन का फ़िल कलर सेट करता है.
void
setGeodesic(बूलियन जियोडिसिक)
सेट करता है कि लाइन के हर सेगमेंट को जियोडिसिक के रूप में बनाना है या नहीं.
void
setHoles(List<? List<LatLng>> के छेदों को बढ़ावा देता है)
इस पॉलीगॉन के छेद सेट करता है.
void
setPoints(सूची<LatLng> पॉइंट)
इस पॉलीगॉन के पॉइंट सेट करता है.
void
setStrokeColor(इंट कलर)
इस पॉलीगॉन का स्ट्रोक रंग सेट करता है.
void
setStrokeJointType(intjoinType)
पॉलीगॉन आउटलाइन के सभी शीर्षों के लिए जॉइंट टाइप सेट करता है.
void
setStrokePattern(List<PatternItem> पैटर्न)
पॉलीगॉन की आउटलाइन का स्ट्रोक पैटर्न सेट करता है.
void
setStrokeWidth(फ़्लोट की चौड़ाई)
इस पॉलीगॉन की स्ट्रोक चौड़ाई सेट करता है.
void
setTag(ऑब्जेक्ट टैग)
पॉलीगॉन के लिए टैग सेट करता है.
void
setVisible(बूलियन विज़ुअल)
इस पॉलीगॉन की विज़िबिलिटी सेट करता है.
void
setZIndex(फ़्लोट zIndex)
इस पॉलीगॉन का zIndex सेट करता है.

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

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

सार्वजनिक बूलियन इसके बराबर है (अन्य ऑब्जेक्ट)

यह टेस्ट करता है कि यह Polygon, दूसरे के बराबर है या नहीं.

पैरामीटर
अन्य एक Object.
रिटर्न
  • अगर दोनों ऑब्जेक्ट एक ही ऑब्जेक्ट हैं, यानी कि यह == अन्य है, तो 'सही'.

Public int getFillColor ()

इस पॉलीगॉन के फ़िल कलर का पता लगाता है.

रिटर्न
  • रंग को ARGB फ़ॉर्मैट में रखना होगा.

सार्वजनिक List<List<LatLng>> getHoles ()

इस समय इस बहुभुज के छेदों का स्नैपशॉट देता है . वापस दी गई सूची, होल की सूची की कॉपी है. इसलिए, पॉलीगॉन के छेद में किए गए बदलाव इस सूची में नहीं दिखेंगे और न ही इस सूची में किए गए बदलाव पॉलीगॉन से दिखेंगे.

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

इस पॉलीगॉन का आईडी पाता है. यह आईडी, मैप पर सभी पॉलीगॉन के बीच खास होगी.

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

इस समय इस बहुभुज के शीर्षों का स्नैपशॉट देता है . दी गई सूची, वर्टेक्स की सूची की कॉपी है. इसलिए, पॉलीगॉन के वर्टेक्स में किए गए बदलाव, इस सूची में नहीं दिखेंगे. साथ ही, इस सूची में किए गए बदलाव भी पॉलीगॉन में नहीं दिखेंगे. पॉलीगॉन के शीर्ष बदलने के लिए, setPoints(List) पर कॉल करें.

Public int getStrokeColor ()

इस पॉलीगॉन का स्ट्रोक रंग पाता है.

रिटर्न
  • रंग को ARGB फ़ॉर्मैट में रखना होगा.

Public int getStrokeJointType ()

पॉलीगॉन के आउटलाइन के सभी शीर्षों पर इस्तेमाल किए जाने वाले स्ट्रोक जॉइंट टाइप को दिखाता है. संभावित वैल्यू के लिए, JointType देखें.

रिटर्न
  • स्ट्रोक जॉइंट टाइप.

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

इस पॉलीगॉन की आउटलाइन का स्ट्रोक पैटर्न मिलता है.

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

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

इस पॉलीगॉन की स्ट्रोक चौड़ाई की जानकारी मिलती है.

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

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

पॉलीगॉन के लिए टैग पाता है.

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

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

इस पॉलीगॉन का zIndex मिलता है.

रिटर्न
  • पॉलीगॉन का zIndex.

Public int hashCode ()

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

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

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

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

यह पता लगाता है कि लाइन का हर सेगमेंट, जियोडिसिक के तौर पर बनाया गया है या नहीं.

रिटर्न
  • true, अगर हर सेगमेंट को जियोडिसिक के तौर पर बनाया गया है; अगर हर सेगमेंट को मरकेटर प्रोजेक्शन पर सीधी लाइन से बनाया गया है, तो false.

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

इस पॉलीगॉन को दिखाता है.

रिटर्न
  • दिखेगा.

Public void हटाएं ()

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

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

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

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

Public void setFillColor (int color)

इस पॉलीगॉन का फ़िल कलर सेट करता है.

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

Public void setGeodesic (boolean geodesic)

सेट करता है कि लाइन के हर सेगमेंट को जियोडिसिक के रूप में बनाना है या नहीं.

पैरामीटर
जियोडिसिक अगर true है, तो हर सेगमेंट जियोडेसिक के तौर पर बनाया जाता है. अगर false है, तो हर सेगमेंट को मरकेटर प्रोजेक्शन पर सीधी रेखा के तौर पर दिखाया जाता है.

Public void setHoles (List<? सूची को बड़ा करता है<LatLng>> होल)

इस पॉलीगॉन के छेद सेट करता है. इस तरीके से, उन छेदों की कॉपी बन जाएगी. इसलिए, holes में किए गए बदलाव से, इस पॉलीगॉन पर कोई असर नहीं पड़ेगा.

पैरामीटर
होल होल की सूची, जिसमें एक होल LatLng सेकंड की सूची होता है.

Public void setPoints (List<LatLng> पॉइंट)

इस पॉलीगॉन के पॉइंट सेट करता है. इस तरीके से पॉइंट की कॉपी बन जाएगी. इसलिए, points में किए गए बदलाव से, इस पॉलीगॉन पर कोई असर नहीं पड़ेगा.

पैरामीटर
पॉइंट LatLng की सूची, जो पॉलीगॉन के शीर्ष हैं.

Public void setStrokeColor (int color)

इस पॉलीगॉन का स्ट्रोक रंग सेट करता है.

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

Public void setStrokeJointType (intjoinType)

पॉलीगॉन आउटलाइन के सभी शीर्षों के लिए जॉइंट टाइप सेट करता है.

मंज़ूर किए गए मान के लिए JointType देखें. डिफ़ॉल्ट वैल्यू DEFAULT का इस्तेमाल तब किया जाएगा, जब जॉइंट टाइप तय नहीं किया गया हो या दी गई वैल्यू में से कोई एक वैल्यू न हो.

पैरामीटर
jointType स्ट्रोक जॉइंट टाइप.

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

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

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

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

इस पॉलीगॉन की स्ट्रोक चौड़ाई सेट करता है.

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

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

पॉलीगॉन के लिए टैग सेट करता है.

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

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

Public void setVisible (boolean visible)

इस पॉलीगॉन की विज़िबिलिटी सेट करता है. नहीं दिखने पर, पॉलीगॉन नहीं बनाया जाता. हालांकि, इसकी बाकी सभी प्रॉपर्टी बनी रहती हैं.

पैरामीटर
दिख रहा है अगर true है, तो पॉलीगॉन दिखेगा. अगर false है, तो यह नहीं दिखेगा.

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

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

पैरामीटर
zIndex इस पॉलीगॉन का zIndex.