Документация
Справочник JavaScript API
2.1.64 (текущая версия)
collection
interactivityModel
Интерфейсы

map.Converter

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

См.: Map.converter

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

Конструктор

map.Converter(map)

Параметры:

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

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

]no-highlight]

Тип: Map

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

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

Методы

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

Number[]

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

pageToGlobal(pagePixelPoint)

Number[]

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

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

globalToPage

{Number[]} globalToPage(globalPixelPoint)

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

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

Параметры:

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

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

]no-highlight]

Тип: Number[]

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

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

Пример:

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

pageToGlobal

{Number[]} pageToGlobal(pagePixelPoint)

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

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

Параметры:

ПараметрЗначение по умолчаниюОписание
pagePixelPoint *
[no-highlight[

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

]no-highlight]

Тип: 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(', ');
});