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

# YMaps.GeoPoint

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

Класс для создания геоточки.

**См.:** [Преобразование координат](https://yandex.ru/dev/jsapi-v1-1/doc/ru/dg/concepts/coordinates_conversion.md)
# Конструктор

Имя | Описание
----- | -----
[YMaps.GeoPoint](geopoint.md#constructor)(lng, lat, unbounded) | Создает точку, заданную географическими координатами (геоточку).

# Методы

Имя | Статический | Возвращает | Описание
----- | ----- | ----- | -----
[distance](geopoint.md#distance)(point) |  | Number | Возвращает кратчайшее расстояние между двумя точками земной поверхности (в метрах).
[equals](geopoint.md#equals)(point) |  | Boolean | Сравнивает две точки: точку, переданную параметром point и точку, для которой вызывается метод. Точки совпадают, если у них одинаковые значения координат по обеим осям с точностью до 8 знака после запятой и одинаковое значение флага ограниченности.
[fromString](geopoint.md#.fromString)(string) | ![](../_images/check.png) | [YMaps.GeoPoint](geopoint.md) | Создает геоточку по ее строковому представлению.
[getLat](geopoint.md#getLat)() |  | Number | Широта геоточки.
[getLng](geopoint.md#getLng)() |  | Number | Долгота геоточки.
[isUnbounded](geopoint.md#isUnbounded)() |  | Boolean | Возвращает true, если геоточка неограниченная, иначе - false.
[setLat](geopoint.md#setLat)(lat) |  | [YMaps.GeoPoint](geopoint.md) | Устанавливает широту.
[setLng](geopoint.md#setLng)(lng) |  | [YMaps.GeoPoint](geopoint.md) | Устанавливает долготу.
[toString](geopoint.md#toString)(precision) |  | String | Возвращает строковое представление геоточки в виде "долгота,широта".

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

Из [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.GeoPoint(lng, lat, unbounded)
```

Создает точку, заданную географическими координатами (геоточку). Позволяет создать как обычную (ограниченную) геоточку (с долготой в пределах от -180 до 180 градусов и широтой в пределах от -90 до 90 градусов), так и неограниченную (с произвольными долготой и широтой).

**См.:** [Преобразование координат](https://yandex.ru/dev/jsapi-v1-1/doc/ru/dg/concepts/coordinates_conversion.md)

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

Имя | Тип | Необязательный | По умолчанию | Описание
----- | ----- | ----- | ----- | -----
`lng` | Number | ![](../_images/check.png) | 0 | Долгота в градусах.
`lat` | Number | ![](../_images/check.png) | 0 | Широта в градусах.
`unbounded` | Boolean | ![](../_images/check.png) | false | Флаг, определяющий тип геоточки: true - неограниченная, false - ограниченная.

## Подробное описание методов {#method_detail}

### distance {#distance}

```javascript
{Number} distance(point)
```

Возвращает кратчайшее расстояние между двумя точками земной поверхности (в метрах).

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

Имя | Тип | Описание
----- | ----- | -----
`point` | [YMaps.GeoPoint](geopoint.md) | Точка, расстояние до которой требуется измерить


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

Тип | Описание
----- | -----
Number | Расстояние в метрах

### equals {#equals}

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

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

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

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


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

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

### fromString {#fromString}

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

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

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

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


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

Тип | Описание
----- | -----
[YMaps.GeoPoint](geopoint.md) | Геоточку.

### getLat {#getLat}

```javascript
{Number} getLat()
```

Широта геоточки.

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

Тип | Описание
----- | -----
Number | Широту.

### getLng {#getLng}

```javascript
{Number} getLng()
```

Долгота геоточки.

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

Тип | Описание
----- | -----
Number | Долготу геоточки.

### isUnbounded {#isUnbounded}

```javascript
{Boolean} isUnbounded()
```

Возвращает true, если геоточка неограниченная, иначе - false.

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

Тип | Описание
----- | -----
Boolean | true - точка неограниченная; false - ограниченная.

### setLat {#setLat}

```javascript
{YMaps.GeoPoint} setLat(lat)
```

Устанавливает широту.

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

Имя | Тип | Описание
----- | ----- | -----
`lat` | Number | Широта.


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

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

### setLng {#setLng}

```javascript
{YMaps.GeoPoint} setLng(lng)
```

Устанавливает долготу.

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

Имя | Тип | Описание
----- | ----- | -----
`lng` | Number | Долгота.


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

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

### toString {#toString}

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

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

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

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


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

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