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

# ILineStringGeometryAccess

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

Интерфейс доступа к геометрии "Ломаная линия".

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

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

```javascript
ILineStringGeometryAccess()
```

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

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

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

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

#|
|| **Имя** | **Описание** ||
|| [change](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.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 - новые координаты; ||
|#


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

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [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/ILineStringGeometryAccess.md#get)([index](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md#get-param-index)) | Number[] | Возвращает координаты точки с заданным индексом. ||
|| [getChildGeometry](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md#getChildGeometry)([index](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md#getChildGeometry-param-index)) | [IPointGeometryAccess](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPointGeometryAccess.md) | Создает и возвращает объект [IPointGeometryAccess](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPointGeometryAccess.md) для заданной вершины ломаной линии. ||
|| [getClosest](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md#getClosest)([anchorPosition](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md#getClosest-param-anchorPosition)) | Object | Ищет на ломаной линии точку, ближайшую к anchorPosition. ||
|| [getCoordinates](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md#getCoordinates)() | Number[][] | Возвращает массив координат геометрии. ||
|| [getLength](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md#getLength)() | Integer | Возвращает количество точек в геометрии. ||
|| [insert](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md#insert)([index](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md#insert-param-index), [coordinates](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md#insert-param-coordinates)) | [ILineStringGeometryAccess](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md) | Добавляет новую точку с заданным индексом. ||
|| [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/ILineStringGeometryAccess.md#remove)([index](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md#remove-param-index)) | Number[] | Удаляет точку с заданным индексом. ||
|| [set](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md#set)([index](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md#set-param-index), [coordinates](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md#set-param-coordinates)) | [ILineStringGeometryAccess](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md) | Задает координаты точки c заданным индексом. ||
|| [setCoordinates](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md#setCoordinates)([coordinates](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md#setCoordinates-param-coordinates)) | [ILineStringGeometryAccess](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md) | Задает массив координат геометрии. ||
|| [splice](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md#splice)([index](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md#splice-param-index), [number](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ILineStringGeometryAccess.md#splice-param-number)) | Number[][] | Удаляет определенное число точек начиная с заданного индекса. При этом на место удаляемых точек могут быть добавлены новые. Координаты новых точек можно передавать дополнительными аргументами после параметра number. ||
|| [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). \|
|#

## Описание событий {#event_detail}

### change {#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 - новые координаты;

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

### get {#get}

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

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

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

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

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

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

**Пример:**

```javascript
// Отмечаем начало линии меткой:
map.geoObjects.add(
    new ymaps.Placemark(polyline.geometry.get(0), { iconContent: 'A' })
);
```

### getChildGeometry {#getChildGeometry}

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

Создает и возвращает объект [IPointGeometryAccess](https://yandex.com.tr/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IPointGeometryAccess.md) для заданной вершины ломаной линии.

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

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

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

Индекс вершины. ||
|#

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

### getClosest {#getClosest}

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

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

**Возвращает** объект со следующими полями:
- position - точка на ломаной ближайшая к anchorPosition;
- distance - расстояние от anchorPosition до position;
- closestPointIndex - индекс вершины, ближайшей к position;
- nextPointIndex - индекс вершины, следующей за position;
- prevPointIndex - индекс вершины, предшествующей position.
Поля nextPointIndex, prevPointIndex могут отсутствовать, если position совпадает с одной из вершин ломаной линии.

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

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

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

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

**Пример:**

```javascript
// Удаляем из линии точки по клику на ней:
myPolyline.events.add('click', function (e) {
    myPolyline.geometry.remove(
        myPolyline.geometry.getClosest(e.get('coords')).closestPointIndex
    );
});
```

### getCoordinates {#getCoordinates}

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

**Возвращает** массив координат геометрии.

### getLength {#getLength}

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

**Возвращает** количество точек в геометрии.

### insert {#insert}

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

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

**Возвращает** ссылку на себя.

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

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

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

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

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

**Пример:**

```javascript
// Добавляем новую точку в конце линии по клику на карте.
myMap.events.add('click', function (e) {
    myLineString.insert(myLineString.getLength(), e.get('coords'));
});
```

### remove {#remove}

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

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

**Возвращает** координаты удаленной точки.

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

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

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

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

### set {#set}

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

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

**Возвращает** ссылку на себя.

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

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

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

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

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

### setCoordinates {#setCoordinates}

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

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

**Возвращает** ссылку на себя.

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

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

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

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

### splice {#splice}

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

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

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

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

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

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

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

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

**Пример:**

```javascript
// Добавляем новую точку в начало линии по клику на карте.
myMap.events.add('click', function (e) {
    myLineString.splice(0, 0, myLineString.getLength(), e.get('coords'));
});
```

<!-- XLIFF_FARM_NWM3YTJk_CACHING -->

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