---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/dg/concepts/hotspots/image-layer.md
  - https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/dg/concepts/hotspots/image-layer.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/jsapi-v2-1/doc/ru/llms.txt

# Картиночный слой

Картиночный слой содержит изображения объектов, размещаемых на карте.

Как и любой другой слой, картиночный слой состоит из тайлов. Перед созданием этого слоя достаточно сформировать только те тайлы, в которые попадают изображения объектов. Изображения должны быть нарисованы на прозрачном фоне.

![](../../_images/tiles.png)

Тайлы должны быть сформированы для всех уровней масштабирования.

Для создания картиночного слоя используется класс [Layer](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Layer.md). Этот класс принимает следующие параметры:

- строковый шаблон, по которому строится URL тайла или функция, генерирующая соответствующий URL (подробнее см. в [справочнике](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Layer.md#constructor-summary));
- [опции](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Layer.md) слоя.

```javascript
var imgLayer = new ymaps.Layer('http://server.domain/_images/%z/%x/%y.png', {
        tileTransparent: true // слой является прозрачным
    });
```

Ссылка на слои находится в поле [layers](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.layer.Manager.md) объекта карты. Для добавления слоя на карту используется метод [add()](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.layer.Manager.md#methods-summary):

```javascript
myMap.layers.add(imgLayer);
```

Картиночный слой можно поместить в хранилище слоев карты. Для этого нужно вызывать метод `add()` хранилища [layer.storage](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/layer.storage.md) с параметрами:

- строковый ключ, по которому добавляемый слой будет доступен;
- функция-конструктор, создающая экземпляры соответствующего слоя.

```javascript
var MyLayer = function() {
        return new ymaps.Layer('http://server.domain/_images/%z/%x/%y.png', {
                tileTransparent: true 
            })
    }

// Добавляем слой в хранилище по ключу 'my#layer'
ymaps.layer.storage.add('my#layer', MyLayer);
```