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

संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.
प्लैटफ़ॉर्म चुनें: Android iOS JavaScript

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

कोड सैंपल

GitHub पर ApiDemos डेटा स्टोर करने की जगह में एक नमूना शामिल होता है. इस नमूने में जानकारी वाली विंडो की सभी सुविधाएं दिखती हैं:

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

सुविधा के बारे में जानकारी

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

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

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

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

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"));

Kotlin


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

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

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

Java


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

Kotlin


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

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

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

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

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

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

जानकारी विंडो की तुलना

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

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

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

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();
    }
}

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()
    }
}

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

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

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

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