map.Copyrights
Расширяет IEventEmitter.
Менеджер размещённой на карте информации об авторских правах. У каждой карты уже есть собственный менеджер информации об авторских правах, доступный как map.copyrights. Не инстанцируйте экземпляры этого класса без необходимости.
См.: Map.copyrights
Конструктор | Поля | События | Методы
Конструктор
map.Copyrights(map)
Параметры:
* Обязательный параметр/опция.
Пример:
// Добавим статическую информацию об авторских правах на карту
var accessor = map.copyrights.add('© Герард Меркатор');
// ...
// Удалим информацию об авторских правах
accessor.remove();
Поля
Имя | Тип | Описание |
---|---|---|
events | IEventManager | Менеджер событий. Унаследовано от IEventEmitter. |
Имя | Тип | Описание |
---|---|---|
events | IEventManager | Менеджер событий. Унаследовано от IEventEmitter. |
События
Методы
Имя | Возвращает | Описание |
---|---|---|
add(customCopyrights) | Добавляет на карту статическую (не зависящую от текущего центра и масштаба карты) информацию об авторских правах. | |
addProvider(provider) | Добавляет нового провайдера информации об авторских правах. | |
get([point[, zoom]]) | Определяет информацию об авторских правах в указанной точке. Возвращает объект-promise, который будет подтверждён и передаст в качестве параметра массив строк/DOM-элементов. | |
removeProvider(provider) | Удаляет провайдера информации об авторских правах. |
Имя | Возвращает | Описание |
---|---|---|
add(customCopyrights) | Добавляет на карту статическую (не зависящую от текущего центра и масштаба карты) информацию об авторских правах. | |
addProvider(provider) | Добавляет нового провайдера информации об авторских правах. | |
get([point[, zoom]]) | Определяет информацию об авторских правах в указанной точке. Возвращает объект-promise, который будет подтверждён и передаст в качестве параметра массив строк/DOM-элементов. | |
removeProvider(provider) | Удаляет провайдера информации об авторских правах. |
Описание событий
change
- oldCopyrights - старый массив информации об авторских правах;
- newCopyrights - новый массив информации об авторских правах;
Описание методов
add
Добавляет на карту статическую (не зависящую от текущего центра и масштаба карты) информацию об авторских правах.
Returns объект, позволяющий управлять добавленной информацией.
Параметры:
Параметр | Значение по умолчанию | Описание |
---|---|---|
customCopyrights * | — | Тип: String|HTMLElement|String[]|HTMLElement[] Информация об авторских правах в виде строки, DOM-элемента либо массива строк/DOM-элементов. |
Параметр | Значение по умолчанию | Описание |
---|---|---|
customCopyrights * | — | Тип: String|HTMLElement|String[]|HTMLElement[] Информация об авторских правах в виде строки, DOM-элемента либо массива строк/DOM-элементов. |
* Обязательный параметр/опция.
addProvider
{map.Copyrights} addProvider(provider)
Добавляет нового провайдера информации об авторских правах.
Returns ссылку на себя.
Параметры:
Параметр | Значение по умолчанию | Описание |
---|---|---|
provider * | — | Тип: ICopyrightsProvider Провайдер. |
Параметр | Значение по умолчанию | Описание |
---|---|---|
provider * | — | Тип: ICopyrightsProvider Провайдер. |
* Обязательный параметр/опция.
Пример:
// Создадим динамический провайдер информации об авторских правах,
// который будет получать актуальную информацию об авторских правах для
// конкретной точки карты с удаленного сервера.
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
{util.Promise} get([point[, zoom]])
Определяет информацию об авторских правах в указанной точке. Возвращает объект-promise, который будет подтверждён и передаст в качестве параметра массив строк/DOM-элементов.
Returns объект-promise.
Параметры:
Параметр | Значение по умолчанию | Описание |
---|---|---|
point | — | Тип: Number[] Точка (в географических координатах), для которой требуется определить информацию об авторских правах. Если не указана, берётся текущий центр карты. |
zoom | — | Тип: Number Уровень масштабирования, для которого требуется определить информацию об авторских правах. Если не указан, берётся текущий уровень масштабирования карты. |
Параметр | Значение по умолчанию | Описание |
---|---|---|
point | — | Тип: Number[] Точка (в географических координатах), для которой требуется определить информацию об авторских правах. Если не указана, берётся текущий центр карты. |
zoom | — | Тип: Number Уровень масштабирования, для которого требуется определить информацию об авторских правах. Если не указан, берётся текущий уровень масштабирования карты. |
removeProvider
{map.Copyrights} removeProvider(provider)
Удаляет провайдера информации об авторских правах.
Returns ссылку на себя.
Параметры:
Параметр | Значение по умолчанию | Описание |
---|---|---|
provider * | — | Тип: ICopyrightsProvider Провайдер. |
Параметр | Значение по умолчанию | Описание |
---|---|---|
provider * | — | Тип: ICopyrightsProvider Провайдер. |
* Обязательный параметр/опция.