Утилита для работы с несколькими слоями Google Maps Multilayer Utility

  1. Введение
  2. Как добавить несколько слоев кластеров, KML и GeoJSON
  3. Как добавить собственные объекты на карту
  4. Как обрабатывать события кликов
  5. Демонстрационное приложение

Введение

В предыдущих разделах руководства мы рассказали, как добавлять на карту объекты из данных KML и GeoJSON, а также кластеры маркеров. Но что, если вам нужно добавить несколько таких слоев на одну карту и отслеживать события кликов отдельно для каждого слоя?

Как добавить несколько слоев кластеров, 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)
      

Затем вы сможете передать эти классы Manager конструкторам слоев:

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
)
      

Как добавить собственные объекты на карту

Создавать собственные маркеры, наземные наложения, ломаные линии или многоугольники напрямую в объекте GoogleMap не рекомендуется. Советуем вместо этого создать собственный класс Collection, а затем добавлять нужные объекты с помощью Managers. Например, чтобы добавить маркер, используйте приведенный ниже код:

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 в демонстрационном приложении из библиотеки утилит. В руководстве по настройке рассказывается, как запустить демонстрационное приложение.