---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Copyrights.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/llms.txt

# map.Copyrights

Расширяет [IEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IEventEmitter.md).

Менеджер размещённой на карте информации об авторских правах. У каждой карты уже есть собственный менеджер информации об авторских правах, доступный как map.copyrights. Не инстанцируйте экземпляры этого класса без необходимости.

**См.:** [Map.copyrights](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Map.md#copyrights)

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

```javascript
map.Copyrights(map)
```

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `map`[*](*parametr) | — | Тип: [Map](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Map.md)

Карта. ||
|#

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

**Пример:**

```javascript
// Добавим статическую информацию об авторских правах на карту
var accessor = map.copyrights.add('© Герард Меркатор');
// ...
// Удалим информацию об авторских правах
accessor.remove();
```

## Поля {#fields}

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

Унаследовано от [IEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IEventEmitter.md#events). ||
|#

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

#|
|| **Имя** | **Описание** ||
|| [change](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Copyrights.md#change) | Событие изменения размещённой на карте информации об авторских правах. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• oldCopyrights - старый массив информации об авторских правах;

• newCopyrights - новый массив информации об авторских правах; ||
|#

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

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [add](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Copyrights.md#add)([customCopyrights](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Copyrights.md#add-param-customCopyrights)) | [ICopyrightsAccessor](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICopyrightsAccessor.md) | Добавляет на карту статическую (не зависящую от текущего центра и масштаба карты) информацию об авторских правах. ||
|| [addProvider](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Copyrights.md#addProvider)([provider](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Copyrights.md#addProvider-param-provider)) | [map.Copyrights](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Copyrights.md) | Добавляет нового провайдера информации об авторских правах. ||
|| [get](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Copyrights.md#get)([[point](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Copyrights.md#get-param-point)[, [zoom](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Copyrights.md#get-param-zoom)]]) | [util.Promise](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/util.Promise.md) | Определяет информацию об авторских правах в указанной точке. Возвращает объект-promise, который будет подтверждён и передаст в качестве параметра массив строк/DOM-элементов. ||
|| [removeProvider](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Copyrights.md#removeProvider)([provider](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Copyrights.md#removeProvider-param-provider)) | [map.Copyrights](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Copyrights.md) | Удаляет провайдера информации об авторских правах. ||
|#

## Описание событий {#description-events}

### change

Событие изменения размещённой на карте информации об авторских правах. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• oldCopyrights - старый массив информации об авторских правах;

• newCopyrights - новый массив информации об авторских правах;

## Описание методов {#description-methods}

### add

```javascript
{ICopyrightsAccessor} add(customCopyrights)
```

Добавляет на карту статическую (не зависящую от текущего центра и масштаба карты) информацию об авторских правах.

**Returns** объект, позволяющий управлять добавленной информацией.

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `customCopyrights`[*](*parametr) | — | Тип: String\|HTMLElement\|String[]\|HTMLElement[]

Информация об авторских правах в виде строки, DOM-элемента либо массива строк/DOM-элементов. ||
|#

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

### addProvider

```javascript
{map.Copyrights} addProvider(provider)
```

Добавляет нового провайдера информации об авторских правах.

**Returns** ссылку на себя.

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `provider`[*](*parametr) | — | Тип: [ICopyrightsProvider](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICopyrightsProvider.md)

Провайдер. ||
|#

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

**Пример:**

```javascript
// Создадим динамический провайдер информации об авторских правах,
// который будет получать актуальную информацию об авторских правах для
// конкретной точки карты с удаленного сервера.
var myProvider = {
        getCopyrights: function (center, zoom) {
            var promise = new ymaps.util.Promise();
            $.ajax('http://some.server/copyrights/?ll=' +
                center.join(',') = '&z=' + zoom, {
                // Сервер должен вернуть массив строк
                success: function (res) {
                    promise.resolve(res);
                }
            });
            return promise;
        }
    };
// Добавим провайдер на карту; теперь при изменении центра или уровня
// масштабирования менеджер информации об авторских правах карты будет
// перезапрашивать акутальную информацию с удаленного сервера и отображать
// полученные данные автоматически.
map.copyrights.addProvider(myProvider);
```

### get

```javascript
{util.Promise} get([point[, zoom]])
```

Определяет информацию об авторских правах в указанной точке. Возвращает объект-promise, который будет подтверждён и передаст в качестве параметра массив строк/DOM-элементов.

**Returns** объект-promise.

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

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

Точка (в географических координатах), для которой требуется определить информацию об авторских правах. Если не указана, берётся текущий центр карты. ||
|| `zoom` | — | Тип: Number

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

### removeProvider

```javascript
{map.Copyrights} removeProvider(provider)
```

Удаляет провайдера информации об авторских правах.

**Returns** ссылку на себя.

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `provider`[*](*parametr) | — | Тип: [ICopyrightsProvider](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICopyrightsProvider.md)

Провайдер. ||
|#

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

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