map.Converter
Класс для преобразования глобальных пиксельных координат точки (считаются от левого верхнего угла мира) в локальные (считаются от левого верхнего угла окна) и наоборот. У каждой карты уже есть собственный конвертер, доступный как map.converter. Не инстанцируйте экземпляры этого класса без необходимости.
См.: Map.converter
Конструктор
map.Converter(map)
Параметры:
Параметр |
Значение по умолчанию |
Описание |
|
— |
Тип: Map Ссылка на карту. |
* Обязательный параметр/опция.
Методы
Имя |
Возвращает |
Описание |
Number[] |
Преобразовывает глобальные пиксельные координаты точки в локальные. |
|
Number[] |
Преобразовывает локальные пиксельные координаты точки в глобальные. |
Описание методов
globalToPage
{Number[]} globalToPage(globalPixelPoint)
Преобразовывает глобальные пиксельные координаты точки в локальные.
Возвращает преобразованные координаты.
Параметры:
Параметр |
Значение по умолчанию |
Описание |
— |
Тип: Number[] Пиксельные координаты точки, которые необходимо преобразовать. |
* Обязательный параметр/опция.
Пример:
// Преобразуем географические координаты в пиксели окна браузера
var projection = map.options.get('projection');
console.log(map.converter.globalToPage(
projection.toGlobalPixels(
// географические координаты
[55, 37],
map.getZoom()
)
));
pageToGlobal
{Number[]} pageToGlobal(pagePixelPoint)
Преобразовывает локальные пиксельные координаты точки в глобальные.
Возвращает преобразованные координаты.
Параметры:
Параметр |
Значение по умолчанию |
Описание |
— |
Тип: Number[] Пиксельные координаты точки, которые необходимо преобразовать. |
* Обязательный параметр/опция.
Пример:
// Преобразуем координаты курсора мыши в геокоординаты
var projection = map.options.get('projection');
$('#map').bind('click', function (e) {
console.log(projection.fromGlobalPixels(
map.converter.pageToGlobal([e.pageX, e.pageY]), map.getZoom()
).join(', ');
});
Обязательный параметр.