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

# IProjection

Проекция. Описывает, каким образом реальная карта проецируется на бесконечную пиксельную плоскость. Один "мир" должен иметь размеры 256х256 пикселей на нулевом масштабе, при этом левый верхний угол "мира" имеет координаты (0, 0), координатные оси направлены вправо и вниз. "Миры" могут быть склеенными по любой оси (либо по обеим осям сразу).

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

```javascript
IProjection()
```

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

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [fromGlobalPixels](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IProjection.md#fromGlobalPixels)([globalPixelPoint](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IProjection.md#fromGlobalPixels-param-globalPixelPoint), [zoom](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IProjection.md#fromGlobalPixels-param-zoom)) | Number[] | Преобразует пиксельные координаты на указанном уровне масштабирования в координаты проекции. ||
|| [getCoordSystem](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IProjection.md#getCoordSystem)() | [ICoordSystem](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICoordSystem.md) | Возвращает координатную систему, используемую проекцией. Необязательный метод. В случае его отсутствия будет использована координатная система [coordSystem.cartesian](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/coordSystem.cartesian.md). ||
|| [isCycled](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IProjection.md#isCycled)() | Boolean[] | Показатель зацикленности проекции. ||
|| [toGlobalPixels](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IProjection.md#toGlobalPixels)([coordPoint](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IProjection.md#toGlobalPixels-param-coordPoint), [zoom](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IProjection.md#toGlobalPixels-param-zoom)) | Number[] | Преобразует координаты проекции в глобальные пиксельные на указанном уровне масштабирования. ||
|#

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

### fromGlobalPixels

```javascript
{Number[]} fromGlobalPixels(globalPixelPoint, zoom)
```

Преобразует пиксельные координаты на указанном уровне масштабирования в координаты проекции.

**Returns** точку в координатах проекции.

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

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

Точка в пиксельных координатах. ||
|| `zoom`[*](*parametr) | — | Тип: Number

Уровень масштабирования. ||
|#

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

### getCoordSystem

```javascript
{ICoordSystem} getCoordSystem()
```

Возвращает координатную систему, используемую проекцией. Необязательный метод. В случае его отсутствия будет использована координатная система [coordSystem.cartesian](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/coordSystem.cartesian.md).

**Returns** координатную систему.

### isCycled

```javascript
{Boolean[]} isCycled()
```

Показатель зацикленности проекции.

**Returns** пару флагов, показывающих, склеена ли карта по пиксельным осям (x/y).

### toGlobalPixels

```javascript
{Number[]} toGlobalPixels(coordPoint, zoom)
```

Преобразует координаты проекции в глобальные пиксельные на указанном уровне масштабирования.

**Returns** пару пиксельных координат.

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

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

Точка в координатах проекции. ||
|| `zoom`[*](*parametr) | — | Тип: Number

Уровень масштабирования. ||
|#


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

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