أداة متعددة الطبقات في خرائط Google
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
اختيار النظام الأساسي:
نظام التشغيل
Android
JavaScript
- مقدمة
- إضافة طبقات تجمع متعددة و KML و GeoJSON
- إضافة الميزات الخاصة بك
- التعامل مع الأحداث الناتجة عن النقر
- الاطّلاع على التطبيق التجريبي
مقدمة
في البرامج التعليمية السابقة، تعلمت كيفية إضافة ميزات من
KML
GeoJSON على خريطتك وكذلك
مجموعات العلامات.
ولكن ماذا لو كنت تريد إضافة العديد من هذه الطبقات على نفس الخريطة والحصول على نقرة مستقلة
الأحداث لكل منها؟
إضافة طبقات تجمع متعددة و KML و GeoJSON
تتضمّن المكتبة عناصر Manager للمساعدة في إدارة أحداث النقر لأنواع متعددة.
من الطبقات. لذا، قبل إعداد الطبقات، ستحتاج أولاً إلى إنشاء مثيل لهذه الطبقات وتمريرها
GoogleMap:
Kotlin
val markerManager = MarkerManager(map)
val groundOverlayManager = GroundOverlayManager(map!!)
val polygonManager = PolygonManager(map)
val polylineManager = PolylineManager(map)
Java
MarkerManager markerManager = new MarkerManager(map);
GroundOverlayManager groundOverlayManager = new GroundOverlayManager(map);
PolygonManager polygonManager = new PolygonManager(map);
PolylineManager polylineManager = new PolylineManager(map);
بعد ذلك، يمكنك تمرير فئات المدير هذه إلى الدوال الإنشائية للطبقات الأخرى عندما
لإعدادها:
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
)
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);
إضافة العناصر الخاصة بك
إذا كنت تريد إضافة علاماتك الخاصة أو تراكبات أرضية أو خطوط متعددة أو مضلّعات إلى جانب هذه
يمكنك أيضًا إنشاء طبقات Collection الخاصة بك ثم استخدام Managers.
لإضافة الميزة بدلاً من إضافتها مباشرةً إلى عنصر GoogleMap.
على سبيل المثال، إذا كنت تريد إضافة علامة جديدة:
Kotlin
val markerCollection =
markerManager.newCollection()
markerCollection.addMarker(
MarkerOptions()
.position(LatLng(51.150000, -0.150032))
.icon(BitmapDescriptorFactory.defaultMarker(BitmapDescriptorFactory.HUE_AZURE))
.title("Unclustered marker")
)
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"));
التعامل مع أحداث النقر
بالنسبة إلى المجموعات العنقودية وKML وGeoJSON، تعمل أدوات استماع النقر كالمعتاد - طالما أنك اجتياز
Manager فئات في الدالة الإنشائية للطبقة التي تضبطها
على سبيل المثال، إليك كيفية إعداد أداة معالجة نقرات لطبقة KML:
Kotlin
kmlPolylineLayer.addLayerToMap()
kmlPolylineLayer.setOnFeatureClickListener { feature: Feature ->
Toast.makeText(context,
"KML polyline clicked: ${feature.getProperty("name")}",
Toast.LENGTH_SHORT
).show()
}
Java
kmlPolylineLayer.addLayerToMap();
kmlPolylineLayer.setOnFeatureClickListener(feature -> Toast.makeText(context,
"KML polyline clicked: " + feature.getProperty("name"),
Toast.LENGTH_SHORT).show());
عند إضافة علاماتك الخاصة أو تراكبات أرض أو خطوط متعددة أو مضلعات، تأكد فقط من إضافة نقرات
المستمعين إلى عناصر Collection تلك. على سبيل المثال، إليك كيفية إعداد محدّد الموقع
انقر على "المستمع" على markerCollection:
Kotlin
markerCollection.setOnMarkerClickListener { marker: Marker ->
Toast.makeText(
context,
"Marker clicked: ${marker.title}",
Toast.LENGTH_SHORT
).show()
false
}
Java
markerCollection.setOnMarkerClickListener(marker -> { Toast.makeText(context,
"Marker clicked: " + marker.getTitle(),
Toast.LENGTH_SHORT).show();
return false;
});
الاطّلاع على التطبيق التجريبي
للاطّلاع على مثال لإضافة طبقات متعددة، ألقِ نظرة على MultiLayerDemoActivity.
في التطبيق التجريبي المزود بمكتبة المرافق. ويوضّح لك دليل الإعداد كيفية تشغيل
التطبيق التجريبي.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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."]]
