Google 地圖多圖層公用程式

1. 簡介
2. 新增多個叢集、KML 和 GeoJSON 圖層
3. 新增地圖項目
4. 處理點擊事件
5. 查看試用版應用程式

簡介

我們在先前的教學課程中，解說了如何在地圖上新增 KML 和 GeoJSON 地圖項目以及標記叢集。但如果想在同一張地圖上新增多個這類圖層，並取得個別圖層的點擊事件，該怎麼做？

新增多個叢集、KML 和 GeoJSON 圖層

程式庫提供 Manager 物件，協助您管理不同類型圖層的點擊事件。因此，設定圖層之前，您必須先對這些物件執行個體化，然後再傳遞至 GoogleMap：

MarkerManager markerManager = new MarkerManager(map);
GroundOverlayManager groundOverlayManager = new GroundOverlayManager(map);
PolygonManager polygonManager = new PolygonManager(map);
PolylineManager polylineManager = new PolylineManager(map);

      

val markerManager = MarkerManager(map)
val groundOverlayManager = GroundOverlayManager(map!!)
val polygonManager = PolygonManager(map)
val polylineManager = PolylineManager(map)

      

接著，您可以在設定這些管理員類別時，將其傳遞到其他圖層的建構函式：

ClusterManager<MyItem> clusterManager = new ClusterManager<>(context, map, markerManager);
GeoJsonLayer geoJsonLineLayer = new GeoJsonLayer(map, R.raw.geojson_file, context, markerManager, polygonManager, polylineManager, groundOverlayManager);
KmlLayer kmlPolylineLayer = new KmlLayer(map, R.raw.kml_file, context, markerManager, polygonManager, polylineManager, groundOverlayManager, null);

      

val clusterManager =
    ClusterManager<MyItem>(context, map, markerManager)
val geoJsonLineLayer = GeoJsonLayer(
    map,
    R.raw.geojson_file,
    context,
    markerManager,
    polygonManager,
    polylineManager,
    groundOverlayManager
)
val kmlPolylineLayer = KmlLayer(
    map,
    R.raw.kml_file,
    context,
    markerManager,
    polygonManager,
    polylineManager,
    groundOverlayManager,
    null
)

      

新增地圖項目

如要在設定這些圖層時一起新增標記、區域疊加層、折線或多邊形，請建立自己的 Collection，然後使用 Managers 新增地圖項目 (而非直接將地圖項目新增至 GoogleMap 物件)。舉例來說，新增標記的做法如下：

MarkerManager.Collection markerCollection = markerManager.newCollection();
markerCollection.addMarker(new MarkerOptions()
    .position(new LatLng(51.150000, -0.150032))
    .icon(BitmapDescriptorFactory.defaultMarker(BitmapDescriptorFactory.HUE_AZURE))
    .title("Unclustered marker"));

      

val markerCollection =
    markerManager.newCollection()
markerCollection.addMarker(
    MarkerOptions()
        .position(LatLng(51.150000, -0.150032))
        .icon(BitmapDescriptorFactory.defaultMarker(BitmapDescriptorFactory.HUE_AZURE))
        .title("Unclustered marker")
)

      

處理點擊事件

對叢集、KML 和 GeoJSON 來說，點擊事件監聽器將會照常運作，前提是您要將 Manager 類別傳遞至要設定的圖層所屬的建構函式中。以下範例說明如何為 KML 圖層設定點擊事件監聽器：

kmlPolylineLayer.addLayerToMap();
kmlPolylineLayer.setOnFeatureClickListener(feature -> Toast.makeText(context,
    "KML polyline clicked: " + feature.getProperty("name"),
    Toast.LENGTH_SHORT).show());

      

kmlPolylineLayer.addLayerToMap()
kmlPolylineLayer.setOnFeatureClickListener { feature: Feature ->
    Toast.makeText(context,
        "KML polyline clicked: ${feature.getProperty("name")}",
        Toast.LENGTH_SHORT
    ).show()
}

      

當您新增自己的標記、區域疊加層、折線或多邊形時，請務必將點擊事件監聽器新增至這些 Collection 物件。以下範例說明如何在 markerCollection 上設定標記點擊事件監聽器：

markerCollection.setOnMarkerClickListener(marker -> { Toast.makeText(context,
    "Marker clicked: " + marker.getTitle(),
        Toast.LENGTH_SHORT).show();
    return false;
});

      

markerCollection.setOnMarkerClickListener { marker: Marker ->
    Toast.makeText(
        context,
        "Marker clicked: ${marker.title}",
        Toast.LENGTH_SHORT
    ).show()
    false
}

      

查看試用版應用程式

如需新增多個圖層的範例，請前往公用程式庫隨附的試用版應用程式中查看 MultiLayerDemoActivity。設定指南會示範如何執行試用版應用程式。