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

map.Copyrights

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

См.: Map.copyrights

Конструктор | События | Методы

Конструктор

map.Copyrights(map)

Параметры:

ПараметрЗначение по умолчаниюОписание
map *
[no-highlight[

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

]no-highlight]

Тип: Map

Карта.

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

Пример:

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

События

ИмяОписание
change

Событие изменения размещённой на карте информации об авторских правах. Экземпляр класса Event. Имена полей, доступных через метод Event.get:

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

Методы

ИмяВозвращаетОписание
add(customCopyrights)

ICopyrightsAccessor

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

addProvider(provider)

map.Copyrights

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

get([point[, zoom]])

vow.Promise

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

getPromoLink()

String

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

removeProvider(provider)

map.Copyrights

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

Описание событий

change

Событие изменения размещённой на карте информации об авторских правах. Экземпляр класса Event. Имена полей, доступных через метод Event.get:

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

Описание методов

add

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

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

Параметры:

ПараметрЗначение по умолчаниюОписание
customCopyrights *
[no-highlight[

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

]no-highlight]

Тип: String|HTMLElement|String[]|HTMLElement[]

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

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

addProvider

{map.Copyrights} addProvider(provider)

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

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

Параметры:

ПараметрЗначение по умолчаниюОписание
provider *
[no-highlight[

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

]no-highlight]

Тип: ICopyrightsProvider

Провайдер.

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

Пример:

// Создадим динамический провайдер информации об авторских правах,
// который будет получать актуальную информацию об авторских правах для
// конкретной точки карты с удаленного сервера.
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

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

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

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

Параметры:

ПараметрЗначение по умолчаниюОписание
point

Тип: Number[]

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

zoom

Тип: Number

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

getPromoLink

{String} getPromoLink()

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

removeProvider

{map.Copyrights} removeProvider(provider)

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

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

Параметры:

ПараметрЗначение по умолчаниюОписание
provider *
[no-highlight[

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

]no-highlight]

Тип: ICopyrightsProvider

Провайдер.

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