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

Провайдер.

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