map.Copyrights

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

См.: Map.copyrights

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

Конструктор

map.Copyrights(map)

Параметры:

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

Тип: Map

Карта.

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

Пример:

// Добавим статическую информацию об авторских правах на карту.var accessor = map.copyrights.add('© Gerardus Mercator');// ...
// Удаление информации об авторских правах.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 *

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

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

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

addProvider

{map.Copyrights} addProvider(provider)

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

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

Параметры:

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

Тип: 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

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

removeProvider

{map.Copyrights} removeProvider(provider)

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

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

Параметры:

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

Тип: ICopyrightsProvider

Провайдер.

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