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

# map.Copyrights

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

**См.:** [Map.copyrights](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#copyrights)

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

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

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

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

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

Карта. ||
|#

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

**Пример:**

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

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

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


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

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [add](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Copyrights.md#add)([customCopyrights](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Copyrights.md#add-param-customCopyrights)) | [ICopyrightsAccessor](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICopyrightsAccessor.md) | Добавляет на карту статическую (не зависящую от текущего центра и масштаба карты) информацию об авторских правах. ||
|| [addProvider](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Copyrights.md#addProvider)([provider](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Copyrights.md#addProvider-param-provider)) | [map.Copyrights](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Copyrights.md) | Добавляет нового провайдера информации об авторских правах. ||
|| [get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Copyrights.md#get)(\[[point](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Copyrights.md#get-param-point)[, [zoom](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Copyrights.md#get-param-zoom)]]) | [vow.Promise](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/vow.Promise.md) | Определяет информацию об авторских правах в указанной точке. ||
|| [getPromoLink](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Copyrights.md#getPromoLink)() | String | Возвращает внешнюю ссылку из блока "Открыть в Яндекс Картах". ||
|| [removeProvider](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Copyrights.md#removeProvider)([provider](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Copyrights.md#removeProvider-param-provider)) | [map.Copyrights](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Copyrights.md) | Удаляет провайдера информации об авторских правах. ||
|#

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

### change {#change}

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

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

### add {#add}

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

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

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

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

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

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

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

### addProvider {#addProvider}

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

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

**Возвращает** ссылку на себя.

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

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

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

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

**Пример:**

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

### get {#get}

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

Определяет информацию об авторских правах в указанной точке.

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

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

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

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

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

### getPromoLink {#getPromoLink}

```javascript
{String} getPromoLink()
```

**Возвращает** внешнюю ссылку из блока "Открыть в Яндекс Картах".

### removeProvider {#removeProvider}

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

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

**Возвращает** ссылку на себя.

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

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

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

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

<!-- XLIFF_FARM_MjAzNGU1_CACHING -->

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