Google Maps Android मार्कर क्लस्टरिंग यूटिलिटी

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

अपने मार्कर को क्लस्टर करके, आप मैप को पढ़ने में मुश्किल बनाए बिना, मैप पर बड़ी संख्या में मार्कर रख सकते हैं.

शुरुआती जानकारी

इस वीडियो में मार्कर क्लस्टर के इस्तेमाल के बारे में बताया गया है. ऐसा तब किया जाता है, जब मैप पर आपके डेटा से जुड़े डेटा की बड़ी संख्या की ज़रूरत होती है.

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

जब कोई उपयोगकर्ता मैप को ज़्यादा ज़ूम लेवल पर देखता है, तो मैप पर अलग-अलग मार्कर दिखते हैं. जब उपयोगकर्ता ज़ूम आउट करता है, तो मार्कर को क्लस्टर में एक साथ रखा जाता है, ताकि मैप को आसानी से देखा जा सके. मार्कर क्लस्टरिंग सुविधा Android Utility लाइब्रेरी के लिए Maps SDK टूल का हिस्सा है. अगर आपने अभी तक लाइब्रेरी सेट अप नहीं की है, तो इस पेज के बाकी हिस्से को पढ़ने से पहले, सेट अप गाइड में दिए गए निर्देशों का पालन करें.

क्लस्टर मार्कर

मार्कर क्लस्टरिंग यूटिलिटी का इस्तेमाल करने के लिए, आपको ClusterManager में मार्कर को ClusterItem ऑब्जेक्ट के रूप में जोड़ना होगा. ClusterManager, मार्कर को Algorithm पर भेजता है, जो उन्हें क्लस्टर के सेट में बदल देता है. ClusterRenderer में क्लस्टर और अलग-अलग मार्कर को जोड़कर और हटाकर रेंडरिंग का ध्यान रखा जाता है. ClusterRenderer और Algorithm प्लग किए जा सकते हैं. इन्हें पसंद के मुताबिक बनाया जा सकता है.

उपयोगिता लाइब्रेरी एक डेमो ऐप्लिकेशन के साथ शिप होती है, जिसमें मार्कर क्लस्टरिंग सुविधा के नमूने लागू किए जाते हैं. डेमो ऐप्लिकेशन चलाने में मदद पाने के लिए, सेट अप गाइड देखें. डेमो ऐप्लिकेशन में, मार्कर क्लस्टर करने वाले ये सैंपल शामिल हैं:

• ClusteringDemoActivity: मार्कर क्लस्टर बनाने की सुविधा दिखाने वाली आसान गतिविधि.
• BigClusteringDemoActivity: 2 000 मार्कर के साथ क्लस्टरिंग.
• CustomMarkerClusteringDemoActivity: क्लस्टर किए गए मार्कर के लिए कस्टम डिज़ाइन बनाया जा रहा है.

एक आसान मार्कर क्लस्टर जोड़ें

आसान तरीके से दस मार्कर बनाने के लिए, नीचे दिया गया तरीका अपनाएं. नतीजा कुछ इस तरह दिखेगा. हालांकि, ज़ूम लेवल के हिसाब से दिखने वाले/क्लस्टर किए गए मार्कर की संख्या बदल जाएगी:

10 से ज़्यादा क्लस्टर वाले मार्कर

यहां ज़रूरी चरणों की खास जानकारी दी गई है:

1. मैप पर मार्कर दिखाने के लिए ClusterItem लागू करें. क्लस्टर आइटम, मार्कर की जगह LatLng ऑब्जेक्ट के तौर पर दिखाता है. साथ ही, यह वैकल्पिक शीर्षक या स्निपेट दिखाता है.
2. ज़ूम लेवल के आधार पर क्लस्टर आइटम (मार्कर) को ग्रुप करने के लिए नया ClusterManager जोड़ें.
3. मैप और OnCameraIdleListener() को ClusterManager पर सेट करें, क्योंकि ClusterManager लिसनर को लागू करता है.
4. अगर आप मार्कर क्लिक इवेंट में किसी खास फ़ंक्शन को जोड़ना चाहते हैं, तो मैप और OnMarkerClickListener() को ClusterManager पर सेट करें, क्योंकि ClusterManager लिसनर लागू करता है.
5. मार्कर को ClusterManager में फ़ीड करें.

चरणों को ज़्यादा बारीकी से देखें: दस मार्कर का हमारा आसान क्लस्टर बनाने के लिए, पहले ClusterItem लागू करने वाली MyItem क्लास बनाएं.

Java

public class MyItem implements ClusterItem {
    private final LatLng position;
    private final String title;
    private final String snippet;

    public MyItem(double lat, double lng, String title, String snippet) {
        position = new LatLng(lat, lng);
        this.title = title;
        this.snippet = snippet;
    }

    @Override
    public LatLng getPosition() {
        return position;
    }

    @Override
    public String getTitle() {
        return title;
    }

    @Override
    public String getSnippet() {
        return snippet;
    }

    @Nullable
    @Override
    public Float getZIndex() {
        return 0f;
    }
}

      

Kotlin

inner class MyItem(
    lat: Double,
    lng: Double,
    title: String,
    snippet: String
) : ClusterItem {

    private val position: LatLng
    private val title: String
    private val snippet: String

    override fun getPosition(): LatLng {
        return position
    }

    override fun getTitle(): String {
        return title
    }

    override fun getSnippet(): String {
        return snippet
    }

    override fun getZIndex(): Float {
        return 0f
    }

    init {
        position = LatLng(lat, lng)
        this.title = title
        this.snippet = snippet
    }
}

      

मैप पर अपनी गतिविधि में ClusterManager जोड़ें. साथ ही, इसे क्लस्टर आइटम फ़ीड करें. टाइप आर्ग्युमेंट <MyItem> पर ध्यान दें. इस वैरिएबल में ClusterManager को MyItem टाइप के तौर पर बताया जाता है.

Java

// Declare a variable for the cluster manager.
private ClusterManager<MyItem> clusterManager;

private void setUpClusterer() {
    // Position the map.
    map.moveCamera(CameraUpdateFactory.newLatLngZoom(new LatLng(51.503186, -0.126446), 10));

    // Initialize the manager with the context and the map.
    // (Activity extends context, so we can pass 'this' in the constructor.)
    clusterManager = new ClusterManager<MyItem>(context, map);

    // Point the map's listeners at the listeners implemented by the cluster
    // manager.
    map.setOnCameraIdleListener(clusterManager);
    map.setOnMarkerClickListener(clusterManager);

    // Add cluster items (markers) to the cluster manager.
    addItems();
}

private void addItems() {

    // Set some lat/lng coordinates to start with.
    double lat = 51.5145160;
    double lng = -0.1270060;

    // Add ten cluster items in close proximity, for purposes of this example.
    for (int i = 0; i < 10; i++) {
        double offset = i / 60d;
        lat = lat + offset;
        lng = lng + offset;
        MyItem offsetItem = new MyItem(lat, lng, "Title " + i, "Snippet " + i);
        clusterManager.addItem(offsetItem);
    }
}

      

Kotlin

// Declare a variable for the cluster manager.
private lateinit var clusterManager: ClusterManager<MyItem>

private fun setUpClusterer() {
    // Position the map.
    map.moveCamera(CameraUpdateFactory.newLatLngZoom(LatLng(51.503186, -0.126446), 10f))

    // Initialize the manager with the context and the map.
    // (Activity extends context, so we can pass 'this' in the constructor.)
    clusterManager = ClusterManager(context, map)

    // Point the map's listeners at the listeners implemented by the cluster
    // manager.
    map.setOnCameraIdleListener(clusterManager)
    map.setOnMarkerClickListener(clusterManager)

    // Add cluster items (markers) to the cluster manager.
    addItems()
}

private fun addItems() {

    // Set some lat/lng coordinates to start with.
    var lat = 51.5145160
    var lng = -0.1270060

    // Add ten cluster items in close proximity, for purposes of this example.
    for (i in 0..9) {
        val offset = i / 60.0
        lat += offset
        lng += offset
        val offsetItem =
            MyItem(lat, lng, "Title $i", "Snippet $i")
        clusterManager.addItem(offsetItem)
    }
}

      

आप ज़ूम इन और आउट करते समय, क्लस्टरिंग ऐनिमेशन बंद कर सकते हैं. अगर ऐनिमेशन बंद है, तो मार्कर, क्लस्टर में और उसके बाहर माइग्रेट करने के बजाय पोज़िशन पर फ़िट हो जाते हैं. ऐनिमेशन बंद करने के लिए, ClusterManager में setAnimation() का इस्तेमाल करें, जैसा कि नीचे दिखाया गया है:

Java

clusterManager.setAnimation(false);

      

Kotlin

clusterManager.setAnimation(false)

      

अलग-अलग क्लस्टर किए गए मार्कर के लिए जानकारी विंडो जोड़ें

क्लस्टर किए गए खास मार्कर के लिए जानकारी विंडो जोड़ने के लिए, ClusterItem के लागू होने वाले कंस्ट्रक्टर में शीर्षक और स्निपेट स्ट्रिंग जोड़ें.

इस उदाहरण में, addItems() तरीके में एक जानकारी विंडो वाला मार्कर जोड़ा गया है. इसमें शीर्षक और स्निपेट सेट किया गया है:

Java

// Set the lat/long coordinates for the marker.
double lat = 51.5009;
double lng = -0.122;

// Set the title and snippet strings.
String title = "This is the title";
String snippet = "and this is the snippet.";

// Create a cluster item for the marker and set the title and snippet using the constructor.
MyItem infoWindowItem = new MyItem(lat, lng, title, snippet);

// Add the cluster item (marker) to the cluster manager.
clusterManager.addItem(infoWindowItem);

      

Kotlin

// Set the lat/long coordinates for the marker.
val lat = 51.5009
val lng = -0.122

// Set the title and snippet strings.
val title = "This is the title"
val snippet = "and this is the snippet."

// Create a cluster item for the marker and set the title and snippet using the constructor.
val infoWindowItem = MyItem(lat, lng, title, snippet)

// Add the cluster item (marker) to the cluster manager.
clusterManager.addItem(infoWindowItem)

      

मार्कर क्लस्टर कस्टमाइज़ करें

ClusterManager कंस्ट्रक्टर, DefaultClusterRenderer और NonHierarchicalDistanceBasedAlgorithm बनाता है. आप ClusterManager और setAlgorithm(Algorithm<T> algorithm) के setRenderer(ClusterRenderer<T> view) तरीकों का इस्तेमाल करके, ClusterRenderer और Algorithm को बदल सकते हैं.

क्लस्टर की रेंडरिंग को पसंद के मुताबिक बनाने के लिए, ClusterRenderer को लागू किया जा सकता है. DefaultClusterRenderer, शुरू करने के लिए अच्छा आधार है. DefaultClusterRenderer को सब-क्लास करके, डिफ़ॉल्ट सेटिंग को बदला जा सकता है.

पसंद के मुताबिक बनाने के बारे में ज़्यादा जानकारी के लिए, डेमो ऐप्लिकेशन में CustomMarkerClusteringDemoActivity पर एक नज़र डालें, जो यूटिलिटी लाइब्रेरी के साथ दिखता है.

कस्टम क्लस्टर मार्कर

CustomMarkerClusteringDemoActivity अपना क्लस्टर आइटम, Person की जानकारी देता है, और इसे DefaultClusterRenderer को PersonRenderer के तौर पर बढ़ाकर रेंडर करता है.

डेमो में यह भी दिखाया गया है कि ClusterManager.OnClusterClickListener<Person> इंटरफ़ेस को कैसे लागू किया जाता है, ताकि क्लस्टर पर क्लिक किए जाने पर व्यक्ति की ज़्यादा जानकारी दिखाई जा सके. इसी तरह, ClusterManager.OnClusterItemClickListener<Person> को भी इसी तरह लागू किया जा सकता है.

डेमो ऐप्लिकेशन चलाने में मदद पाने के लिए, सेट अप गाइड देखें.