ابزار چند لایه Google Maps
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
پلتفرم را انتخاب کنید: Android JavaScript - مقدمه
- افزودن چندین لایه خوشه، KML و GeoJSON
- اضافه کردن ویژگی های خود
- مدیریت رویدادهای کلیک
- برنامه دمو را ببینید
مقدمه
در آموزشهای قبلی، یاد گرفتید که چگونه ویژگیهای KML و GeoJSON و همچنین خوشههای نشانگر را به نقشه خود اضافه کنید. اما اگر بخواهید چندین لایه از این لایه ها را روی یک نقشه اضافه کنید و رویدادهای کلیکی مستقل برای هر کدام را دریافت کنید، چه؟
افزودن چندین لایه خوشه، KML و GeoJSON
این کتابخانه شامل اشیاء Manager
برای کمک به مدیریت رویدادهای کلیک برای چندین نوع لایه است. بنابراین، قبل از راهاندازی لایههای خود، ابتدا باید آنها را نمونهسازی کنید و در GoogleMap
خود ارسال کنید:
کاتلین
val markerManager = MarkerManager(map)
val groundOverlayManager = GroundOverlayManager(map!!)
val polygonManager = PolygonManager(map)
val polylineManager = PolylineManager(map)
جاوا
MarkerManager markerManager = new MarkerManager(map);
GroundOverlayManager groundOverlayManager = new GroundOverlayManager(map);
PolygonManager polygonManager = new PolygonManager(map);
PolylineManager polylineManager = new PolylineManager(map);
در مرحله بعد، میتوانید این کلاسهای مدیر را هنگام تنظیم آنها به سازندههای لایههای دیگر منتقل کنید:
کاتلین
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
)
جاوا
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);
اضافه کردن ویژگی های خود
اگر میخواهید نشانگرها، همپوشانیهای زمین، چند خط یا چند ضلعی خود را در کنار این لایهها اضافه کنید، Collection
خود را ایجاد کنید و سپس از Managers
برای افزودن این ویژگی به جای افزودن مستقیم آنها به شی GoogleMap
استفاده کنید. به عنوان مثال، اگر می خواهید یک نشانگر جدید اضافه کنید:
کاتلین
val markerCollection =
markerManager.newCollection()
markerCollection.addMarker(
MarkerOptions()
.position(LatLng(51.150000, -0.150032))
.icon(BitmapDescriptorFactory.defaultMarker(BitmapDescriptorFactory.HUE_AZURE))
.title("Unclustered marker")
)
جاوا
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"));
مدیریت رویدادهای کلیک
برای خوشهها، KML، و GeoJSON، شنوندههای کلیک مانند عادی کار میکنند - تا زمانی که از کلاسهای Manager
در سازنده لایهای که تنظیم میکنید عبور کنید. به عنوان مثال، در اینجا نحوه تنظیم یک شنونده کلیک برای لایه KML آمده است:
کاتلین
kmlPolylineLayer.addLayerToMap()
kmlPolylineLayer.setOnFeatureClickListener { feature: Feature ->
Toast.makeText(context,
"KML polyline clicked: ${feature.getProperty("name")}",
Toast.LENGTH_SHORT
).show()
}
جاوا
kmlPolylineLayer.addLayerToMap();
kmlPolylineLayer.setOnFeatureClickListener(feature -> Toast.makeText(context,
"KML polyline clicked: " + feature.getProperty("name"),
Toast.LENGTH_SHORT).show());
وقتی نشانگرها، همپوشانی های زمین، چند خط یا چند ضلعی خود را اضافه می کنید، فقط مطمئن شوید که شنوندگان کلیک را به آن اشیاء Collection
اضافه کنید. برای مثال، در اینجا نحوه تنظیم شنونده کلیک نشانگر در markerCollection
آمده است:
کاتلین
markerCollection.setOnMarkerClickListener { marker: Marker ->
Toast.makeText(
context,
"Marker clicked: ${marker.title}",
Toast.LENGTH_SHORT
).show()
false
}
جاوا
markerCollection.setOnMarkerClickListener(marker -> { Toast.makeText(context,
"Marker clicked: " + marker.getTitle(),
Toast.LENGTH_SHORT).show();
return false;
});
برنامه دمو را ببینید
برای مثالی از افزودن چند لایه، به MultiLayerDemoActivity
در برنامه آزمایشی که با کتابخانه ابزار ارسال می شود، نگاهی بیندازید. راهنمای راه اندازی به شما نشان می دهد که چگونه برنامه آزمایشی را اجرا کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-09-04 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-09-04 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis guide explains how to add and manage multiple map layers like KML, GeoJSON, and Clusters on the same map using the Maps SDK for Android Utility Library.\u003c/p\u003e\n"],["\u003cp\u003eIt covers using \u003ccode\u003eManager\u003c/code\u003e objects to handle click events for these layers and how to add your own features.\u003c/p\u003e\n"],["\u003cp\u003eClick listeners function as usual for KML, GeoJSON, and Clusters when the \u003ccode\u003eManager\u003c/code\u003e classes are passed to the layer's constructor.\u003c/p\u003e\n"],["\u003cp\u003eFor custom markers and overlays, use \u003ccode\u003eCollection\u003c/code\u003e objects and add click listeners to them for event handling.\u003c/p\u003e\n"],["\u003cp\u003eA demo app, \u003ccode\u003eMultiLayerDemoActivity\u003c/code\u003e, showcases the implementation of these concepts.\u003c/p\u003e\n"]]],[],null,["# Google Maps Multilayer Utility\n\nSelect platform: [Android](/maps/documentation/android-sdk/utility/multilayer \"View this page for the Android platform docs.\") [JavaScript](/maps/documentation/javascript/layers \"View this page for the JavaScript platform docs.\")\n\n1. [Introduction](#introduction)\n2. [Adding multiple cluster, KML, and GeoJSON layers](#add-multiple)\n3. [Adding your own features](#add-features)\n4. [Handling click events](#handle-click)\n5. [See the demo app](#demo-app)\n\nIntroduction\n------------\n\n\nIn previous tutorials, you've learned how to add features from\n[KML](/maps/documentation/android-sdk/utility/kml) and\n[GeoJSON](/maps/documentation/android-sdk/utility/geojson) to your map, as well as\n[clusters](/maps/documentation/android-sdk/utility/marker-clustering) of markers.\nBut what if you want to add several of these layers on the same map and get independent click\nevents for each?\n\nAdding multiple cluster, KML, and GeoJSON layers\n------------------------------------------------\n\n\nThe library includes `Manager`objects to help manage click events for multiple types\nof layers. So, before you set up your layers you'll first need to instantiate these and pass in\nyour `GoogleMap`: \n\n### Kotlin\n\n```kotlin\nval markerManager = MarkerManager(map)\nval groundOverlayManager = GroundOverlayManager(map!!)\nval polygonManager = PolygonManager(map)\nval polylineManager = PolylineManager(map)\n\n \n```\n\n### Java\n\n```java\nMarkerManager markerManager = new MarkerManager(map);\nGroundOverlayManager groundOverlayManager = new GroundOverlayManager(map);\nPolygonManager polygonManager = new PolygonManager(map);\nPolylineManager polylineManager = new PolylineManager(map);\n\n \n```\n\n\nNext, you can pass these manager classes into the constructors of the other layers when you\nset them up: \n\n### Kotlin\n\n```kotlin\nval clusterManager =\n ClusterManager\u003cMyItem\u003e(context, map, markerManager)\nval geoJsonLineLayer = GeoJsonLayer(\n map,\n R.raw.geojson_file,\n context,\n markerManager,\n polygonManager,\n polylineManager,\n groundOverlayManager\n)\nval kmlPolylineLayer = KmlLayer(\n map,\n R.raw.kml_file,\n context,\n markerManager,\n polygonManager,\n polylineManager,\n groundOverlayManager,\n null\n)\n\n \n```\n\n### Java\n\n```java\nClusterManager\u003cMyItem\u003e clusterManager = new ClusterManager\u003c\u003e(context, map, markerManager);\nGeoJsonLayer geoJsonLineLayer = new GeoJsonLayer(map, R.raw.geojson_file, context, markerManager, polygonManager, polylineManager, groundOverlayManager);\nKmlLayer kmlPolylineLayer = new KmlLayer(map, R.raw.kml_file, context, markerManager, polygonManager, polylineManager, groundOverlayManager, null);\n\n \n```\n\nAdding your own features\n------------------------\n\n\nIf you want to add your own markers, ground overlays, polylines, or polygons alongside these\nlayers, create your own `Collection` and then use the `Managers`\nto add the feature instead of directly adding them to the `GoogleMap` object.\n\nFor example, if you want to add a new marker: \n\n### Kotlin\n\n```kotlin\nval markerCollection =\n markerManager.newCollection()\nmarkerCollection.addMarker(\n MarkerOptions()\n .position(LatLng(51.150000, -0.150032))\n .icon(BitmapDescriptorFactory.defaultMarker(BitmapDescriptorFactory.HUE_AZURE))\n .title(\"Unclustered marker\")\n)\n\n \n```\n\n### Java\n\n```java\nMarkerManager.Collection markerCollection = markerManager.newCollection();\nmarkerCollection.addMarker(new MarkerOptions()\n .position(new LatLng(51.150000, -0.150032))\n .icon(BitmapDescriptorFactory.defaultMarker(BitmapDescriptorFactory.HUE_AZURE))\n .title(\"Unclustered marker\"));\n\n \n```\n\nHandling click events\n---------------------\n\n\nFor clusters, KML, and GeoJSON, click listeners work like normal - as long as you pass in the\n`Manager` classes in the constructor of the layer you're setting.\n\nFor example, here's how to set up a click listener for the KML layer: \n\n### Kotlin\n\n```kotlin\nkmlPolylineLayer.addLayerToMap()\nkmlPolylineLayer.setOnFeatureClickListener { feature: Feature -\u003e\n Toast.makeText(context,\n \"KML polyline clicked: ${feature.getProperty(\"name\")}\",\n Toast.LENGTH_SHORT\n ).show()\n}\n\n \n```\n\n### Java\n\n```java\nkmlPolylineLayer.addLayerToMap();\nkmlPolylineLayer.setOnFeatureClickListener(feature -\u003e Toast.makeText(context,\n \"KML polyline clicked: \" + feature.getProperty(\"name\"),\n Toast.LENGTH_SHORT).show());\n\n \n```\n\n\nWhen you add your own markers, ground overlays, polylines, or polygons, just be sure to add click\nlisteners to those `Collection` objects. For example, here's how to set up the marker\nclick listener on the `markerCollection`: \n\n### Kotlin\n\n```kotlin\nmarkerCollection.setOnMarkerClickListener { marker: Marker -\u003e\n Toast.makeText(\n context,\n \"Marker clicked: ${marker.title}\",\n Toast.LENGTH_SHORT\n ).show()\n false\n}\n\n \n```\n\n### Java\n\n```java\nmarkerCollection.setOnMarkerClickListener(marker -\u003e { Toast.makeText(context,\n \"Marker clicked: \" + marker.getTitle(),\n Toast.LENGTH_SHORT).show();\n return false;\n});\n\n \n```\n\nSee the demo app\n----------------\n\nFor an example of adding multiple layers, take a look at the `MultiLayerDemoActivity`\nin the demo app that ships with the utility library. The [setup guide](/maps/documentation/android-sdk/utility/setup) shows you how to run\nthe demo app."]]