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

# geometry.base.Polygon

Расширяет [IBasePolygonGeometry](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IBasePolygonGeometry.md).

Базовая геометрия "Многоугольник".

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

```javascript
geometry.base.Polygon([coordinates[, fillRule]])
```

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| coordinates | []  | Тип: Number[][][]

Координаты геометрии. ||
|| fillRule | "evenOdd"  | Тип: String

Строковый идентификатор, определяющий алгоритм заливки многоугольника. Может принимать одно из двух значений: 
• evenOdd - алгоритм, определяющий, находится ли точка в области заполнения, путем рисования луча от этой точки до бесконечности в любом направлении и подсчета количества сегментов контура в пределах заданной фигуры, которые пересекает этот луч. Если это число нечетное, точка находится внутри; если четное, точка находится снаружи.

• nonZero - алгоритм, определяющий, находится ли точка в области заполнения, путем рисования луча от этой точки до бесконечности в любом направлении и проверки точек, в которых сегмент фигуры пересекает этот луч. Начиная с нуля, добавляется единица каждый раз, когда сегмент пересекает луч слева направо, и вычитается единица каждый раз, когда сегмент пересекает луч справа налево. Если после подсчета пересечений результат равен нулю, точка находится снаружи контура. В противном случае она находится внутри. ||
|#

**Пример:**

```javascript
var polygon = new ymaps.geometry.base.Polygon([
    // Внешний контур.
    [
        [0, 0], [0, 5], [5, 5], [5, 0], [0, 0]
    ],
    // Внутренний контур.
    [
        [1, 1], [1, 2], [2, 2], [2, 1], [1, 1]
    ]
]);
```

## Поля {#fields}

#|
|| **Имя** | **Тип** | **Описание** ||
|| [events](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/geometry.base.Polygon.md#events) | [event.Manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/event.Manager.md) | Менеджер событий геометрии. ||
|#

## События {#events}

#|
|| **Имя** | **Описание** ||
|| [change](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#change) | Изменение координат. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• oldCoordinates - старые координаты;

• newCoordinates - новые координаты;

• oldFillRule - старый алгоритм заливки;

• newFillRule - новые алгоритм заливки.

Унаследовано от [IPolygonGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#change). ||
|#

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

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [contains](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#contains)([position](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#contains-param-position)) | Boolean | Проверяет, лежит ли переданная точка внутри многоугольника.

Унаследован от [IPolygonGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#contains). ||
|| [freeze](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IFreezable.md#freeze)() | [IFreezable](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IFreezable.md) | Переводит объект в "замороженный" режим.

Унаследован от [IFreezable](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IFreezable.md#freeze). ||
|| [get](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#get)([index](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#get-param-index)) | Number[][] | Returns координаты контура с заданным индексом.

Унаследован от [IPolygonGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#get). ||
|| [getBounds](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IBaseGeometry.md#getBounds)() | Number[][]\|null | Returns координаты двух противоположных углов области, охватывающей геометрию. Первый элемент массива - угол с наименьшими значениями координат относительно остальных точек области; второй элемент - угол с наибольшими значениями координат.

Унаследован от [IBaseGeometry](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IBaseGeometry.md#getBounds). ||
|| [getChildGeometry](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#getChildGeometry)([index](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#getChildGeometry-param-index)) | [ILinearRingGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md) | Создает и возвращает объект [ILinearRingGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md) для заданного контура.

Унаследован от [IPolygonGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#getChildGeometry). ||
|| [getClosest](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#getClosest)([anchorPosition](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#getClosest-param-anchorPosition)) | Object | Ищет на контуре многоугольника точку, ближайшую к anchorPosition.

Унаследован от [IPolygonGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#getClosest). ||
|| [getCoordinates](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#getCoordinates)() | Number[][][] | Returns массив координат геометрии.

Унаследован от [IPolygonGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#getCoordinates). ||
|| [getFillRule](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#getFillRule)() | String | Returns идентификатор алгоритма заливки.

Унаследован от [IPolygonGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#getFillRule). ||
|| [getLength](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#getLength)() | Integer | Returns количество контуров в геометрии.

Унаследован от [IPolygonGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#getLength). ||
|| [getType](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IBasePolygonGeometry.md#getType)() | String | Returns строку "Polygon".

Унаследован от [IBasePolygonGeometry](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IBasePolygonGeometry.md#getType). ||
|| [insert](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#insert)([index](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#insert-param-index), [path](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#insert-param-path)) | [IPolygonGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md) | Добавляет новый контур с заданным индексом.

Унаследован от [IPolygonGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#insert). ||
|| [isFrozen](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IFreezable.md#isFrozen)() | Boolean | Returns true, если объект находится в "замороженном" режиме, иначе false.

Унаследован от [IFreezable](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IFreezable.md#isFrozen). ||
|| [remove](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#remove)([index](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#remove-param-index)) | [ILinearRingGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md) | Удаляет контур с заданным индексом.

Унаследован от [IPolygonGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#remove). ||
|| [set](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#set)([index](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#set-param-index), [path](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#set-param-path)) | [IPolygonGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md) | Задает координаты контура c заданным индексом.

Унаследован от [IPolygonGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#set). ||
|| [setCoordinates](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#setCoordinates)([coordinates](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#setCoordinates-param-coordinates)) | [IPolygonGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md) | Задает массив координат геометрии.

Унаследован от [IPolygonGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#setCoordinates). ||
|| [setFillRule](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#setFillRule)([fillRule](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#setFillRule-param-fillRule)) | [IPolygonGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md) | Задает алгоритм заливки многоугольника.

Унаследован от [IPolygonGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#setFillRule). ||
|| [splice](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#splice)([index](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#splice-param-index), [number](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#splice-param-number)) | [ILinearRingGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md)[] | Удаляет определенное число контуров начиная с заданного индекса. При этом на место удаляемых контуров могут быть добавлены новые. Координаты новых контуров можно передавать дополнительными аргументами после параметра number.

Унаследован от [IPolygonGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPolygonGeometryAccess.md#splice). ||
|| [unfreeze](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IFreezable.md#unfreeze)() | [IFreezable](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IFreezable.md) | Переводит объект в активный режим.

Унаследован от [IFreezable](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IFreezable.md#unfreeze). ||
|#

## Описание полей {#description-fields}

### events

```javascript
{event.Manager} events
```

Менеджер событий геометрии.