---
metadata:
  - name: generator
    content: Diplodoc Platform v5.37.1
alternate:
  - https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/point.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/jsapi-v1-1/doc/ru/llms.txt

# YMaps.Point

Расширяет [YMaps.ICoordPoint](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/icoordpoint.md).

Класс точки в двумерном эвклидовом пространстве. Используется для представления пиксельных координат.
## Конструктор

Имя | Описание
----- | -----
[YMaps.Point](point.md#constructor)(x, y) | Создает объект точки в двумерном эвклидовом пространстве.


## Поля

Имя | Описание
----- | -----
[x](point.md#x) | Координата точки по оси x.
[y](point.md#y) | Координата точки по оси y.

## Методы

Имя | Статический | Возвращает | Описание
----- | ----- | ----- | -----
[apply](point.md#apply)(func) |  | [YMaps.Point](point.md) | Последовательно применяет к значениям координат точки указанную функцию.
[applyX](point.md#applyX)(func) |  | [YMaps.Point](point.md) | Применяет к значению координаты x переданную функцию.
[applyY](point.md#applyY)(func) |  | [YMaps.Point](point.md) | Применяет к значению координаты y переданную функцию.
[equals](point.md#equals)(point) |  | Boolean | Сравнивает две точки: точку, заданную параметром point и точку, для которой вызывается метод.
[fromString](point.md#.fromString)(string) | ![](../_images/check.png) | [YMaps.Point](point.md) | Создает точку по ее строковому представлению.
[moveByX](point.md#moveByX)(dx) |  | [YMaps.Point](point.md) | Сдвигает точку по оси x.
[moveByY](point.md#moveByY)(dy) |  | [YMaps.Point](point.md) | Сдвигает точку по оси y.
[moveToX](point.md#moveToX)(x) |  | [YMaps.Point](point.md) | Устанавливает значение координаты x.
[moveToY](point.md#moveToY)(y) |  | [YMaps.Point](point.md) | Устанавливает значение координаты y.
[neg](point.md#neg)() |  | [YMaps.Point](point.md) | Инвертирует знак у значений координат.
[scale](point.md#scale)(scaleCoef) |  | [YMaps.Point](point.md) | Масштабирует значения координат точки по обеим осям.
[scaleX](point.md#scaleX)(scaleCoef) |  | [YMaps.Point](point.md) | Масштабирует значение координаты x.
[scaleY](point.md#scaleY)(scaleCoef) |  | [YMaps.Point](point.md) | Масштабирует значение координаты y.
[toString](point.md#toString)(precision) |  | String | Возвращает строковое представление точки в виде "x,y".

## Наследуемые методы

Из [YMaps.ICoordPoint](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/icoordpoint.md): 
: [copy](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/icoordpoint.md#copy), [diff](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/icoordpoint.md#diff), [getX](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/icoordpoint.md#getX), [getY](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/icoordpoint.md#getY), [moveBy](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/icoordpoint.md#moveBy), [moveTo](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/icoordpoint.md#moveTo), [setX](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/icoordpoint.md#setX), [setY](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/icoordpoint.md#setY)

## Подробное описание конструктора {#constructor}

```javascript
YMaps.Point(x, y)
```

Создает объект точки в двумерном эвклидовом пространстве.

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

Имя | Тип | Необязательный | По умолчанию | Описание
----- | ----- | ----- | ----- | -----
`x` | Number |  |  | Координата по оси x.
`y` | Number | ![](../_images/check.png) | значение параметра x | Координата по оси y.

## Подробное описание полей {#field_detail}

### x {#x}

```javascript
Number x
```

Координата точки по оси x.
### y {#y}

```javascript
Number y
```

Координата точки по оси y.
## Подробное описание методов {#method_detail}

### apply {#apply}

```javascript
{YMaps.Point} apply(func)
```

Последовательно применяет к значениям координат точки указанную функцию. Результат вызова функции становится новым значением координаты.

**Пример:**

```javascript
// Уменьшает значение координаты в два раза, если оно больше единицы.
var point = new YMaps.Point(1, 2);
point.apply(function (coord) {
    return coord > 1 : coord / 2 : coord;
});
point.toString() // 1,1
```

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

Имя | Тип | Описание
----- | ----- | -----
`func` | Function | Функция, применяемая к координатам точки.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Point](point.md) | Ссылку на себя.

### applyX {#applyX}

```javascript
{YMaps.Point} applyX(func)
```

Применяет к значению координаты x переданную функцию.

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

Имя | Тип | Описание
----- | ----- | -----
`func` | Function | Функция, применяемая к значению координаты x.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Point](point.md) | Ссылку на себя.

### applyY {#applyY}

```javascript
{YMaps.Point} applyY(func)
```

Применяет к значению координаты y переданную функцию.

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

Имя | Тип | Описание
----- | ----- | -----
`func` | Function | Функция, применяемая к значению координаты y.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Point](point.md) | Ссылку на себя.

### equals {#equals}

```javascript
{Boolean} equals(point)
```

Сравнивает две точки: точку, заданную параметром point и точку, для которой вызывается метод. Точки совпадают, если они имеют одинаковые значения координат по обеим осям.

**Пример:**

```javascript

var point = new YMaps.Point(37, 55);
var point2 = new YMaps.Point(37, 55);
alert(point.equals(point2)); // Точки совпадают.
```

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

Имя | Тип | Описание
----- | ----- | -----
`point` | [YMaps.Point](point.md) | Точка.


**Возвращает:**

Тип | Описание
----- | -----
Boolean | true - точки совпадают, false - не совпадают.

### fromString {#fromString}

```javascript
{YMaps.Point} fromString(string)
```

Создает точку по ее строковому представлению. Формат строкового представления: "x,y".

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

Имя | Тип | Описание
----- | ----- | -----
`string` | String | Строковое представление точки.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Point](point.md) | Точку.

### moveByX {#moveByX}

```javascript
{YMaps.Point} moveByX(dx)
```

Сдвигает точку по оси x.

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

Имя | Тип | Описание
----- | ----- | -----
`dx` | Number | Сдвиг по оси x.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Point](point.md) | Ссылку на себя.

### moveByY {#moveByY}

```javascript
{YMaps.Point} moveByY(dy)
```

Сдвигает точку по оси y.

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

Имя | Тип | Описание
----- | ----- | -----
`dy` | Number | Сдвиг по оси y.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Point](point.md) | Ссылку на себя.

### moveToX {#moveToX}

```javascript
{YMaps.Point} moveToX(x)
```

Устанавливает значение координаты x.

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

Имя | Тип | Описание
----- | ----- | -----
`x` | Number | Координата по оси x.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Point](point.md) | Ссылку на себя.

### moveToY {#moveToY}

```javascript
{YMaps.Point} moveToY(y)
```

Устанавливает значение координаты y.

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

Имя | Тип | Описание
----- | ----- | -----
`y` | Number | Координата по оси y.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Point](point.md) | Ссылку на себя.

### neg {#neg}

```javascript
{YMaps.Point} neg()
```

Инвертирует знак у значений координат.

**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Point](point.md) | Точку с координатами, инвертированными по знаку.

### scale {#scale}

```javascript
{YMaps.Point} scale(scaleCoef)
```

Масштабирует значения координат точки по обеим осям.

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

Имя | Тип | Описание
----- | ----- | -----
`scaleCoef` | Number|[YMaps.Point](point.md) | Коэффициент масштабирования.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Point](point.md) | Ссылку на себя.

### scaleX {#scaleX}

```javascript
{YMaps.Point} scaleX(scaleCoef)
```

Масштабирует значение координаты x.

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

Имя | Тип | Описание
----- | ----- | -----
`scaleCoef` | Number | Коэффициент масштабирования.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Point](point.md) | Ссылку на себя.

### scaleY {#scaleY}

```javascript
{YMaps.Point} scaleY(scaleCoef)
```

Масштабирует значение координаты y.

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

Имя | Тип | Описание
----- | ----- | -----
`scaleCoef` | Number | Коэффициент масштабирования.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Point](point.md) | Ссылку на себя.

### toString {#toString}

```javascript
{String} toString(precision)
```

Возвращает строковое представление точки в виде "x,y".

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

Имя | Тип | Необязательный | По умолчанию | Описание
----- | ----- | ----- | ----- | -----
`precision` | Integer | ![](../_images/check.png) |  | Точность, с которой округляются значения. По умолчанию не округляются.


**Возвращает:**

Тип | Описание
----- | -----
String | Строковое представление точки.