---
metadata:
  - name: generator
    content: Diplodoc Platform v5.37.1
alternate:
  - https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/converter.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/jsapi-v1-1/doc/ru/llms.txt

# YMaps.Converter

Содержит методы для преобразования координат одного типа в другой.

Данный класс не имеет конструктора.

Объект класса YMaps.Converter существует в единственном экземпляре для каждой карты и доступен в объекте карты как [YMaps.Map.converter](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/map.md#converter).

**См.:** [Преобразование координат](https://yandex.ru/dev/jsapi-v1-1/doc/ru/dg/concepts/coordinates_conversion.md)

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

Имя | Тип | Описание
----- | ----- | -----
map | [YMaps.Map](map.md) | Указатель на карту.

# Методы

Имя | Возвращает | Описание
----- | ----- | -----
[clientPixelsToCoordinates](converter.md#clientPixelsToCoordinates)(clientPixels, unbounded) | [YMaps.ICoordPoint](icoordpoint.md) | Преобразует точку, заданную пиксельными координатами окна браузера, в точку координатной системы.
[clientPixelsToLocalPixels](converter.md#clientPixelsToLocalPixels)(clientPixels) | [YMaps.Point](point.md) | Преобразует точку, заданную пиксельными координатами окна браузера, в точку, заданную локальными пиксельными координатами.
[coordinatesToClientPixels](converter.md#coordinatesToClientPixels)(coordPoint) | [YMaps.Point](point.md) | Преобразует точку системы координат в точку, заданную пиксельными координатами окна браузера.
[coordinatesToLocalPixels](converter.md#coordinatesToLocalPixels)(coordPoint) | [YMaps.Point](point.md) | Преобразует точку координатной системы в точку, заданную локальными пиксельными координатами.
[coordinatesToMapPixels](converter.md#coordinatesToMapPixels)(coordPoint) | [YMaps.Point](point.md) | Преобразует точку координатной системы в точку, заданную пиксельными координатами карты. Используется для расчета местоположения оверлеев на карте.
[localPixelsToClientPixels](converter.md#localPixelsToClientPixels)(localPixels) | [YMaps.Point](point.md) | Преобразует точку, заданную локальными пиксельными координатами в точку, заданную пиксельными координатами окна браузера.
[localPixelsToCoordinates](converter.md#localPixelsToCoordinates)(pixels, unbounded) | [YMaps.ICoordPoint](icoordpoint.md) | Преобразует точку, заданную локальными пиксельными координатами в точку координатной системы.
[localPixelsToMapPixels](converter.md#localPixelsToMapPixels)(localPixels) | [YMaps.Point](point.md) | Преобразует точку, заданную локальными пиксельными координатами, в точку, заданную пиксельными координатами карты.
[mapPixelsToCoordinates](converter.md#mapPixelsToCoordinates)(mapPixels, unbounded) | [YMaps.ICoordPoint](icoordpoint.md) | Преобразует точку, заданную пиксельными координатами карты, в точку координатной системы.
[mapPixelsToLocalPixels](converter.md#mapPixelsToLocalPixels)(mapPixels) | [YMaps.Point](point.md) | Преобразует точку, заданную пиксельными координатами карты, в точку, заданную локальными пиксельными координатами.

## Подробное описание методов {#method_detail}
### clientPixelsToCoordinates {#clientPixelsToCoordinates}

```javascript
{YMaps.ICoordPoint} clientPixelsToCoordinates(clientPixels, unbounded)
```

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

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

Имя | Тип | Необязательный | По умолчанию | Описание
----- | ----- | ----- | ----- | -----
`clientPixels` | [YMaps.Point](point.md) |  |  | Точка, заданная пиксельными координатами окна браузера.
`unbounded` | Boolean | ![](../_images/check.png) | false | Тип требуемой точки: false - ограниченная, true - неограниченная.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.ICoordPoint](icoordpoint.md) | Точку системы координат.

### clientPixelsToLocalPixels {#clientPixelsToLocalPixels}

```javascript
{YMaps.Point} clientPixelsToLocalPixels(clientPixels)
```

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

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

Имя | Тип | Описание
----- | ----- | -----
`clientPixels` | [YMaps.Point](point.md) | Точка, заданная пиксельными координатами окна браузера.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Point](point.md) | Точку, заданную локальными пиксельными координатами.

### coordinatesToClientPixels {#coordinatesToClientPixels}

```javascript
{YMaps.Point} coordinatesToClientPixels(coordPoint)
```

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

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

Имя | Тип | Описание
----- | ----- | -----
`coordPoint` | [YMaps.ICoordPoint](icoordpoint.md) | Точка координатной системы.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Point](point.md) | Точку, заданную пиксельными координатами окна браузера.

### coordinatesToLocalPixels {#coordinatesToLocalPixels}

```javascript
{YMaps.Point} coordinatesToLocalPixels(coordPoint)
```

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

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

Имя | Тип | Описание
----- | ----- | -----
`coordPoint` | [YMaps.ICoordPoint](icoordpoint.md) | Точка координатной системы.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Point](point.md) | Точку, заданную локальными пиксельными координатами, соответствующую точке.

### coordinatesToMapPixels {#coordinatesToMapPixels}

```javascript
{YMaps.Point} coordinatesToMapPixels(coordPoint)
```

Преобразует точку координатной системы в точку, заданную пиксельными координатами карты. Используется для расчета местоположения оверлеев на карте.

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

Имя | Тип | Описание
----- | ----- | -----
`coordPoint` | [YMaps.ICoordPoint](icoordpoint.md) | Точка координатной системы.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Point](point.md) | Точку, заданную пиксельными координатами карты.

### localPixelsToClientPixels {#localPixelsToClientPixels}

```javascript
{YMaps.Point} localPixelsToClientPixels(localPixels)
```

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

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

Имя | Тип | Описание
----- | ----- | -----
`localPixels` | [YMaps.Point](point.md) | Точка, заданная локальными пиксельными координатами.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Point](point.md) | Точку, заданную пиксельными координатами окна браузера.

### localPixelsToCoordinates {#localPixelsToCoordinates}

```javascript
{YMaps.ICoordPoint} localPixelsToCoordinates(pixels, unbounded)
```

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

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

Имя | Тип | Необязательный | По умолчанию | Описание
----- | ----- | ----- | ----- | -----
`pixels` | [YMaps.Point](point.md) |  |  | Точка, заданная локальными пиксельными координатами.
`unbounded` | Boolean | ![](../_images/check.png) | false | Тип требуемой точки: false - ограниченная, true - неограниченная.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.ICoordPoint](icoordpoint.md) | Точку, соответствующую точке, заданной локальными пиксельными координатами.

### localPixelsToMapPixels {#localPixelsToMapPixels}

```javascript
{YMaps.Point} localPixelsToMapPixels(localPixels)
```

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

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

Имя | Тип | Описание
----- | ----- | -----
`localPixels` | [YMaps.Point](point.md) | Точка, заданная локальными пиксельными координатами.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Point](point.md) | Точку, заданную пиксельными координатами карты.

### mapPixelsToCoordinates {#mapPixelsToCoordinates}

```javascript
{YMaps.ICoordPoint} mapPixelsToCoordinates(mapPixels, unbounded)
```

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

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

Имя | Тип | Необязательный | По умолчанию | Описание
----- | ----- | ----- | ----- | -----
`mapPixels` | [YMaps.Point](point.md) |  |  | Точка, заданная пиксельными координатами карты.
`unbounded` | Boolean | ![](../_images/check.png) | false | Тип возвращаемой точки: false - ограниченная, true - неограниченная.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.ICoordPoint](icoordpoint.md) | Точку координатной системы, соответствующую точке в пиксельных координатах карты.

### mapPixelsToLocalPixels {#mapPixelsToLocalPixels}

```javascript
{YMaps.Point} mapPixelsToLocalPixels(mapPixels)
```

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

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

Имя | Тип | Описание
----- | ----- | -----
`mapPixels` | [YMaps.Point](point.md) | Точка, заданная пиксельными координатами карты.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Point](point.md) | Точку, заданную локальными пиксельными координатами.