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