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

# ILinearRingGeometryAccess

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

Интерфейс доступа к геометрии "Замкнутый контур".

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

```javascript
ILinearRingGeometryAccess()
```

## Поля {#fields}

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

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

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

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

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

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

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

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

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

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [contains](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#contains)([position](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#contains-param-position)) | Boolean | Проверяет, лежит ли переданная точка внутри контура. ||
|| [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/ILinearRingGeometryAccess.md#get)([index](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#get-param-index)) | Number[] | Returns координаты точки с заданным индексом. ||
|| [getChildGeometry](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#getChildGeometry)([index](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#getChildGeometry-param-index)) | [IPointGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPointGeometryAccess.md) | Создает и возвращает объект [IPointGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPointGeometryAccess.md) для заданной вершины контура. ||
|| [getClosest](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#getClosest)([anchorPosition](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#getClosest-param-anchorPosition)) | Object | Ищет на контуре точку, ближайшую к anchorPosition. ||
|| [getCoordinates](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#getCoordinates)() | Number[][] | Returns массив координат геометрии. ||
|| [getFillRule](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#getFillRule)() | String | Returns идентификатор алгоритма заливки. ||
|| [getLength](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#getLength)() | Integer | Returns количество точек в геометрии. ||
|| [insert](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#insert)([index](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#insert-param-index), [coordinates](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#insert-param-coordinates)) | [ILinearRingGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md) | Добавляет новую точку с заданным индексом. ||
|| [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/ILinearRingGeometryAccess.md#remove)([index](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#remove-param-index)) | Number[] | Удаляет точку с заданным индексом. ||
|| [set](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#set)([index](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#set-param-index), [coordinates](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#set-param-coordinates)) | [ILinearRingGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md) | Задает координаты точки c заданным индексом. ||
|| [setCoordinates](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#setCoordinates)([coordinates](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#setCoordinates-param-coordinates)) | [ILinearRingGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md) | Задает массив координат геометрии. ||
|| [setFillRule](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#setFillRule)([fillRule](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#setFillRule-param-fillRule)) | [ILinearRingGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md) | Задает алгоритм заливки контура. ||
|| [splice](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#splice)([index](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#splice-param-index), [number](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILinearRingGeometryAccess.md#splice-param-number)) | Number[][] | Удаляет определенное число точек начиная с заданного индекса. При этом на место удаляемых точек могут быть добавлены новые. Координаты новых точек можно передавать дополнительными аргументами после параметра number. ||
|| [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-events}

### change

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

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

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

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

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

## Описание методов {#description-methods}

### contains

```javascript
{Boolean} contains(position)
```

Проверяет, лежит ли переданная точка внутри контура.

**Returns** признак принадлежности точки контуру.

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

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

Координаты точки. ||
|#

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

### get

```javascript
{Number[]} get(index)
```

**Returns** координаты точки с заданным индексом.

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `index`[*](*parametr) | — | Тип: Integer

Индекс точки. ||
|#

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

### getChildGeometry

```javascript
{IPointGeometryAccess} getChildGeometry(index)
```

Создает и возвращает объект [IPointGeometryAccess](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPointGeometryAccess.md) для заданной вершины контура.

**Returns** объект геометрии "Точка", соответствующий заданной вершине.

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `index`[*](*parametr) | — | Тип: Integer

Индекс вершины контура. ||
|#

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

### getClosest

```javascript
{Object} getClosest(anchorPosition)
```

Ищет на контуре точку, ближайшую к anchorPosition.

**Returns** объект со следующими полями:

• position - точка на контуре ближайшая к anchorPosition;

• distance - расстояние от anchorPosition до position;

• closestPointIndex - индекс вершины, ближайшей к position;

• nextPointIndex - индекс вершины, следующей за position;

• prevPointIndex - индекс вершины, предшествующей position.

Поля nextPointIndex, prevPointIndex могут отсутствовать, если position совпадает с одной из вершин контура.

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

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

Координаты точки, для которой расчитывается ближайшая точка на контуре. ||
|#

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

### getCoordinates

```javascript
{Number[][]} getCoordinates()
```

**Returns** массив координат геометрии.

### getFillRule

```javascript
{String} getFillRule()
```

**Returns** идентификатор алгоритма заливки.

### getLength

```javascript
{Integer} getLength()
```

**Returns** количество точек в геометрии.

### insert

```javascript
{ILinearRingGeometryAccess} insert(index, coordinates)
```

Добавляет новую точку с заданным индексом.

**Returns** ссылку на себя.

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `index`[*](*parametr) | — | Тип: Integer

Индекс точки. ||
|| `coordinates`[*](*parametr) | — | Тип: Number[]

Координаты точки. ||
|#

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

### remove

```javascript
{Number[]} remove(index)
```

Удаляет точку с заданным индексом.

**Returns** координаты удаленной точки.

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `index`[*](*parametr) | — | Тип: Integer

Индекс точки. ||
|#

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

### set

```javascript
{ILinearRingGeometryAccess} set(index, coordinates)
```

Задает координаты точки c заданным индексом.

**Returns** ссылка на себя.

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `index`[*](*parametr) | — | Тип: Integer

Индекс точки. ||
|| `coordinates`[*](*parametr) | — | Тип: Number[]

Координаты точки. ||
|#

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

### setCoordinates

```javascript
{ILinearRingGeometryAccess} setCoordinates(coordinates)
```

Задает массив координат геометрии.

**Returns** ссылка на себя.

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

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

Координаты геометрии. ||
|#

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

### setFillRule

```javascript
{ILinearRingGeometryAccess} setFillRule(fillRule)
```

Задает алгоритм заливки контура.

**Returns** ссылку на себя.

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `fillRule`[*](*parametr) | — | Тип: String

Идентификатор алгоритма заливки. ||
|#

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

### splice

```javascript
{Number[][]} splice(index, number)
```

Удаляет определенное число точек начиная с заданного индекса. При этом на место удаляемых точек могут быть добавлены новые. Координаты новых точек можно передавать дополнительными аргументами после параметра number.

**Returns** массив координат удаленных точек.

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `index`[*](*parametr) | — | Тип: Integer

Индекс, начиная с которого производится удаление и добавление точек. ||
|| `number`[*](*parametr) | — | Тип: Integer

Количество удаляемых точек. ||
|#


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

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