---
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/en/llms.txt

# IPositioningContext

Interface for the positioning context, an object that allows to position an object inside itself that is defined by global pixel coordinates.

[Constructor](#constructor-summary) | [Methods](#methods-summary)

## Constructor {#constructor-summary}

```javascript
IPositioningContext()
```

## Methods {#methods-summary}

#|
|| **Name** | **Returns** | **Description** ||
|| [fromClientPixels](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IPositioningContext.md#fromClientPixels)([clientPixelPoint](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IPositioningContext.md#fromClientPixels-param-clientPixelPoint)) | Number[] | Converts client pixel coordinates to global coordinates. ||
|| [getZoom](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IPositioningContext.md#getZoom)() | Number | Returns the current zoom level at which the positioning context works. ||
|| [toClientPixels](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IPositioningContext.md#toClientPixels)([globalPixelPoint](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IPositioningContext.md#toClientPixels-param-globalPixelPoint)) | Number[] | Converts global pixel coordinates to client coordinates.||
|#

## Methods details {#method_detail}


### fromClientPixels {#fromClientPixels}

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

Converts client pixel coordinates to global coordinates.

**Returns** global pixel coordinates.

**Parameters:**

#|
|| **Parameter** | **Default value** | **Description**  ||
|| [`clientPixelPoint`](#fromClientPixels-param-clientPixelPoint)[*](*star) | — | Type: Number[]

Client pixel coordinates. ||
|#

\* Mandatory parameter/option.

### getZoom {#getZoom}

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

**Returns** the current zoom level at which the positioning context works.

### toClientPixels  {#toClientPixels}

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

Converts global pixel coordinates to client coordinates.

**Returns** client pixel coordinates.

**Parameters:**

#|
|| **Parameter** | **Default value** | **Description**  ||
|| [`globalPixelPoint`](#toClientPixels-param-globalPixelPoint)[*](*star) | — | Type: Number[]

Global pixel coordinates. ||
|#

\* Mandatory parameter/option.

[*star]: Mandatory parameter/option.