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

# IPositioningContext

Интерфейс контекста позиционирования - объекта, позволяющего позиционировать внутри себя объект, заданный глобальными пиксельными координатами.

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

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

```javascript
IPositioningContext()
```

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

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [fromClientPixels](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPositioningContext.md#fromClientPixels)([clientPixelPoint](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPositioningContext.md#fromClientPixels-param-clientPixelPoint)) | Number[] | Преобразует клиентские пиксельные координаты в глобальные. ||
|| [getZoom](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPositioningContext.md#getZoom)() | Number | Возвращает текущий уровень масштабирования, в котором работает контекст позиционирования. ||
|| [toClientPixels](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPositioningContext.md#toClientPixels)([globalPixelPoint](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPositioningContext.md#toClientPixels-param-globalPixelPoint)) | Number[] | Преобразует глобальные пиксельные координаты в клиентские. ||
|#

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

### fromClientPixels {#fromClientPixels}

```javascript
{Number[]} fromClientPixels(clientPixelPoint)
```

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

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

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

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

Клиентские пиксельные координаты. ||
|#

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

### getZoom {#getZoom}

```javascript
{Number} getZoom()
```

**Возвращает** текущий уровень масштабирования, в котором работает контекст позиционирования.

### toClientPixels {#toClientPixels}

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

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

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

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

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

Глобальные пиксельные координаты. ||
|#

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

<!-- XLIFF_FARM_ZDg2Njk3_CACHING -->

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