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

# projection.Cartesian

Extends [IProjection](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IProjection.md).

Cartesian projection of a rectangular area. Uses the "coordorder" parameter for loading the API - when the value is "latlong", in an array of point coordinates y should be in the first position, and x in the second.

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

## Constructor {#constructor-summary}

```javascript
projection.Cartesian(bounds[, cycled[, scale]])
```

Creates a projection of a rectangular coordinate area in pixels. The size of the area in pixels is always NxN, where N = 256 * 2^zoom.

**Parameters:**

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

Array of two points, the coordinates of the lower-left and upper-right corners of a rectangular coordinate area. ||
|| [`cycled`](#param-cycled) | [false, false] | Type: Boolean[]

Array of indicators of map cycling on x and y. ||
|| [`scale`](#param-scale) | 1 | Type: Number\|Number[]

The increment of a division on an axis. Can be a number or pair of numbers for each of the axes. ||
|#

\* Mandatory parameter/option.

## Methods {#methods-summary}

#|
|| **Name** | **Returns** | **Description** ||
|| [fromGlobalPixels](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IProjection.md#fromGlobalPixels)([globalPixelPoint](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IProjection.md#fromGlobalPixels-param-globalPixelPoint), [zoom](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IProjection.md#fromGlobalPixels-param-zoom)) | Number[] | Converts pixel coordinates to the projection's coordinates at the specified zoom level.

Inherited from [IProjection](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IProjection.md#fromGlobalPixels). ||
|| [getCoordSystem](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IProjection.md#getCoordSystem)() | [ICoordSystem](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/ICoordSystem.md) | Returns the coordinate system that is used by the projection.

Inherited from [IProjection](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IProjection.md#getCoordSystem). ||
|| [isCycled](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IProjection.md#isCycled)() | Boolean[] | Indicator of projection cycling.

Inherited from [IProjection](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IProjection.md#isCycled). ||
|| [toGlobalPixels](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IProjection.md#toGlobalPixels)([coordPoint](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IProjection.md#toGlobalPixels-param-coordPoint), [zoom](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IProjection.md#toGlobalPixels-param-zoom)) | Number[] | Converts projection coordinates to global pixel coordinates at the specified zoom level.

Inherited from [IProjection](https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/IProjection.md#toGlobalPixels). ||
|#


[*star]: Mandatory parameter/option.