Utilitário multicamadas do Google Maps

  1. Introdução
  2. Como adicionar várias camadas de cluster, KML e GeoJSON
  3. Como adicionar seus próprios recursos
  4. Processamento de eventos de clique
  5. Ver o app de demonstração

Introdução

Nos outros tutoriais, você aprendeu como adicionar recursos do KML e GeoJSON ao seu mapa, além dos clusters dos marcadores. Mas e se você quiser adicionar várias dessas camadas ao mesmo mapa e conseguir eventos de clique independentes para cada uma delas?

Como adicionar várias camadas de cluster, KML e GeoJSON

A biblioteca inclui objetos Manager para ajudar a gerenciar eventos de cliques para vários tipos de camadas. Sendo assim, antes de configurar suas camadas, é necessário instanciá-las e passar o 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)
      

Depois, você pode passar estas classes de gerenciador nos construtores das outras camadas ao configurá-las:

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
)
      

Como adicionar seus próprios recursos

Se quiser adicionar seus próprios marcadores, sobreposições de solo, polilinhas ou polígonos ao lado dessas camadas, crie sua própria Collection e use o Managers para incluir o recurso em vez de adicioná-lo diretamente ao objeto GoogleMap. Por exemplo, se você quiser adicionar um novo marcador:

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

Processamento de eventos de clique

Para clusters, KML e GeoJSON, os listeners de clique funcionam normalmente, desde que você transmita as classes Manager no construtor da camada que está sendo definida. Por exemplo, veja como configurar um listener de clique para a camada 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()
}
      

Ao adicionar seus próprios marcadores, sobreposições de solo, polilinhas ou polígonos, basta incluir listeners de clique nesses objetos Collection. Por exemplo, veja como configurar o listener de clique de marcador no 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
}
      

Ver o app de demonstração

Para ver um exemplo de como adicionar várias camadas, consulte o MultiLayerDemoActivity no app de demonstração que acompanha a biblioteca de utilitários. O guia de configuração mostra como executá-lo.