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

# map.Converter

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

**См.:** [Map.converter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#converter)

[Конструктор](#constructor-summary) | [Методы ](#methods-summary)

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

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

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание**  ||
|| [`map`](#param-map)[*](*star) | — | Тип: [Map](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md)

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

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

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

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

## Описание методов {#method_detail}

### globalToPage {#globalToPage}

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

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

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

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

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

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

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

**Пример:**

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

### pageToGlobal {#pageToGlobal}

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

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

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

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание**  ||
|| [`pagePixelPoint`](#pageToGlobal-param-pagePixelPoint)[*](*star) | — | Тип: 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(', ');
});
```

<!-- XLIFF_FARM_YzgyODRi_CACHING -->

[*star]: Обязательный параметр.