मार्कर

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

मैप की सतह पर किसी खास पॉइंट पर रखा गया आइकॉन. मार्कर आइकॉन का इस्तेमाल किया गया है मैप की सतह के बजाय डिवाइस की स्क्रीन पर दिखाएं; यानी, यह ज़रूरी नहीं है कि झुकाव, मैप के झुकाव, या ज़ूमिंग के कारण होता है.

मार्कर में ये प्रॉपर्टी होती हैं:

ऐल्फ़ा
मार्कर की ओपैसिटी को सेट करता है. डिफ़ॉल्ट वैल्यू 1.0 होती है.
एंकर
इमेज पर मौजूद वह बिंदु जिसे मार्कर की LatLng स्थिति पर रखा जाएगा. यह डिफ़ॉल्ट रूप से, इमेज की बाईं ओर और सबसे नीचे की ओर 50% होता है.
स्थिति
मैप पर मार्कर की जगह के लिए LatLng वैल्यू. आप इस वैल्यू को यहां बदल सकते हैं किसी भी समय पर क्लिक करें.
शीर्षक
एक टेक्स्ट स्ट्रिंग, जो उपयोगकर्ता के मार्कर पर टैप करने पर जानकारी विंडो में दिखती है. आप इस वैल्यू को कभी भी बदला जा सकता है.
स्निपेट
शीर्षक के नीचे दिखाया गया अतिरिक्त टेक्स्ट. इस वैल्यू को कभी भी बदला जा सकता है.
आइकॉन
मार्कर के लिए दिखाया जाने वाला बिट मैप. अगर आइकॉन को सेट नहीं किया जाता है, तो डिफ़ॉल्ट आइकॉन दिखाया जाएगा. defaultMarker(float) का इस्तेमाल करके, डिफ़ॉल्ट आइकॉन के लिए कोई दूसरा रंग तय किया जा सकता है.
ड्रैग स्थिति
अगर आप उपयोगकर्ता को मार्कर को खींचने की अनुमति देना चाहते हैं, तो इस प्रॉपर्टी को true पर सेट करें. आपने लोगों तक पहुंचाया मुफ़्त में इस वैल्यू को कभी भी बदल सकते हैं. डिफ़ॉल्ट वैल्यू false है.
किसको दिखाई दे
डिफ़ॉल्ट रूप से मार्कर दिखता है. मार्कर को दिखाई न देने के लिए, इस प्रॉपर्टी को false. इस वैल्यू को कभी भी बदला जा सकता है.
फ़्लैट या बिलबोर्ड
अगर मार्कर मैप के सामने सपाट रहता है, तो यह मैप पर कैमरे की तरह ही रहेगा घुमाता और झुकाता है, लेकिन अब भी उसका आकार कैमरा ज़ूम करने के आकार के समान रहेगा, GroundOverlay के उलट. अगर मार्कर कोई बिलबोर्ड है, तो इसे हमेशा कैमरे की तरफ़ और कैमरे से घूमेगा और झुकाएगा. डिफ़ॉल्ट बिलबोर्ड (false) है
रोटेशन
मार्कर के ऐंकर पॉइंट के आस-पास, घड़ी की सुई की दिशा में डिग्री का घुमाना. द ऐक्सिस का रोटेशन मार्कर के लंबवत है. 0 का रोटेशन डिफ़ॉल्ट के अनुरूप है मार्कर की स्थिति. जब चिह्नक मैप पर सपाट होता है, तो डिफ़ॉल्ट स्थिति उत्तर में होती है अलाइन किया गया है और घुमाव इस तरह से है कि मैप पर मार्कर हमेशा सपाट रहे. जब मार्कर एक बिलबोर्ड है, डिफ़ॉल्ट स्थिति ऊपर की ओर इशारा करती है और घुमाव ऐसा होता है कि मार्कर हमेशा कैमरे की तरफ़ होता है. डिफ़ॉल्ट वैल्यू 0 है.
zIndex
मार्कर के लिए ड्रॉ का क्रम. मार्कर zइंडेक्स के क्रम में बनाए जाते हैं, शीर्ष पर बनाए गए उच्चतम zइंडेक्स मार्कर. हर मार्कर के लिए zIndex प्रॉपर्टी सेट करके, तय करें कि आपका उपयोगकर्ता किस टैप को टारगेट कर सकता है. डिफ़ॉल्ट वैल्यू 0 है.
टैग
मार्कर से जुड़ा Object. उदाहरण के लिए, Object में ये चीज़ें शामिल हो सकती हैं मार्कर के बारे में डेटा. यह एक अलग Map<Marker, Object> स्टोर करने की तुलना में ज़्यादा आसान है. एक अन्य उदाहरण के तौर पर, आपके पास String आईडी जोड़ने का विकल्प है किसी डेटा सेट की आईडी से संबंधित होता है. Android के लिए Google Maps SDK टूल, न तो पढ़ता है और न ही इस प्रॉपर्टी को लिखता है.

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

उदाहरण

GoogleMap map = ... // get a map.
 // Add a marker at San Francisco.
 Marker marker = map.addMarker(new MarkerOptions()
     .position(new LatLng(37.7750, 122.4183))
     .title("San Francisco")
     .snippet("Population: 776733"));

डेवलपर गाइड

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

नेस्ट की गई क्लास की खास जानकारी

@interface Marker.CollisionBehavior यह बताता है कि अन्य मार्कर या बेस के साथ टक्कर होने पर, मार्कर का क्या इस्तेमाल किया जाता है मैप लेबल.

सार्वजनिक तौर पर उपलब्ध तरीके के बारे में खास जानकारी

बूलियन
इसके बराबर है(अन्य ऑब्जेक्ट)
जांच करता है कि यह Marker, दूसरे के बराबर है या नहीं.
फ़्लोट
getAlpha()
मार्कर का अल्फ़ा प्राप्त करता है.
स्ट्रिंग
getId()
इस मार्कर की आईडी प्राप्त करता है.
LatLng
getPosition()
मार्कर की स्थिति दिखाता है.
फ़्लोट
getRotation()
इससे मार्कर को घुमाया जाता है.
स्ट्रिंग
getSnippet()
मार्कर का स्निपेट लाता है.
ऑब्जेक्ट
getTag()
मार्कर के लिए टैग लाता है.
स्ट्रिंग
getTitle()
मार्कर का शीर्षक प्राप्त करता है.
फ़्लोट
getZIndex()
मार्कर का zIndex दिखाता है.
int
hashCode()
अमान्य
hideInfoWindow()
अगर जानकारी विंडो को इस मार्कर से दिखाया जाता है, तो यह उसे छिपा देता है.
बूलियन
isDraggable()
मार्कर को खींचने और छोड़ने की सुविधा हासिल करता है.
बूलियन
isFlat()
मार्कर की फ़्लैट सेटिंग लागू करता है.
बूलियन
isInfoWindowShown()
यह लौटाता है कि जानकारी विंडो वर्तमान में इस मार्कर के ऊपर दिखाई जाती है या नहीं.
बूलियन
isVisible()
इस मार्कर की दृश्यता सेटिंग लाता है.
अमान्य
remove()
मैप से यह मार्कर निकालता है.
अमान्य
setAlpha(फ़्लोट ऐल्फ़ा)
मार्कर की अल्फ़ा (अपारदर्शिता) सेट करता है.
अमान्य
setAnchor(float anchorU, float anchorV)
मार्कर के लिए ऐंकर पॉइंट सेट करता है.
अमान्य
setDraggable(boolean draggable)
मार्कर को खींचने और छोड़ने की सुविधा सेट करता है.
अमान्य
setFlat(बूलियन फ़्लैट)
सेट करता है कि क्या यह मार्कर मैप true के सामने सपाट होना चाहिए या बिलबोर्ड के सामने false कैमरा.
अमान्य
setIcon(BitmapDescriptor iconDescriptor)
मार्कर के लिए आइकॉन सेट करता है.
अमान्य
setInfoWindowAnchor(फ़्लोट anchorU, float anchorV)
मार्कर इमेज में वह बिंदु बताता है जिस पर जानकारी विंडो को ऐंकर करना है दिखाया जाएगा.
अमान्य
setPosition(LatLng latlng)
मार्कर की जगह सेट करता है.
अमान्य
setRotation(फ़्लोट रोटेशन)
मार्कर का रोटेशन मार्कर के एंकर बिंदु के बारे में घड़ी की सुई की दिशा में डिग्री पर सेट करता है.
अमान्य
setSnippet(स्ट्रिंग स्निपेट)
मार्कर का स्निपेट सेट करता है.
अमान्य
setTag(ऑब्जेक्ट टैग)
मार्कर के लिए टैग सेट करता है.
अमान्य
setTitle(स्ट्रिंग का शीर्षक)
मार्कर का शीर्षक सेट करता है.
अमान्य
setVisible(boolean visible)
इस मार्कर की दृश्यता सेट करता है.
अमान्य
setZIndex(फ़्लोट zIndex)
मार्कर का zIndex सेट करता है.
अमान्य
showInfoWindow()
अगर यह मार्कर isVisible() है, तो मैप पर इस मार्कर की जानकारी विंडो दिखाता है.

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

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

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

जांच करता है कि यह Marker, दूसरे के बराबर है या नहीं.

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

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

मार्कर का अल्फ़ा प्राप्त करता है.

रिटर्न
  • मार्कर की ऐल्फ़ा वैल्यू [0, 1] की रेंज में है.

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

इस मार्कर की आईडी प्राप्त करता है. यह आईडी, मैप पर मौजूद सभी मार्कर के लिए यूनीक होगा.

रिटर्न
  • इस मार्कर की आईडी.

सार्वजनिक LatLng getPosition ()

मार्कर की स्थिति दिखाता है.

रिटर्न
  • मार्कर की मौजूदा स्थिति बताने वाला LatLng ऑब्जेक्ट.

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

इससे मार्कर को घुमाया जाता है.

रिटर्न
  • डिफ़ॉल्ट स्थिति से घड़ी की सुई की दिशा में डिग्री में मार्कर का रोटेशन.

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

मार्कर का स्निपेट लाता है.

रिटर्न
  • मार्कर के स्निपेट वाली एक स्ट्रिंग.

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

मार्कर के लिए टैग लाता है.

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

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

मार्कर का शीर्षक प्राप्त करता है.

रिटर्न
  • मार्कर के टाइटल वाली स्ट्रिंग.

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

मार्कर का zIndex दिखाता है.

रिटर्न
  • इस मार्कर का zIndex.

सार्वजनिक आईएनटी hashCode ()

सार्वजनिक अमान्य hideInfoWindow ()

अगर जानकारी विंडो को इस मार्कर से दिखाया जाता है, तो यह उसे छिपा देता है.

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

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

मार्कर को खींचने और छोड़ने की सुविधा हासिल करता है. जब मार्कर को खींचकर छोड़ा जा सकता है, तब उपयोगकर्ता उसे दूसरी जगह ले जा सकता है दबाकर रखें.

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

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

मार्कर की फ़्लैट सेटिंग लागू करता है.

रिटर्न
  • true अगर मार्कर मैप के सामने सपाट है; false अगर मार्कर को का सामना करना पड़ता है.

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

यह लौटाता है कि जानकारी विंडो वर्तमान में इस मार्कर के ऊपर दिखाई जाती है या नहीं. इसे स्वीकार नहीं किया जाता है जानकारी विंडो असल में स्क्रीन पर दिख रही है या नहीं.

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

इस मार्कर की दृश्यता सेटिंग लाता है. ध्यान दें कि इससे यह पता नहीं चलता कि मार्कर स्क्रीन के व्यूपोर्ट में मौजूद है. यह बताता है कि मार्कर बनाया जाएगा या नहीं, अगर यह जो स्क्रीन के व्यूपोर्ट में मौजूद होता है.

रिटर्न
  • इस मार्कर की दृश्यता.

सार्वजनिक अमान्य हटाएं ()

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

सार्वजनिक अमान्य setAlpha (फ़्लोट ऐल्फ़ा)

मार्कर की अल्फ़ा (अपारदर्शिता) सेट करता है. यह 0 से 1 तक का कोई मान होता है, जहां 0 का मतलब मार्कर पूरी तरह पारदर्शी है और 1 का मतलब है कि मार्कर पूरी तरह से अपारदर्शी है.

पैरामीटर
ऐल्फ़ा

सार्वजनिक अमान्य setAnchor (float anchorU, float anchorV)

मार्कर के लिए ऐंकर पॉइंट सेट करता है.

ऐंकर, आइकॉन इमेज में वह पॉइंट तय करता है जो मार्कर की पोज़िशन से जुड़ा होता है पृथ्वी की सतह पर रहते हैं.

ऐंकर पॉइंट की जानकारी, कंटिन्यूअस स्पेस [0.0, 1.0] x [0.0, 1.0] में दी गई है, जहां (0, 0) इमेज का सबसे ऊपर बायां कोना होता है और (1, 1) सबसे नीचे दायां कोना होता है. ऐंकरिंग पॉइंट W x H इमेज में, (W + 1) x में सबसे नज़दीकी ग्रिड पॉइंट होता है (H + 1) ग्रिड, जिसे स्केल करके फिर पूर्णांक बनाया जाता है. उदाहरण के लिए, चार x 2 साइज़ की इमेज में, ऐंकर पॉइंट (0.7, 0.6) का मतलब ग्रिड पॉइंट (3, 1) पर है. 

 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----+-----+
 |     |     |   X |     |   (U, V) = (0.7, 0.6)
 |     |     |     |     |
 *-----+-----+-----+-----*
 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----X-----+   (X, Y) = (3, 1)
 |     |     |     |     |
 |     |     |     |     |
 *-----+-----+-----+-----*

पैरामीटर
anchorU ऐंकर का u-कोऑर्डिनेट, इमेज की चौड़ाई ([0, 1] की रेंज में) के अनुपात के तौर पर.
anchorV ऐंकर का v-कोऑर्डिनेट, इमेज की ऊंचाई के अनुपात के तौर पर ([0, 1]).

सार्वजनिक अमान्य setDraggable (बूलियन ड्रैग किया जा सकता है)

मार्कर को खींचने और छोड़ने की सुविधा सेट करता है. जब मार्कर को खींचकर छोड़ा जा सकता है, तब उपयोगकर्ता उसे दूसरी जगह ले जा सकता है दबाकर रखें.

पैरामीटर
खींचने और छोड़ने लायक एलिमेंट

सार्वजनिक अमान्य setFlat (बूलियन फ़्लैट)

सेट करता है कि क्या यह मार्कर मैप true के सामने सपाट होना चाहिए या बिलबोर्ड के सामने false कैमरा.

पैरामीटर
कोई बदलाव नहीं

सार्वजनिक अमान्य setIcon (BitmapDescriptor iconDescriptor)

मार्कर के लिए आइकॉन सेट करता है.

पैरामीटर
iconDescriptor अगर यह खाली है, तो डिफ़ॉल्ट मार्कर का इस्तेमाल किया जाता है.

सार्वजनिक अमान्य setInfoWindowAnchor (float anchorU, float anchorV)

मार्कर इमेज में वह बिंदु बताता है जिस पर जानकारी विंडो को ऐंकर करना है दिखाया जाएगा. यह उसी कोऑर्डिनेट सिस्टम में मौजूद है जिसमें ऐंकर बताया गया है. ज़्यादा जानकारी के लिए, setAnchor(float, float) पर जाएं. इमेज के ऊपरी बीच में डिफ़ॉल्ट विकल्प होता है.

पैरामीटर
anchorU जानकारी विंडो ऐंकर का u-कोऑर्डिनेट, इमेज की चौड़ाई के अनुपात ( रेंज [0, 1]).
anchorV जानकारी विंडो ऐंकर का v-कोऑर्डिनेट, इमेज की ऊंचाई के अनुपात के तौर पर ( रेंज [0, 1]).

सार्वजनिक अमान्य setPosition (LatLng latlng)

मार्कर की जगह सेट करता है.

पैरामीटर
लातविया

सार्वजनिक अमान्य setRotation (फ़्लोट रोटेशन)

मार्कर का रोटेशन मार्कर के एंकर बिंदु के बारे में घड़ी की सुई की दिशा में डिग्री पर सेट करता है. द ऐक्सिस का रोटेशन मार्कर के लंबवत है. 0 का रोटेशन डिफ़ॉल्ट स्थिति से मेल खाता है क्लिक करें.

पैरामीटर
रोटेशन

सार्वजनिक अमान्य setSnippet (स्ट्रिंग स्निपेट)

मार्कर का स्निपेट सेट करता है.

पैरामीटर
स्निपेट अगर वैल्यू खाली है, तो स्निपेट को मिटा दिया जाता है.

सार्वजनिक अमान्य setTag (ऑब्जेक्ट टैग)

मार्कर के लिए टैग सेट करता है.

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

पैरामीटर
टैग अगर यह खाली है, तो टैग हटा दिया जाता है.

सार्वजनिक अमान्य setTitle (स्ट्रिंग का टाइटल)

मार्कर का शीर्षक सेट करता है.

पैरामीटर
title अगर यह खाली है, तो टाइटल हटा दिया जाता है.

सार्वजनिक अमान्य setVisible (बूलियन के तौर पर दिख रहा है)

इस मार्कर की दृश्यता सेट करता है. अगर false पर सेट है और जानकारी विंडो अभी इस मार्कर के लिए खोज रहे हैं, तो इससे जानकारी विंडो छिप जाएगी.

पैरामीटर
दिख रहा है

सार्वजनिक अमान्य setZIndex (फ़्लोट zइंडेक्स)

मार्कर का zIndex सेट करता है.

पैरामीटर
zIndex

सार्वजनिक अमान्य showInfoWindow ()

अगर यह मार्कर isVisible() है, तो मैप पर इस मार्कर की जानकारी विंडो दिखाता है.

थ्रो
IllegalArgumentException अगर marker इस मैप पर नहीं है