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.ICoordSystem:
fromCoordPoint, getMaxZoom, getWorldSize

Подробное описание конструктора

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 Геоточку.