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

# YMaps.GeoCoordSystem

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

Класс "географическая система координат".

## Конструктор

Имя | Описание
----- | -----
[YMaps.GeoCoordSystem](geocoordsystem.md#constructor)(radius, maxZoom) | Создает объект, реализующий географическую систему координат.

## Методы

Имя | Возвращает | Описание
----- | ----- | -----
[distance](geocoordsystem.md#distance)(point1, point2) | Number | Возвращает расстояние между двумя заданными точками (в метрах).
[getCoordBounds](geocoordsystem.md#getCoordBounds)(bottomLeft, topRight) | [YMaps.GeoBounds](geobounds.md) | Создает экземпляр объекта [YMaps.GeoBounds](geobounds.md) по координатам двух диагональных вершин прямоугольной области.
[getCoordPoint](geocoordsystem.md#getCoordPoint)(x, y, unbounded) | [YMaps.GeoPoint](geopoint.md) | Возвращает геоточку указанного типа (ограниченная/неограниченная) с требуемыми координатами.
[restrict](geocoordsystem.md#restrict)(geoPoint) | [YMaps.GeoPoint](geopoint.md) | Применяет к геоточке ограничения по широте.
[rulerDistance](geocoordsystem.md#rulerDistance)(point1, point2) | Number | Возвращает расстояние между двумя заданными точками (в метрах), если двигаться вдоль прямой соединяющей точки на карте. Используется для расчета расстояний в элементе управления "Линейка".
[toCoordPoint](geocoordsystem.md#toCoordPoint)(pixelPoint, unbounded) | [YMaps.GeoPoint](geopoint.md) | Преобразует координаты точки, заданные в пикселах, в географические координаты.

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

Из [YMaps.ICoordSystem](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/icoordsystem.md): 
: [fromCoordPoint](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/icoordsystem.md#fromCoordPoint), [getMaxZoom](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/icoordsystem.md#getMaxZoom), [getWorldSize](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/icoordsystem.md#getWorldSize)

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

```javascript
YMaps.GeoCoordSystem(radius, maxZoom)
```

Создает объект, реализующий географическую систему координат.

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

Имя | Тип | Необязательный | По умолчанию | Описание
----- | ----- | ----- | ----- | -----
`radius` | Number | ![](../_images/check.png) | 6378137 | Радиус сферы.
`maxZoom` | Integer | ![](../_images/check.png) | 23 | Максимальный коэффициент масштабирования карты.

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

### distance {#distance}

```javascript
{Number} distance(point1, point2)
```

Возвращает расстояние между двумя заданными точками (в метрах). Земля упрощенно принимается за эллипсоид, соответственно, расстояние между двумя точками на поверхности равно длине кратчайшей дуги (геодезической прямой), соединяющей эти точки.

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

Имя | Тип | Описание
----- | ----- | -----
`point1` | [YMaps.GeoPoint](geopoint.md) | Первая точка.
`point2` | [YMaps.GeoPoint](geopoint.md) | Вторая точка.


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

Тип | Описание
----- | -----
Number | Расстояние по геодезической прямой между двумя заданными точками.

### getCoordBounds {#getCoordBounds}

```javascript
{YMaps.GeoBounds} getCoordBounds(bottomLeft, topRight)
```

Создает экземпляр объекта [YMaps.GeoBounds](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/geobounds.md) по координатам двух диагональных вершин прямоугольной области. Объект [YMaps.GeoBounds](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/geobounds.md) описывает границы прямоугольной области на карте.

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

Имя | Тип | Описание
----- | ----- | -----
`bottomLeft` | [YMaps.GeoPoint](geopoint.md) | Координаты левого нижнего угла области.
`topRight` | [YMaps.GeoPoint](geopoint.md) | Координаты правого верхнего угла области.


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

Тип | Описание
----- | -----
[YMaps.GeoBounds](geobounds.md) | Объект [YMaps.GeoBounds](geobounds.md).

### getCoordPoint {#getCoordPoint}

```javascript
{YMaps.GeoPoint} getCoordPoint(x, y, unbounded)
```

Возвращает геоточку указанного типа (ограниченная/неограниченная) с требуемыми координатами.

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

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


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

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

### restrict {#restrict}

```javascript
{YMaps.GeoPoint} restrict(geoPoint)
```

Применяет к геоточке ограничения по широте. Предельная широта объектов, отображаемых в географической системе координат [YMaps.GeoCoordSystem](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/geocoordsystem.md), составляет 89.3 градусов. Метод принудительно ограничивает широту геоточки этим значением.

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

Имя | Тип | Описание
----- | ----- | -----
`geoPoint` | [YMaps.GeoPoint](geopoint.md) | Точка в координатной системе.


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

Тип | Описание
----- | -----
[YMaps.GeoPoint](geopoint.md) | Точку в координатной системе с примененными ограничениями.

### rulerDistance {#rulerDistance}

```javascript
{Number} rulerDistance(point1, point2)
```

Возвращает расстояние между двумя заданными точками (в метрах), если двигаться вдоль прямой соединяющей точки на карте. Используется для расчета расстояний в элементе управления "Линейка".

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

Имя | Тип | Описание
----- | ----- | -----
`point1` | [YMaps.GeoPoint](geopoint.md) | Первая точка.
`point2` | [YMaps.GeoPoint](geopoint.md) | Вторая точка.


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

Тип | Описание
----- | -----
Number | Расстояние "по линейке" между двумя заданными точками.

### toCoordPoint {#toCoordPoint}

```javascript
{YMaps.GeoPoint} toCoordPoint(pixelPoint, unbounded)
```

Преобразует координаты точки, заданные в пикселах, в географические координаты. Пиксельные координаты должны быть рассчитаны при максимальном масштабе карты.

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

Имя | Тип | Необязательный | По умолчанию | Описание
----- | ----- | ----- | ----- | -----
`pixelPoint` | [YMaps.Point](point.md) |  |  | Пиксельные координаты точки при максимальном масштабе карты.
`unbounded` | Boolean | ![](../_images/check.png) | false | Флаг, указывающий тип возвращаемой точки: false - ограниченная, true - неограниченная.


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

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