---
metadata:
  - name: generator
    content: Diplodoc Platform v5.37.1
alternate:
  - https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/layer.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/jsapi-v1-1/doc/ru/llms.txt

# YMaps.Layer

Расширяет [YMaps.ILayer](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ilayer.md).

Класс слоя с картой.


{% note alert %}

Плавное масштабирование не производится в браузере Opera версий ниже 9.5. Для остальных браузеров возможность плавного масштабирования определяется значением параметра smoothZoomEnabled в конструкторе источника данных [YMaps.TileDataSource](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/tiledatasource.md) для отдельного слоя карты.

{% endnote %}


**См.:** [Создание пользовательского слоя карты](https://yandex.ru/dev/jsapi-v1-1/doc/ru/dg/tasks/how-to-create-user-layer.md)
## Конструктор

Имя | Описание
----- | -----
[YMaps.Layer](layer.md#constructor)(tileDataSource, options) | Создает слой с картой.

## Методы

Имя | Возвращает | Описание
----- | ----- | -----
[getContainer](layer.md#getContainer)() | HTMLElement | Возвращает указатель на контейнер слоя.
[getMap](layer.md#getMap)() | [YMaps.Map](map.md) | Возвращает указатель на карту, в которую добавлен слой.
[getOptions](layer.md#getOptions)() | Object | Возвращает опции.
[getTileDataSource](layer.md#getTileDataSource)() | [YMaps.TileDataSource](tiledatasource.md) | Возвращает указатель на источник данных для тайлов слоя.
[getTileInPosition](layer.md#getTileInPosition)(pos) | [YMaps.ITile](itile.md) | Возвращает тайл, содержащий указанную точку.
[setOptions](layer.md#setOptions)(options, restoreDefault) |  | Задает опции.
[update](layer.md#update)() |  | Вызывает обновление слоя.

## Наследуемые методы

Из [YMaps.ILayer](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ilayer.md): 
: [getCopyright](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ilayer.md#getCopyright), [getZoomRange](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ilayer.md#getZoomRange), [onAddToMap](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ilayer.md#onAddToMap), [onMapUpdate](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ilayer.md#onMapUpdate), [onMove](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ilayer.md#onMove), [onRemoveFromMap](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ilayer.md#onRemoveFromMap), [onSmoothZoomEnd](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ilayer.md#onSmoothZoomEnd), [onSmoothZoomStart](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ilayer.md#onSmoothZoomStart), [onSmoothZoomTick](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/ilayer.md#onSmoothZoomTick)

## Подробное описание конструктора {#constructor}

```javascript
YMaps.Layer(tileDataSource, options)
```

Создает слой с картой.

**См.:** [Создание пользовательского слоя карты](https://yandex.ru/dev/jsapi-v1-1/doc/ru/dg/tasks/how-to-create-user-layer.md)

**Параметры:**

Имя | Тип | Необязательный | По умолчанию | Описание
----- | ----- | ----- | ----- | -----
`tileDataSource` | [YMaps.TileDataSource](tiledatasource.md) |  |  | Источник данных для тайлов слоя.
`options` | Object | ![](../_images/check.png) |  | Опции.
`options.zIndex` | Integer | ![](../_images/check.png) | YMaps.ZIndex.MAP_LAYER | z-index контейнера слоя.

## Подробное описание методов {#method_detail}

### getContainer {#getContainer}

```javascript
{HTMLElement} getContainer()
```

Возвращает указатель на контейнер слоя.

**Возвращает:**

Тип | Описание
----- | -----
HTMLElement | Указатель на HTML-контейнер слоя.

### getMap {#getMap}

```javascript
{YMaps.Map} getMap()
```

Возвращает указатель на карту, в которую добавлен слой.

**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Map](map.md) | Указатель на карту, в которую добавлен слой.

### getOptions {#getOptions}

```javascript
{Object} getOptions()
```

Возвращает опции.

**См.:** [YMaps.Layer.setOptions](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/layer.md#setOptions)

**Возвращает:**

Тип | Описание
----- | -----
Object | options Опции.

### getTileDataSource {#getTileDataSource}

```javascript
{YMaps.TileDataSource} getTileDataSource()
```

Возвращает указатель на источник данных для тайлов слоя.

**Возвращает:**

Тип | Описание
----- | -----
[YMaps.TileDataSource](tiledatasource.md) | Источник данных для тайлов слоя.

### getTileInPosition {#getTileInPosition}

```javascript
{YMaps.ITile} getTileInPosition(pos)
```

Возвращает тайл, содержащий указанную точку.

**Параметры:**

Имя | Тип | Описание
----- | ----- | -----
`pos` | [YMaps.Point](point.md) | Точка в локальных пикселах.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.ITile](itile.md) | Тайл.

### setOptions {#setOptions}

```javascript
setOptions(options, restoreDefault)
```

Задает опции.

**Параметры:**

Имя | Тип | Необязательный | По умолчанию | Описание
----- | ----- | ----- | ----- | -----
`options` | Object |  |  | Опции.
`options.zIndex` | Integer | ![](../_images/check.png) |  | z-index контейнера слоя.
`restoreDefault` | Boolean | ![](../_images/check.png) | false | true - восстановить значения по умолчанию для незаданных опций, false - не восстанавливать.

### update {#update}

```javascript
update()
```

Вызывает обновление слоя.