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

# geometry.Polygon

Расширяет [IPolygonGeometry](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPolygonGeometry.md).

Геометрия "Многоугольник".

**См.:** [Polygon](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Polygon.md)

[Конструктор](#constructor-summary) | [Поля ](#properties-summary) | [События ](#events-summary) | [Методы ](#methods-summary)

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

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

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

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

Координаты геометрии. Трехмерный массив, элементами которого являются двумерные массивы координат контуров многоугольника. Первый элемент описывает внешний контур, остальные - внутренние. ||
|| [`fillRule`](#param-fillRule) | "evenOdd" | Тип: String

Строковый идентификатор, определяющий алгоритм заливки многоугольника. Может принимать одно из двух значений:
- evenOdd - алгоритм, определяющий, находится ли точка в области заполнения, путем рисования луча от этой точки до бесконечности в любом направлении и подсчета количества сегментов контура в пределах заданной фигуры, которые пересекает этот луч. Если это число нечетное, точка находится внутри; если четное, точка находится снаружи.
- nonZero - алгоритм, определяющий, находится ли точка в области заполнения, путем рисования луча от этой точки до бесконечности в любом направлении и проверки точек, в которых сегмент фигуры пересекает этот луч. Начиная с нуля, добавляется единица каждый раз, когда сегмент пересекает луч слева направо, и вычитается единица каждый раз, когда сегмент пересекает луч справа налево. Если после подсчета пересечений результат равен нулю, точка находится снаружи контура. В противном случае она находится внутри. ||
|| [`options`](#param-options) | — | Тип: Object

Опции геометрии. ||
|| [`options.coordRendering`](#param-options.coordRendering) | "shortestPath" | Тип: String

Строковый идентификатор, определяющий алгоритм пересчета координат геометрии в пиксельные координаты. Может принимать одно из двух значений:
- shortestPath - алгоритм, учитывающий зацикленность проекции по осям, и формирующий пиксельные координаты так, чтобы расстояние между двумя соседними точками было минимальным;
- straightPath - алгоритм, не учитывающий зацикленность проекции; ||
|| [`options.geodesic`](#param-options.geodesic) | false | Тип: Boolean

Включает отображение с использованием геодезических линий. ||
|| [`options.pixelRendering`](#param-options.pixelRendering) | "jumpy" | Тип: String

Метод расчета пиксельных координат отображения в зацикленных проекциях. Опция может принимать одно из следующих значений:
- jumpy - отображение располагается как можно ближе к центру области показа карты и может скачкообразно перемещается во время движения карты;
- static - отображение всегда располагается в начальном мире и не перемещается при движении карты. ||
|| [`options.projection`](#param-options.projection) | — | Тип: [IProjection](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IProjection.md)

Проекция. ||
|| [`options.simplification`](#param-options.simplification) | true | Тип: Boolean

Включает симплификацию при рендеринге пиксельной геометрии. ||
|#


**Пример:**

```javascript
// Создаем инстанцию геометрии многоугольника (указываем координаты вершин контуров).
var polygonGeometry = new ymaps.geometry.Polygon([
     // Внешний контур.
    [
        [0, 0], [0, 5], [5, 5], [5, 0], [0, 0]
    ],
    // Внутренний контур.
    [
        [1, 1], [1, 2], [2, 2], [2, 1], [1, 1]
    ]
]),
// Создаем инстанцию геообъекта и передаем нашу геометрию в конструктор.
    polygonGeoObject = new ymaps.GeoObject({ geometry: polygonGeometry });

// Также доступ к polygonGeometry можно получить через polygonGeoObject.geometry.
```

## Поля {#properties-summary}

#|
|| **Имя** | **Тип** | **Описание** ||
|| [events](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventEmitter.md#events) | [IEventManager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventManager.md) | Менеджер событий.

Унаследовано от [IEventEmitter](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventEmitter.md#events). ||
|| [options](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#options) | [IOptionManager](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IOptionManager.md) | Менеджер опций.

Унаследовано от [ICustomizable](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#options). ||
|#

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

#|
|| **Имя** | **Описание** ||
|| [change](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPolygonGeometryAccess.md#event-change) | Изменение координат. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get):
- oldCoordinates — старые координаты;
- newCoordinates - новые координаты;
- oldFillRule - старый алгоритм заливки;
- newFillRule - новые алгоритм заливки.

Унаследовано от [IPolygonGeometryAccess](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPolygonGeometryAccess.md#event-change). ||
|| [mapchange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#event-mapchange) | Сменилась карта. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get):
- oldMap - старая карта;
- newMap - новая карта.

Унаследовано от [IGeometry](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#event-mapchange). ||
|| [optionschange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#event-optionschange) | Изменение в опциях объекта.

Унаследовано от [ICustomizable](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#event-optionschange). ||
|| [pixelgeometrychange](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#event-pixelgeometrychange) | Изменилась пиксельная геометрия. Экземпляр класса [Event](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get):
- pixelGeometry - новая пиксельная геометрия [IPixelGeometry](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPixelGeometry.md).

Унаследовано от [IGeometry](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#event-pixelgeometrychange). ||
|#


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

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

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

Унаследован от [IFreezable](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IFreezable.md#freeze). ||
|| [get](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPolygonGeometryAccess.md#get)([index](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPolygonGeometryAccess.md#get-param-index)) | Number[][] | Возвращает координаты контура c заданным индексом.

Унаследован от [IPolygonGeometryAccess](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPolygonGeometryAccess.md#get). ||
|| [getBounds](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#getBounds)() | Number[][]\|null | Возвращает координаты двух противоположных углов области, охватывающей геометрию. Первый элемент массива - юго-западный угол области; второй элемент - северо-восточный угол соответственно.

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

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

Унаследован от [IPolygonGeometryAccess](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPolygonGeometryAccess.md#getClosest). ||
|| [getCoordinates](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPolygonGeometryAccess.md#getCoordinates)() | Number[][][] | Возвращает массив координат геометрии.

Унаследован от [IPolygonGeometryAccess](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPolygonGeometryAccess.md#getCoordinates). ||
|| [getFillRule](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPolygonGeometryAccess.md#getFillRule)() | String | Возвращает идентификатор алгоритма заливки.

Унаследован от [IPolygonGeometryAccess](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPolygonGeometryAccess.md#getFillRule). ||
|| [getLength](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPolygonGeometryAccess.md#getLength)() | Integer | Возвращает количество контуров в геометрии.

Унаследован от [IPolygonGeometryAccess](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPolygonGeometryAccess.md#getLength). ||
|| [getMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#getMap)() | [Map](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md)\|null | Возвращает текущую карту.

Унаследован от [IGeometry](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#getMap). ||
|| [getPixelGeometry](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#getPixelGeometry)(\[[options](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#getPixelGeometry-param-options)]) | [IPixelGeometry](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPixelGeometry.md) | Возвращает пиксельную геометрию, соответствующую данной геометрии, ее опциям и состоянию карты.

Унаследован от [IGeometry](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#getPixelGeometry). ||
|| [getType](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPolygonGeometry.md#getType)() | String | Возвращает строку "Polygon".

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

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

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

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

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

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

Унаследован от [IPolygonGeometryAccess](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPolygonGeometryAccess.md#setFillRule). ||
|| [setMap](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#setMap)([map](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IGeometry.md#setMap-param-map)) | Задает карту.

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

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

Унаследован от [IFreezable](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IFreezable.md#unfreeze). ||
|#

<!-- XLIFF_FARM_MTNiZjQz_CACHING -->