الطبقات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
اختيار النظام الأساسي:
Android
JavaScript
الطبقات هي عناصر على الخريطة تتألف من عنصر واحد أو أكثر منفصل،
ولكن يتم التعامل معها كوحدة واحدة. بشكل عام، تعكس الطبقات مجموعات من
العناصر التي تضيفها فوق الخريطة لتحديد ارتباط شائع. تدير واجهة برمجة التطبيقات
Maps JavaScript API عرض الأجسام ضمن الطبقات
من خلال تحويل العناصر المكونة لها إلى كائن واحد (عادةً ما يكون عنصرًا مثبّتًا على سطح الخريطة)
وعرضها عند تغيير مساحة العرض في الخريطة. قد تؤدي الطبقات أيضًا إلى تغيير ملف تعريف التقديم
للخريطة نفسها، ما يؤدي إلى تغيير المربّعات الأساسية قليلاً بطريقة
متسقة مع الطبقة. يُرجى العِلم أنّه قد لا يمكن الوصول إلى معظم الطبقات
من خلال عناصرها الفردية، ولكن يمكن التلاعب بها فقط كأحد
العناصر.
نظرة عامة على الطبقات
تتضمّن Maps JavaScript API عدة أنواع من الطبقات:
- توفّر طبقة "بيانات خرائط Google" حاوية للبيانات الجيوفضائية العشوائية.
يمكنك استخدام "طبقة البيانات" لتخزين بياناتك المخصّصة أو لعرض بيانات GeoJSON
على خريطة Google.
- تعرِض
طبقة خريطة التمثيل اللوني البيانات الجغرافية باستخدام تمثيل بصري
لخريطة التمثيل اللوني.
-
طبقة KML: تعرِض عناصر KML وGeoRSS في
تراكب مربّع Maps JavaScript API.
- تعرِض
طبقة حركة المرور حالة حركة المرور على الخريطة.
- تعرض
طبقة النقل العام شبكة النقل العام
في مدينتك على الخريطة.
- يعرض عنصر
طبقة ركوب الدراجات طبقة من مسارات الدراجات
و/أو التراكبات المتعلّقة بالدراجات في طبقة مشتركة. يتم عرض هذه الطبقة
تلقائيًا ضمن DirectionsRenderer عند طلب
الاتجاهات الخاصة بوضع التنقّل BICYCLING.
إضافة طبقة
لإضافة طبقة إلى خريطة، ما عليك سوى استدعاء setMap()
،
مع تمرير عنصر الخريطة الذي سيتم عرض الطبقة عليه. وبالمثل، لإخفاء أحد
الطبقات، يمكنك الاتصال بـ setMap()
وإرسال null
.
يحدِّد المقتطف أدناه مركز الخريطة على لندن، المملكة المتحدة، ويضيف التسلسل الزمني
للطبقة.
var mapOptions = {
zoom: 13,
center: new google.maps.LatLng(51.5,-0.11)
}
var map = new google.maps.Map(document.getElementById("map"), mapOptions);
var transitLayer = new google.maps.TransitLayer();
transitLayer.setMap(map);
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-06 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-06 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eLayers in Maps JavaScript API are objects consisting of multiple items that are treated as a single unit and often represent collections of objects on the map.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides various layer types, including Data, Heatmap, KML, Traffic, Transit, and Bicycling layers, each serving a distinct purpose for displaying geospatial data.\u003c/p\u003e\n"],["\u003cp\u003eYou can easily add or hide a layer by calling the \u003ccode\u003esetMap()\u003c/code\u003e method, providing the map object or \u003ccode\u003enull\u003c/code\u003e respectively.\u003c/p\u003e\n"],["\u003cp\u003eThe example code demonstrates adding a Transit layer to a map centered on London.\u003c/p\u003e\n"]]],[],null,["Select 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\nLayers are objects on the map that consist of one or more separate items,\nbut are manipulated as a single unit. Layers generally reflect collections of\nobjects that you add on top of the map to designate a common association. The\nMaps JavaScript API manages the presentation of objects within layers\nby rendering their constituent items into one object (typically a tile overlay) and\ndisplaying them as the map's viewport changes. Layers may also alter the presentation\nlayer of the map itself, slightly altering the base tiles in a fashion\nconsistent with the layer. Note that most layers, by design, may not be\naccessed via their individual objects, but may only be manipulated as a\nunit.\n\nLayers Overview\n\nThe Maps JavaScript API has several types of layers:\n\n- The [**Google Maps Data\n layer**](/maps/documentation/javascript/datalayer) provides a container for arbitrary geospatial data. You can use the Data layer to store your custom data, or to display GeoJSON data on a Google map.\n- The [**Heatmap layer**](/maps/documentation/javascript/heatmaplayer) renders geographic data using a *Heatmap* visualization.\n- The [**KML layer**](/maps/documentation/javascript/kmllayer) renders KML and GeoRSS elements into a Maps JavaScript API tile overlay.\n- The [**Traffic layer**](/maps/documentation/javascript/trafficlayer#traffic_layer) displays traffic conditions on the map.\n- The [**Transit layer**](/maps/documentation/javascript/trafficlayer#transit_layer) displays the public transport network of your city on the map.\n- The [**Bicycling layer**](/maps/documentation/javascript/trafficlayer#bicycling_layer) object renders a layer of bike paths and/or bicycle-specific overlays into a common layer. This layer is returned by default within the **DirectionsRenderer** when requesting directions of travel mode **BICYCLING**.\n\nAdd a layer\n\nTo add a layer to a map, you only need to call `setMap()`,\npassing it the map object on which to display the layer. Similarly, to hide a\nlayer, call `setMap()`, passing `null`.\n\nThe below snippet centers the map on London, UK, and adds the [Transit\nlayer](/maps/documentation/javascript/trafficlayer#transit_layer). \n\n```javascript\nvar mapOptions = {\n zoom: 13,\n center: new google.maps.LatLng(51.5,-0.11)\n}\n\nvar map = new google.maps.Map(document.getElementById(\"map\"), mapOptions);\n\nvar transitLayer = new google.maps.TransitLayer();\ntransitLayer.setMap(map);\n```"]]