لایه های
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
پلتفرم را انتخاب کنید: Android JavaScript لایه ها اشیایی روی نقشه هستند که از یک یا چند آیتم مجزا تشکیل شده اند، اما به صورت یک واحد دستکاری می شوند. لایه‌ها معمولاً مجموعه‌ای از اشیاء را منعکس می‌کنند که برای تعیین یک ارتباط مشترک در بالای نقشه اضافه می‌کنید. Maps JavaScript API نمایش اشیاء را در لایه‌ها با رندر کردن آیتم‌های تشکیل‌دهنده آن‌ها در یک شی (معمولاً یک پوشش کاشی) و نمایش آن‌ها با تغییر نمای نقشه مدیریت می‌کند. لایه ها همچنین ممکن است لایه نمایش خود نقشه را تغییر دهند و کاشی های پایه را به شکلی مطابق با لایه تغییر دهند. توجه داشته باشید که اکثر لایه ها، بر اساس طراحی، ممکن است از طریق اشیاء مجزا قابل دسترسی نباشند، اما ممکن است فقط به عنوان یک واحد دستکاری شوند.
بررسی اجمالی لایه ها
Maps JavaScript API چندین نوع لایه دارد:
- لایه Google Maps Data محفظه ای برای داده های مکانی دلخواه فراهم می کند. می توانید از لایه داده برای ذخیره داده های سفارشی خود یا نمایش داده های GeoJSON بر روی نقشه گوگل استفاده کنید.
- لایه Heatmap داده های جغرافیایی را با استفاده از تصویرسازی Heatmap ارائه می کند.
- لایه KML عناصر KML و GeoRSS را به یک همپوشانی کاشی API جاوا اسکریپت Maps تبدیل می کند.
- لایه Traffic شرایط ترافیک را روی نقشه نمایش می دهد.
- لایه ترانزیت شبکه حمل و نقل عمومی شهر شما را روی نقشه نمایش می دهد.
- شی لایه Bicycling لایه ای از مسیرهای دوچرخه و/یا پوشش های مخصوص دوچرخه را در یک لایه مشترک ارائه می کند. این لایه به طور پیش‌فرض در DirectionsRenderer هنگام درخواست جهت‌های حالت سفر BICYCLING برگردانده می‌شود.
یک لایه اضافه کنید
برای افزودن یک لایه به نقشه، فقط باید setMap() را فراخوانی کنید و شی نقشه را که برای نمایش لایه روی آن ارسال می شود، ارسال کنید. به طور مشابه، برای مخفی کردن یک لایه، setMap() را فراخوانی کنید و null را ارسال کنید.
قطعه زیر نقشه را در لندن، بریتانیا متمرکز می کند و لایه Transit را اضافه می کند.
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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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```"]]
