map.Converter

Класс для преобразования глобальных пиксельных координат точки (считаются от левого верхнего угла мира) в локальные (считаются от левого верхнего угла окна) и наоборот. У каждой карты уже есть собственный конвертер, доступный как map.converter. Не инстанцируйте экземпляры этого класса без необходимости.

См.: Map.converter

Конструктор | Методы

Конструктор

map.Converter(map)

Параметры:

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

Тип: Map

Ссылка на карту.

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

Методы

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

Number[]

Преобразовывает глобальные пиксельные координаты точки в локальные.

pageToGlobal (pagePixelPoint)

Number[]

Преобразовывает локальные пиксельные координаты точки в глобальные.

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

globalToPage

{Number[]} globalToPage(globalPixelPoint)

Преобразовывает глобальные пиксельные координаты точки в локальные.

Возвращает преобразованные координаты.

Параметры:

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

Тип: Number[]

Пиксельные координаты точки, которые необходимо преобразовать.

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

Пример:

// Преобразуем географические координаты в пиксели окна браузера
var projection = map.options.get('projection');
console.log(map.converter.globalToPage(
    projection.toGlobalPixels(
        // географические координаты
        [55, 37],
        map.getZoom()
    )
));

pageToGlobal

{Number[]} pageToGlobal(pagePixelPoint)

Преобразовывает локальные пиксельные координаты точки в глобальные.

Возвращает преобразованные координаты.

Параметры:

Параметр Значение по умолчанию Описание
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(', ');
});