---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.2
alternate:
  - https://yandex.com/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/util.bounds.md
  - https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md
  - href: https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.com/dev/jsapi-v2-1/doc/ru/llms.txt?revision=r21950234
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/jsapi-v2-1/doc/ru/llms.txt?revision=r21950234

# util.bounds

Статический объект.

Набор статических методов для работы с прямоугольными областями, представленными в виде двух противоположных точек в координатной системе проекции.

[Методы ](#methods-summary)

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

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [areIntersecting](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#areIntersecting)([bounds1](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#areIntersecting-param-bounds1), [bounds2](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#areIntersecting-param-bounds2)[, [projection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#areIntersecting-param-projection)]) | Boolean | Определяет пересекаются ли две прямоугольные области. ||
|| [containsBounds](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#containsBounds)([outer](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#containsBounds-param-outer), [inner](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#containsBounds-param-inner)[, [projection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#containsBounds-param-projection)]) | Boolean | Определяет содержат ли прямоугольная область другую прямоугольную область полностью. ||
|| [containsPoint](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#containsPoint)([bounds](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#containsPoint-param-bounds), [point](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#containsPoint-param-point)[, [projection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#containsPoint-param-projection)]) | Boolean | Определяет содержат ли прямоугольная область точку. ||
|| [fromBounds](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#fromBounds)([sourceBounds](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#fromBounds-param-sourceBounds)[, [projection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#fromBounds-param-projection)]) | Number[][] | Вычисляет прямоугольную область, в которую попадают все переданные. ||
|| [fromGlobalPixelBounds](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#fromGlobalPixelBounds)([pixelBounds](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#fromGlobalPixelBounds-param-pixelBounds), [zoom](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#fromGlobalPixelBounds-param-zoom)[, [projection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#fromGlobalPixelBounds-param-projection)]) | Number[][] | Производит перевод прямоугольной области из пиксельных координат в геокоординаты с учетом масштаба. ||
|| [fromPoints](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#fromPoints)([points](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#fromPoints-param-points)[, [projection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#fromPoints-param-projection)]) | Number[][] | Вычисляет минимальную прямоугольную область, в которую попадают все переданные точки. ||
|| [getCenter](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#getCenter)([bounds](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#getCenter-param-bounds)[, [projection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#getCenter-param-projection)]) | Number[] | Вычисляет центр прямоугольной области в координатной системе проекции. ||
|| [getCenterAndZoom](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#getCenterAndZoom)([bounds](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#getCenterAndZoom-param-bounds), [containerSize](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#getCenterAndZoom-param-containerSize)[, [projection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#getCenterAndZoom-param-projection)[, [params](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#getCenterAndZoom-param-params)]]) | Object | Вычисляет центр и уровень масштабирования, которые необходимо установить карте для того, чтобы полностью отобразить переданную область. ||
|| [getIntersections](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#getIntersections)([bounds1](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#getIntersections-param-bounds1), [bounds2](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#getIntersections-param-bounds2)[, [projection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#getIntersections-param-projection)]) | Number[][][] | Возвращает все пересечения двух прямоугольных областей. В случае, если данные передаются в геокоординатах, то пересечений может быть больше одного. Если области не пересекаются, то возвращается пустой массив. ||
|| [getSize](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#getSize)([bounds](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#getSize-param-bounds)[, [projection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#getSize-param-projection)]) | Number[] | Вычисляет размеры прямоугольной области в координатной системе проекции. ||
|| [toGlobalPixelBounds](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#toGlobalPixelBounds)([geoBounds](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#toGlobalPixelBounds-param-geoBounds), [zoom](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#toGlobalPixelBounds-param-zoom)[, [projection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/util.bounds.md#toGlobalPixelBounds-param-projection)]) | Number[][] | Производит перевод границ из геокоординат в глобальные пиксели с учетом масштаба. ||
|#

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

### areIntersecting {#areIntersecting}

```javascript
{Boolean} areIntersecting(bounds1, bounds2[, projection])
```

Определяет пересекаются ли две прямоугольные области.

**Возвращает** признак пересечения.

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

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

Первая область. ||
|| [`bounds2`](#areIntersecting-param-bounds2)[*](*star) | — | Тип: Number[][]

Вторая область. ||
|| [`projection`](#areIntersecting-param-projection) | [projection.wgs84Mercator](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/projection.wgs84Mercator.md) | Тип: [IProjection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IProjection.md)

Проекция. ||
|#

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

### containsBounds {#containsBounds}

```javascript
{Boolean} containsBounds(outer, inner[, projection])
```

Определяет содержат ли прямоугольная область другую прямоугольную область полностью.

**Возвращает** признак попадания.

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

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

Внешняя область ||
|| [`inner`](#containsBounds-param-inner)[*](*star) | — | Тип: Number[][]

Проверяемая область. ||
|| [`projection`](#containsBounds-param-projection) | [projection.wgs84Mercator](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/projection.wgs84Mercator.md) | Тип: [IProjection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IProjection.md)

Проекция. ||
|#

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

### containsPoint {#containsPoint}

```javascript
{Boolean} containsPoint(bounds, point[, projection])
```

Определяет содержат ли прямоугольная область точку.

**Возвращает** признак попадания.

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

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

Внешняя область ||
|| [`point`](#containsPoint-param-point)[*](*star) | — | Тип: Number[]

Проверяемая точка. ||
|| [`projection`](#containsPoint-param-projection) | [projection.wgs84Mercator](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/projection.wgs84Mercator.md) | Тип: [IProjection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IProjection.md)

Проекция. ||
|#

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

### fromBounds {#fromBounds}

```javascript
{Number[][]} fromBounds(sourceBounds[, projection])
```

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

**Возвращает** вычисленная область.

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

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

Массив прямоугольных обласлей ||
|| [`projection`](#fromBounds-param-projection) | [projection.wgs84Mercator](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/projection.wgs84Mercator.md) | Тип: [IProjection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IProjection.md)

Проекция. ||
|#

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

### fromGlobalPixelBounds {#fromGlobalPixelBounds}

```javascript
{Number[][]} fromGlobalPixelBounds(pixelBounds, zoom[, projection])
```

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

**Возвращает** вычисленные границы в геокоординатах.

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

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

Исходные границы. ||
|| [`zoom`](#fromGlobalPixelBounds-param-zoom)[*](*star) | — | Тип: Number

Масштаб. ||
|| [`projection`](#fromGlobalPixelBounds-param-projection) | [projection.wgs84Mercator](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/projection.wgs84Mercator.md) | Тип: [IProjection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IProjection.md)

Проекция, которая будет использоваться для вычисления геокоординат. ||
|#

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

### fromPoints {#fromPoints}

```javascript
{Number[][]} fromPoints(points[, projection])
```

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

**Возвращает** вычисленная область.

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

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

Массив точек. ||
|| [`projection`](#fromPoints-param-projection) | [projection.wgs84Mercator](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/projection.wgs84Mercator.md) | Тип: [IProjection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IProjection.md)

Проекция. ||
|#

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

### getCenter {#getCenter}

```javascript
{Number[]} getCenter(bounds[, projection])
```

Вычисляет центр прямоугольной области в координатной системе проекции.

**Возвращает** точку-центр в координатной системе входящих данных.

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

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

Область. ||
|| [`projection`](#getCenter-param-projection) | [projection.wgs84Mercator](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/projection.wgs84Mercator.md) | Тип: [IProjection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IProjection.md)

Проекция. ||
|#

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

### getCenterAndZoom {#getCenterAndZoom}

```javascript
{Object} getCenterAndZoom(bounds, containerSize[, projection[, params]])
```

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

**Возвращает** объект с полями center (Number[]) и zoom (Number).

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

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

Область, заданная в географических координатах. Первая точка содержит минимальные значения широты и долготы, вторая точка - максимальные. ||
|| [`containerSize`](#getCenterAndZoom-param-containerSize)[*](*star) | — | Тип: Number[]

Размер контейнера карты. ||
|| [`projection`](#getCenterAndZoom-param-projection) | [projection.wgs84Mercator](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/projection.wgs84Mercator.md) | Тип: [IProjection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IProjection.md)

Проекция. ||
|| [`params`](#getCenterAndZoom-param-params) | — | Тип: Boolean\|Object

Параметры или значение опции preciseZoom. ||
|| [`params.inscribe`](#getCenterAndZoom-param-params.inscribe) | true | Тип: Boolean

true - вписывать область в карту, false — вписывать карту в область. ||
|| [`params.margin`](#getCenterAndZoom-param-params.margin) | 0 | Тип: Number\|Number[]

Отступы от границ видимой области карты. Если задано одно число - оно применяется ко всем сторонам. Если задано два - то это горизонтальные и вертикальные отступы соответственно. Если задан массив из 4х чисел, то это отступы top, right, bottom, left. ||
|| [`params.preciseZoom`](#getCenterAndZoom-param-params.preciseZoom) | false | Тип: Boolean

При значении false уровень масштабирования будет округлен в меньшую сторону. ||
|#

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

### getIntersections {#getIntersections}

```javascript
{Number[][][]} getIntersections(bounds1, bounds2[, projection])
```

**Возвращает** все пересечения двух прямоугольных областей. В случае, если данные передаются в геокоординатах, то пересечений может быть больше одного. Если области не пересекаются, то возвращается пустой массив.

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

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

Первая область. ||
|| [`bounds2`](#getIntersections-param-bounds2)[*](*star) | — | Тип: Number[][]

Вторая область. ||
|| [`projection`](#getIntersections-param-projection) | [projection.wgs84Mercator](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/projection.wgs84Mercator.md) | Тип: [IProjection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IProjection.md)

Проекция. ||
|#

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

### getSize {#getSize}

```javascript
{Number[]} getSize(bounds[, projection])
```

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

**Возвращает** размер области.

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

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

Область. ||
|| [`projection`](#getSize-param-projection) | [projection.wgs84Mercator](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/projection.wgs84Mercator.md) | Тип: [IProjection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IProjection.md)

Проекция. ||
|#

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

### toGlobalPixelBounds {#toGlobalPixelBounds}

```javascript
{Number[][]} toGlobalPixelBounds(geoBounds, zoom[, projection])
```

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

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

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

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

Исходные границы. ||
|| [`zoom`](#toGlobalPixelBounds-param-zoom)[*](*star) | — | Тип: Number

Масштаб. ||
|| [`projection`](#toGlobalPixelBounds-param-projection) | [projection.wgs84Mercator](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/projection.wgs84Mercator.md) | Тип: [IProjection](https://yandex.com/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IProjection.md)

Проекция, в координатной системе которой заданы геокоординаты. ||
|#

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

<!-- XLIFF_FARM_MmM5ZTk2_CACHING -->

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