---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Converter.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/llms.txt

# map.Converter

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

**См.:** [Map.converter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Map.md#converter)

## Конструктор {#constructor}

```javascript
map.Converter(map)
```

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `map`[*](*parametr) | — | Тип: [Map](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Map.md)

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

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


## Методы {#methods}

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [globalToPage](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Converter.md#globalToPage)([globalPixelPoint](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Converter.md#globalToPage-param-globalPixelPoint)) | Number[] | Преобразовывает глобальные пиксельные координаты точки в локальные. ||
|| [pageToGlobal](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Converter.md#pageToGlobal)([pagePixelPoint](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Converter.md#pageToGlobal-param-pagePixelPoint)) | Number[] | Преобразовывает локальные пиксельные координаты точки в глобальные. ||
|#

## Описание методов {#description-methods}

### globalToPage

```javascript
{Number[]} globalToPage(globalPixelPoint)
```

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

**Returns** преобразованные координаты.

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `globalPixelPoint`[*](*parametr) | — | Тип: Number[]

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

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

**Пример:**

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

### pageToGlobal

```javascript
{Number[]} pageToGlobal(pagePixelPoint)
```

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

**Returns** преобразованные координаты.

**Параметры:**

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `pagePixelPoint`[*](*parametr) | — | Тип: Number[]

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

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

**Пример:**

```javascript
// Преобразуем координаты курсора мыши в геокоординаты
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(', ');
});
```

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