Документация
Справочник JavaScript API
2.1.64 (текущая версия)
collection
interactivityModel
Интерфейсы

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

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

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

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

Для создания картиночного слоя используется класс Layer. Этот класс принимает следующие параметры:

  • строковый шаблон, по которому строится URL тайла или функция, генерирующая соответствующий URL (подробнее см. в справочнике);
  • опции слоя.
var imgLayer = new ymaps.Layer('http://server.domain/images/%z/%x/%y.png', {
        tileTransparent: true // слой является прозрачным
    });

Ссылка на слои находится в поле layers объекта карты. Для добавления слоя на карту используется метод add():

myMap.layers.add(imgLayer);

Картиночный слой можно поместить в хранилище слоев карты. Для этого нужно вызывать метод add() хранилища layer.storage с параметрами:

  • строковый ключ, по которому добавляемый слой будет доступен;
  • функция-конструктор, создающая экземпляры соответствующего слоя.
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);