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

# ILayer

Расширяет [IChildOnMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md), [ICustomizable](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md), [IEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventEmitter.md).

Интерфейс слоя карты.

[Конструктор](#constructor-summary) | [Поля ](#properties-summary) | [События ](#events-summary) | [Методы ](#methods-summary)

## Конструктор {#constructor-summary}

```javascript
ILayer()
```

## Поля {#properties-summary}

#|
|| **Имя** | **Тип** | **Описание** ||
|| [events](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventEmitter.md#events) | [IEventManager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventManager.md) | Менеджер событий.

Унаследовано от [IEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventEmitter.md#events). ||
|| [options](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#options) | [IOptionManager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IOptionManager.md) | Менеджер опций.

Унаследовано от [ICustomizable](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#options). ||
|#

## События {#events-summary}

#|
|| **Имя** | **Описание** ||
|| [brightnesschange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILayer.md#event-brightnesschange) | Событие изменения яркости слоя. ||
|| [copyrightschange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILayer.md#event-copyrightschange) | Событие изменения доступной информации об авторских правах. ||
|| [optionschange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#event-optionschange) | Изменение в опциях объекта.

Унаследовано от [ICustomizable](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#event-optionschange). ||
|| [parentchange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChild.md#event-parentchange) | Сменился родительский объект.

Поля данных:

- oldParent - старый родитель;
- newParent - новый родитель.

Унаследовано от [IChild](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChild.md#event-parentchange). ||
|| [tileloadchange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILayer.md#event-tileloadchange) | Событие изменения состояния загрузки тайла. Поля данных:
- readyTileNumber-количество готовых тайлов. Тайл считается готовым, когда она загружен и отрисован. Тип: Number.
- totalTileNumber-общее количество видимых тайлов. Тип: Number. ||
|| [zoomrangechange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILayer.md#event-zoomrangechange) | Событие изменения доступной информации о диапазоне уровней масштабирования. ||
|#

## Методы {#methods-summary}

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [getBrightness](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILayer.md#getBrightness)() | Number | Необязательный метод. ||
|| [getCopyrights](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILayer.md#getCopyrights)([coords](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILayer.md#getCopyrights-param-coords), [zoom](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILayer.md#getCopyrights-param-zoom)) | [vow.Promise](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md) | Необязательный метод. Запрашивает информацию об авторских правах в указанной точке с указанным коэффициентом масштабирования. ||
|| [getParent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md#getParent)() | [IParentOnMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IParentOnMap.md)\|null | Возвращает ссылку на родительский объект или null, если родительский элемент не был установлен.

Унаследован от [IChildOnMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md#getParent). ||
|| [getZoomRange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILayer.md#getZoomRange)([point](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILayer.md#getZoomRange-param-point)) | [vow.Promise](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md) | Необязательный метод. Определяет доступный в указанной точке диапазон уровней масштабирования. Если данные есть, то возвращенный объект-promise будет подтвержден и передаст в качестве результата массив из двух чисел - минимальный и максимальный доступный в точке уровень масштабирования. Если данных нет, то promise отклоняется с указанием ошибки. ||
|| [setParent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md#setParent)([parent](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md#setParent-param-parent)) | [IChildOnMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md) | Устанавливает родительский объект. Если передать значение null, то элемент управления будет только удален из текущего родительского объекта.

Унаследован от [IChildOnMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md#setParent). ||
|#

## Описание событий {#event_detail}

### brightnesschange {#brightnesschange}

Событие изменения яркости слоя.

### copyrightschange {#copyrightschange}

Событие изменения доступной информации об авторских правах.

### tileloadchange {#tileloadchange}

Событие изменения состояния загрузки тайла. Поля данных:
- readyTileNumber-количество готовых тайлов. Тайл считается готовым, когда она загружен и отрисован. Тип: Number.
- totalTileNumber-общее количество видимых тайлов. Тип: Number.

### zoomrangechange {#zoomrangechange}

Событие изменения доступной информации о диапазоне уровней масштабирования.

## Описание методов {#method_detail}

### getBrightness {#getBrightness}

```javascript
{Number} getBrightness()
```

Необязательный метод.

**Возвращает** значение яркости от 0 до 1 (0 — нулевая яркость, 1 — максимальная яркость). В зависимости от суммарной яркости слоев, добавленных на карту, выбирается цвет логотипа и копирайтов на карте.

### getCopyrights {#getCopyrights}

```javascript
{vow.Promise} getCopyrights(coords, zoom)
```

Необязательный метод. Запрашивает информацию об авторских правах в указанной точке с указанным коэффициентом масштабирования.

**Возвращает** Promise, который будет подтверждён массивом строк или DOM-элементов с информацией об авторских правах.

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание**  ||
|| [`coords`](#getCopyrights-param-coords)[*](*star) | — | Тип: Number[]

Точка на карте, для которой запрашивается информация об авторских правах. ||
|| [`zoom`](#getCopyrights-param-zoom)[*](*star) | — | Тип: Number

Уровень масштабирования, для которого запрашивается информация об авторских правах. ||
|#

\* Обязательный параметр/опция.

### getZoomRange {#getZoomRange}

```javascript
{vow.Promise} getZoomRange(point)
```

Необязательный метод. Определяет доступный в указанной точке диапазон уровней масштабирования. Если данные есть, то возвращенный объект-promise будет подтвержден и передаст в качестве результата массив из двух чисел - минимальный и максимальный доступный в точке уровень масштабирования. Если данных нет, то promise отклоняется с указанием ошибки.

**Возвращает** объект-promise.

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание**  ||
|| [`point`](#getZoomRange-param-point)[*](*star) | — | Тип: Number[]

Point ||
|#

\* Обязательный параметр/опция.

<!-- XLIFF_FARM_Mjg4MjVi_CACHING -->

[*star]: Обязательный параметр.