पॉलीलाइन

पब्लिक फ़ाइनल क्लास Polyline ऑब्जेक्ट

पॉलीलाइन बिंदुओं की सूची होती है, जहां लाइन सेगमेंट, लगातार आने वाले बिंदुओं के बीच बनाए जाते हैं. पॉलीलाइन में ये प्रॉपर्टी होती हैं:

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

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

उदाहरण

GoogleMap map;
 // ... get a map.
 // Add a thin red line from London to New York.
 Polyline line = map.addPolyline(new PolylineOptions()
     .add(new LatLng(51.5, -0.1), new LatLng(40.7, -74.0))
     .width(5)
     .color(Color.RED));

डेवलपर गाइड

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

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

boolean
इसके बराबर है(अन्य ऑब्जेक्ट)
यह टेस्ट करता है कि यह Polyline, दूसरे के बराबर है या नहीं.
int
getColor()
इस पॉलीलाइन का रंग दिखाता है.
कैप
getEndCap()
इस पॉलीलाइन के आखिरी वर्टेक्स पर कैप लगाता है.
String
getId()
इस पॉलीलाइन आईडी को पाता है.
int
getJointType()
शुरुआती और आखिरी वर्टेक्स को छोड़कर, पॉलीलाइन के सभी वर्टेक्स पर इस्तेमाल किए जाने वाले जॉइंट टाइप.
List<PatternItem>
getPattern()
इस पॉलीलाइन का स्ट्रोक पैटर्न मिलता है.
List<LatLng>
getPoints()
इस समय इस पॉलीलाइन के शीर्षों का स्नैपशॉट देता है .
कैप
getStartCap()
इस पॉलीलाइन के शुरुआती वर्टेक्स पर कैप लगाता है.
ऑब्जेक्ट
getTag()
पॉलीलाइन के लिए टैग पाता है.
float
getWidth()
इस पॉलीलाइन की चौड़ाई को दिखाता है.
float
getZIndex()
इस पॉलीलाइन का zIndex मिलता है.
int
hashCode()
boolean
isClickable()
पॉलीलाइन पर क्लिक करने की क्षमता दिखाता है.
boolean
isGeodesic()
यह पता लगाता है कि लाइन का हर सेगमेंट, जियोडिसिक के तौर पर बनाया गया है या नहीं.
boolean
isVisible()
इस पॉलीलाइन को दिखाता है.
void
हटाएं()
इस पॉलीलाइन को मैप से हटा दिया जाता है.
void
setClickable(बूलियन क्लिक करने लायक)
पॉलीलाइन पर क्लिक करने की योग्यता सेट करता है.
void
setColor(इंट कलर)
इस पॉलीलाइन का रंग सेट करता है.
void
setEndCap(कैप एंड कैप)
इस पॉलीलाइन के आखिरी वर्टेक्स पर कैप सेट करता है.
void
setGeodesic(बूलियन जियोडिसिक)
सेट करता है कि लाइन के हर सेगमेंट को जियोडिसिक के रूप में बनाना है या नहीं.
void
setJointType(intjoinType)
शुरुआती और आखिरी वर्टेक्स को छोड़कर, पॉलीलाइन के सभी वर्टेक्स के लिए जॉइंट टाइप सेट करता है.
void
setPattern(सूची<PatternItem> पैटर्न)
पॉलीलाइन का स्ट्रोक पैटर्न सेट करता है.
void
setPoints(सूची<LatLng> पॉइंट)
इस पॉलीलाइन के पॉइंट सेट करता है.
void
setSpans(List<StyleSpan> स्पैन)
पॉलीलाइन के स्पैन सेट करता है.
void
setStartCap(कैप startCap)
इस पॉलीलाइन के शुरुआती शीर्ष पर कैप सेट करता है.
void
setTag(ऑब्जेक्ट टैग)
पॉलीलाइन के लिए टैग सेट करता है.
void
setVisible(बूलियन विज़ुअल)
सेट करता है कि यह पॉलीलाइन दिखे.
void
setWidth(फ़्लोट की चौड़ाई)
इस पॉलीलाइन की चौड़ाई सेट करता है.
void
setZIndex(फ़्लोट zIndex)
इस पॉलीलाइन का zIndex सेट करता है.

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

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

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

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

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

Public int getColor ()

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

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

सार्वजनिक Cap getEndCap ()

इस पॉलीलाइन के आखिरी वर्टेक्स पर कैप लगाता है.

रिटर्न
  • एंड कैप टाइप.

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

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

रिटर्न
  • इस पॉलीलाइन आईडी का.

Public int getJointType ()

शुरुआती और आखिरी वर्टेक्स को छोड़कर, पॉलीलाइन के सभी वर्टेक्स पर इस्तेमाल किए जाने वाले जॉइंट टाइप. संभावित वैल्यू के लिए, JointType देखें.

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

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

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

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

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

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

सार्वजनिक Cap getStartCap ()

इस पॉलीलाइन के शुरुआती वर्टेक्स पर कैप लगाता है.

रिटर्न
  • शुरुआत की सीमा तय करें.

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

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

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

Public फ़्लोट getWidth ()

इस पॉलीलाइन की चौड़ाई को दिखाता है.

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

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

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

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

Public int hashCode ()

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

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

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

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

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

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

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

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

रिटर्न
  • इस पॉलीलाइन की विज़िबिलिटी.

Public void हटाएं ()

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

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

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

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

Public void setColor (int color)

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

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

Public void setEndCap (Cap endCap)

इस पॉलीलाइन के आखिरी वर्टेक्स पर कैप सेट करता है. डिफ़ॉल्ट तौर पर, खत्म होने की सीमा ButtCap होती है.

पैरामीटर
endCap खत्म होने की सीमा. null नहीं होनी चाहिए.

Public void setGeodesic (boolean geodesic)

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

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

Public void setJointType (intjoinType)

शुरुआती और आखिरी वर्टेक्स को छोड़कर, पॉलीलाइन के सभी वर्टेक्स के लिए जॉइंट टाइप सेट करता है.

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

पैरामीटर
jointType जॉइंट टाइप.

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

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

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

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

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

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

Public void setSpans (List<StyleSpan> spans)

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

पैरामीटर
स्पैन

Public void setStartCap (Cap startCap)

इस पॉलीलाइन के शुरुआती शीर्ष पर कैप सेट करता है. डिफ़ॉल्ट स्टार्ट कैप ButtCap है.

पैरामीटर
startCap शुरू करने की सीमा. null नहीं होनी चाहिए.

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

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

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

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

Public void setVisible (boolean visible)

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

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

Public void setWidth (फ़्लोट विड्थ)

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

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

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

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

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