YMaps.GeoCoordSystem
Расширяет YMaps.ICoordSystem.
Класс "географическая система координат".
Конструктор
| Имя | Описание |
|---|---|
| YMaps.GeoCoordSystem(radius, maxZoom) | Создает объект, реализующий географическую систему координат. |
Методы
| Имя | Возвращает | Описание |
|---|---|---|
| distance(point1, point2) | Number | Возвращает расстояние между двумя заданными точками (в метрах). |
| getCoordBounds(bottomLeft, topRight) | YMaps.GeoBounds | Создает экземпляр объекта YMaps.GeoBounds по координатам двух диагональных вершин прямоугольной области. |
| getCoordPoint(x, y, unbounded) | YMaps.GeoPoint | Возвращает геоточку указанного типа (ограниченная/неограниченная) с требуемыми координатами. |
| restrict(geoPoint) | YMaps.GeoPoint | Применяет к геоточке ограничения по широте. |
| rulerDistance(point1, point2) | Number | Возвращает расстояние между двумя заданными точками (в метрах), если двигаться вдоль прямой соединяющей точки на карте. Используется для расчета расстояний в элементе управления "Линейка". |
| toCoordPoint(pixelPoint, unbounded) | YMaps.GeoPoint | Преобразует координаты точки, заданные в пикселах, в географические координаты. |
Наследуемые методы
Подробное описание конструктора
YMaps.GeoCoordSystem(radius, maxZoom)
Создает объект, реализующий географическую систему координат.
Параметры:
| Имя | Тип | Необязательный | По умолчанию | Описание |
|---|---|---|---|---|
radius |
Number |  |
6378137 | Радиус сферы. |
maxZoom |
Integer | |
23 | Максимальный коэффициент масштабирования карты. |
Подробное описание методов
distance
{Number} distance(point1, point2)
Возвращает расстояние между двумя заданными точками (в метрах). Земля упрощенно принимается за эллипсоид, соответственно, расстояние между двумя точками на поверхности равно длине кратчайшей дуги (геодезической прямой), соединяющей эти точки.
Параметры:
| Имя | Тип | Описание |
|---|---|---|
point1 |
YMaps.GeoPoint | Первая точка. |
point2 |
YMaps.GeoPoint | Вторая точка. |
Возвращает:
| Тип | Описание |
|---|---|
| Number | Расстояние по геодезической прямой между двумя заданными точками. |
getCoordBounds
{YMaps.GeoBounds} getCoordBounds(bottomLeft, topRight)
Создает экземпляр объекта YMaps.GeoBounds по координатам двух диагональных вершин прямоугольной области. Объект YMaps.GeoBounds описывает границы прямоугольной области на карте.
Параметры:
| Имя | Тип | Описание |
|---|---|---|
bottomLeft |
YMaps.GeoPoint | Координаты левого нижнего угла области. |
topRight |
YMaps.GeoPoint | Координаты правого верхнего угла области. |
Возвращает:
| Тип | Описание |
|---|---|
| YMaps.GeoBounds | Объект YMaps.GeoBounds. |
getCoordPoint
{YMaps.GeoPoint} getCoordPoint(x, y, unbounded)
Возвращает геоточку указанного типа (ограниченная/неограниченная) с требуемыми координатами.
Параметры:
| Имя | Тип | Необязательный | По умолчанию | Описание |
|---|---|---|---|---|
x |
Number | Долгота точки. | ||
y |
Number | Широта точки. | ||
unbounded |
Boolean | |
false | Тип возвращаемой точки: true - неограниченная, false - ограниченная. |
Возвращает:
| Тип | Описание |
|---|---|
| YMaps.GeoPoint | Геоточку. |
restrict
{YMaps.GeoPoint} restrict(geoPoint)
Применяет к геоточке ограничения по широте. Предельная широта объектов, отображаемых в географической системе координат YMaps.GeoCoordSystem, составляет 89.3 градусов. Метод принудительно ограничивает широту геоточки этим значением.
Параметры:
| Имя | Тип | Описание |
|---|---|---|
geoPoint |
YMaps.GeoPoint | Точка в координатной системе. |
Возвращает:
| Тип | Описание |
|---|---|
| YMaps.GeoPoint | Точку в координатной системе с примененными ограничениями. |
rulerDistance
{Number} rulerDistance(point1, point2)
Возвращает расстояние между двумя заданными точками (в метрах), если двигаться вдоль прямой соединяющей точки на карте. Используется для расчета расстояний в элементе управления "Линейка".
Параметры:
| Имя | Тип | Описание |
|---|---|---|
point1 |
YMaps.GeoPoint | Первая точка. |
point2 |
YMaps.GeoPoint | Вторая точка. |
Возвращает:
| Тип | Описание |
|---|---|
| Number | Расстояние "по линейке" между двумя заданными точками. |
toCoordPoint
{YMaps.GeoPoint} toCoordPoint(pixelPoint, unbounded)
Преобразует координаты точки, заданные в пикселах, в географические координаты. Пиксельные координаты должны быть рассчитаны при максимальном масштабе карты.
Параметры:
| Имя | Тип | Необязательный | По умолчанию | Описание |
|---|---|---|---|---|
pixelPoint |
YMaps.Point | Пиксельные координаты точки при максимальном масштабе карты. | ||
unbounded |
Boolean | |
false | Флаг, указывающий тип возвращаемой точки: false - ограниченная, true - неограниченная. |
Возвращает:
| Тип | Описание |
|---|---|
| YMaps.GeoPoint | Геоточку. |