जानकारी विंडो

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript

एक जानकारी विंडो, जिसमें मैप के ऊपर पॉप-अप विंडो में टेक्स्ट या इमेज दिख रही हैं. जानकारी वाली विंडो हमेशा किसी मार्कर से ऐंकर की जाती हैं. डिफ़ॉल्ट रूप से, मार्कर पर टैप करने पर ये विकल्प दिखते हैं.

कोड सैंपल

GitHub पर मौजूद ApiDemos डेटा स्टोर करने की जगह में एक उदाहरण दिया गया है. इसमें, जानकारी वाले विंडो की सभी सुविधाओं के बारे में बताया गया है:

• MarkerDemoActivity - Java: जानकारी वाली विंडो को पसंद के मुताबिक बनाना और जानकारी वाली विंडो के लिसनर का इस्तेमाल करना
• MarkerDemoActivity - Kotlin: जानकारी विंडो को पसंद के मुताबिक बनाना और जानकारी विंडो लिसनर का इस्तेमाल करना

परिचय

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

जानकारी वाली विंडो, डिवाइस की स्क्रीन के हिसाब से ओरिएंट की जाती है. यह विंडो, उससे जुड़े मार्कर के ऊपर, बीच में दिखती है. डिफ़ॉल्ट जानकारी विंडो में शीर्षक बोल्ड में होता है और शीर्षक के नीचे (वैकल्पिक) स्निपेट टेक्स्ट होता है.

जानकारी वाली विंडो जोड़ें

जानकारी वाला विंडो जोड़ने का सबसे आसान तरीका यह है कि उससे जुड़े मार्कर के title() और snippet() तरीकों को सेट करें. इन प्रॉपर्टी को सेट करने से जब भी उस मार्कर पर क्लिक किया जाएगा, तब एक जानकारी विंडो दिखेगी.

Kotlin

val melbourneLatLng = LatLng(-37.81319, 144.96298)
val melbourne = map.addMarker(
    MarkerOptions()
        .position(melbourneLatLng)
        .title("Melbourne")
        .snippet("Population: 4,137,400")
)

      

Java

final LatLng melbourneLatLng = new LatLng(-37.81319, 144.96298);
Marker melbourne = map.addMarker(
    new MarkerOptions()
        .position(melbourneLatLng)
        .title("Melbourne")
        .snippet("Population: 4,137,400"));

      

जानकारी वाली विंडो दिखाना/छिपाना

जानकारी विंडो, उपयोगकर्ता के टच इवेंट का जवाब देने के लिए डिज़ाइन की गई हैं. अगर आप चाहें, तो टारगेट मार्कर पर showInfoWindow() को कॉल करके, प्रोग्राम के हिसाब से जानकारी वाला विंडो दिखाया जा सकता है. hideInfoWindow() पर कॉल करके, जानकारी विंडो को छिपाया जा सकता है.

Kotlin

val melbourneLatLng = LatLng(-37.81319, 144.96298)
val melbourne = map.addMarker(
    MarkerOptions()
        .position(melbourneLatLng)
        .title("Melbourne")
)
melbourne?.showInfoWindow()

      

Java

final LatLng melbourneLatLng = new LatLng(-37.81319, 144.96298);
Marker melbourne = map.addMarker(
    new MarkerOptions()
        .position(melbourneLatLng)
        .title("Melbourne"));
melbourne.showInfoWindow();

      

आप अलग-अलग क्लस्टर किए गए मार्कर के लिए जानकारी विंडो भी बना सकते हैं. क्लस्टर किए गए अलग-अलग मार्कर के लिए जानकारी वाला विंडो जोड़ने के बारे में गाइड पढ़ें.

कस्टम जानकारी वाली विंडो

आपके पास जानकारी वाली विंडो के कॉन्टेंट और डिज़ाइन को पसंद के मुताबिक बनाने का विकल्प भी होता है. ऐसा करने के लिए, आपको InfoWindowAdapter इंटरफ़ेस को लागू करना होगा. इसके बाद, अपने लागू किए गए इंटरफ़ेस के साथ GoogleMap.setInfoWindowAdapter() को कॉल करें. इंटरफ़ेस में, इसे लागू करने के दो तरीके हैं: getInfoWindow(Marker) और getInfoContents(Marker). एपीआई सबसे पहले getInfoWindow(Marker) को कॉल करेगा. अगर null दिखता है, तो वह getInfoContents(Marker) को कॉल करेगा. अगर इससे null भी मिलता है, तो जानकारी वाली डिफ़ॉल्ट विंडो का इस्तेमाल किया जाएगा.

इनमें से पहले विकल्प (getInfoWindow()) की मदद से, ऐसा व्यू दिया जा सकता है जिसका इस्तेमाल पूरी जानकारी वाली विंडो के लिए किया जाएगा. इनमें से दूसरे विकल्प (getInfoContents()) की मदद से, विंडो के कॉन्टेंट को पसंद के मुताबिक बनाया जा सकता है. हालांकि, जानकारी वाली विंडो का डिफ़ॉल्ट फ़्रेम और बैकग्राउंड पहले जैसा ही रहेगा.

ध्यान दें: जानकारी देने वाली जो विंडो बनाई गई है वह लाइव व्यू नहीं है. व्यू को वापस करने के समय, उसे View.draw(Canvas) का इस्तेमाल करके इमेज के तौर पर रेंडर किया जाता है. इसका मतलब है कि व्यू में किए गए किसी भी बदलाव के बाद, मैप पर मौजूद जानकारी वाली विंडो में वह बदलाव नहीं दिखेगा. जानकारी वाली विंडो को बाद में अपडेट करने के लिए, जैसे कि इमेज लोड होने के बाद, showInfoWindow() को कॉल करें. इसके अलावा, जानकारी विंडो सामान्य व्यू के लिए आम तौर पर होने वाली इंटरैक्टिविटी, जैसे कि टच या जेस्चर इवेंट पर ध्यान नहीं देगी. हालांकि, पूरी जानकारी वाली विंडो पर सामान्य क्लिक इवेंट को सुना जा सकता है. इसके बारे में नीचे दिए गए सेक्शन में बताया गया है.

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

जानकारी वाली विंडो के इवेंट

MarkerDemoActivity सैंपल में, जानकारी विंडो इवेंट को रजिस्टर और मैनेज करने के लिए उदाहरण के कोड को शामिल किया गया है.

जानकारी देने वाली विंडो में क्लिक करके इवेंट सुनने के लिए, OnInfoWindowClickListener का इस्तेमाल किया जा सकता है. इस लिसनर को मैप पर सेट करने के लिए, GoogleMap.setOnInfoWindowClickListener(OnInfoWindowClickListener) को कॉल करें. जब कोई उपयोगकर्ता, जानकारी वाली विंडो पर क्लिक करता है, तो onInfoWindowClick(Marker) को कॉल किया जाता है. साथ ही, जानकारी विंडो को हाइलाइट करने के डिफ़ॉल्ट रंग (सलेटी) में हाइलाइट कर दिया जाता है.

Kotlin

internal inner class InfoWindowActivity : AppCompatActivity(),
    OnInfoWindowClickListener,
    OnMapReadyCallback {
    override fun onMapReady(googleMap: GoogleMap) {
        // Add markers to the map and do other map setup.
        // ...
        // Set a listener for info window events.
        googleMap.setOnInfoWindowClickListener(this)
    }

    override fun onInfoWindowClick(marker: Marker) {
        Toast.makeText(
            this, "Info window clicked",
            Toast.LENGTH_SHORT
        ).show()
    }
}

      

Java

class InfoWindowActivity extends AppCompatActivity implements
    GoogleMap.OnInfoWindowClickListener,
    OnMapReadyCallback {

    @Override
    public void onMapReady(GoogleMap googleMap) {
        // Add markers to the map and do other map setup.
        // ...
        // Set a listener for info window events.
        googleMap.setOnInfoWindowClickListener(this);
    }

    @Override
    public void onInfoWindowClick(Marker marker) {
        Toast.makeText(this, "Info window clicked",
            Toast.LENGTH_SHORT).show();
    }
}

      

इसी तरह, OnInfoWindowLongClickListener की मदद से, लंबे क्लिक वाले इवेंट सुने जा सकते हैं. इसे GoogleMap.setOnInfoWindowCloseListener(OnInfoWindowCloseListener) को कॉल करके सेट किया जा सकता है. यह लिसनर, क्लिक लिसनर की तरह काम करता है और इसे onInfoWindowClose(Marker) कॉलबैक से, लंबे समय तक क्लिक करने पर सूचना दी जाएगी.

जानकारी विंडो बंद होने पर सूचना पाने के लिए, OnInfoWindowCloseListener का इस्तेमाल करें. इसे GoogleMap.setOnInfoWindowCloseListener(OnInfoWindowCloseListener) को कॉल करके सेट किया जा सकता है. आपको onInfoWindowClose(Marker) कॉलबैक मिलेगा.

जानकारी वाली विंडो को रीफ़्रेश करने के बारे में जानकारी: अगर उपयोगकर्ता, किसी ऐसे मार्कर पर टैप करके जानकारी वाली विंडो को रीफ़्रेश करता है जिस पर पहले से ही जानकारी वाली विंडो खुली है, तो onInfoWindowClose() इवेंट ट्रिगर होता है. हालांकि, अगर किसी खुली जानकारी वाली विंडो पर प्रोग्राम के हिसाब से Marker.showInfoWindow() को कॉल किया जाता है, तो onInfoWindowClose() इवेंट ट्रिगर नहीं होता. बाद वाला व्यवहार इस धारणा पर आधारित है कि आपको पता है कि जानकारी वाली विंडो बंद हो जाएगी और फिर से खुल जाएगी.

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