Google 地图多图层实用程序

  1. 简介
  2. 添加多个聚类、KML 和 GeoJSON 图层
  3. 添加您自己的地图项
  4. 处理点击事件
  5. 观摩演示版应用

简介

在之前的教程中,您学习了如何将 KMLGeoJSON 地图项添加到地图,以及如何添加标记的聚类。但是,如果您想在同一个地图中添加多个这样的图层,然后单独获取每个图层的点击事件,该怎么操作呢?

添加多个聚类、KML 和 GeoJSON 图层

该库包含 Manager 对象,可帮助管理多种类型的图层的点击事件。因此,在设置图层之前,您需要先将这些图层实例化并传入您的 GoogleMap

Java

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

Kotlin

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

接下来,您可以在设置其他图层时,将这些管理器类传递到图层的构造函数中:

Java

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

Kotlin

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 对象中。添加新标记的示例如下:

Java

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

Kotlin

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 图层设置点击监听器:

Java

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

Kotlin

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

当您添加自己的标记、地面叠加层、多段线或多边形时,只需确保向这些 Collection 对象添加点击监听器即可。以下示例展示了如何在 markerCollection 上设置标记点击监听器:

Java

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

Kotlin

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

观摩演示版应用

如需查看添加多个图层的示例,请看一看实用程序库附带的演示版应用中的 MultiLayerDemoActivity设置指南向您介绍了如何运行演示版应用。