YMaps.ICoordSystem

Интерфейс системы координат. Этот интерфейс требуется реализовывать при создании пользовательской координатной системы.

Конструктор

Имя Описание
YMaps.ICoordSystem() Интерфейс системы координат.

Методы

Имя Возвращает Описание
distance(coordPoint1, coordPoint2) Number Возвращает кратчайшее расстояние (по геодезической) между двумя точками координатной системы.
fromCoordPoint(point, anchor) YMaps.Point Преобразует координаты точки, заданные в пользовательской координатной системе в пиксельные координаты.
getCoordBounds(leftBottom, rightTop) YMaps.ICoordBounds Возвращает объект, соответствующий области на карте, заданной двумя точками системы координат.
getCoordPoint(x, y, unbounded) YMaps.ICoordPoint Возвращает объект, соответствующий точке {x,y} в координатной системе.
getMaxZoom() Integer Возвращает максимальный коэффициент масштабирования.
getWorldSize() YMaps.Size Возвращает размеры мира (в пикселах) при максимальном масштабе в виде объекта YMaps.Size.
restrict(coordPoint) YMaps.ICoordPoint Позволяет ограничить область отображения географических объектов на карте. Например, не отображать околополярные (с широтой выше 89.3 градусов) области в проекции Меркатора.
rulerDistance(coordPoint1, coordPoint2) Number Возвращает расстояние "по линейке" между двумя точками координатной системы.
toCoordPoint(pixelPoint, unbounded) YMaps.ICoordPoint Преобразует пиксельные координаты точки в координаты, заданные в пользовательской координатной системе.

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

YMaps.ICoordSystem()

Интерфейс системы координат.

Подробное описание методов

distance

{Number} distance(coordPoint1, coordPoint2)

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

Параметры:

Имя Тип Описание
coordPoint1 YMaps.ICoordPoint Первая точка.
coordPoint2 YMaps.ICoordPoint Вторая точка.

Возвращает:

Тип Описание
Number Расстояние по геодезической прямой.

fromCoordPoint

{YMaps.Point} fromCoordPoint(point, anchor)

Преобразует координаты точки, заданные в пользовательской координатной системе в пиксельные координаты. Пиксельные координаты рассчитываются при максимальном масштабе карты. Для координатных систем, "склеенных" в кольцо по одной из координат, вторым параметром может передаваться точка-якорь. В этом случае метод возвращает координаты точки, расположенной ближе к якорю.

Параметры:

Имя Тип Необязательный По умолчанию Описание
point YMaps.ICoordPoint Точка в координатной системе.
anchor YMaps.ICoordPoint Точка-якорь.

Возвращает:

Тип Описание
YMaps.Point Точку в пиксельных координатах.

getCoordBounds

{YMaps.ICoordBounds} getCoordBounds(leftBottom, rightTop)

Возвращает объект, соответствующий области на карте, заданной двумя точками системы координат.

Параметры:

Имя Тип Описание
leftBottom YMaps.ICoordPoint Левый нижний угол области.
rightTop YMaps.ICoordPoint Правый верхний угол области.

Возвращает:

Тип Описание
YMaps.ICoordBounds Объект-область.

getCoordPoint

{YMaps.ICoordPoint} getCoordPoint(x, y, unbounded)

Возвращает объект, соответствующий точке {x,y} в координатной системе.

См.: Преобразование координат

Параметры:

Имя Тип Необязательный По умолчанию Описание
x Number Первая координата.
y Number Вторая координата.
unbounded Boolean false

Флаг, указывающий тип возвращаемой точки. Требуется для координатных систем, в которых точка может изменять свое положение на карте в зависимости от положения обозревателя (например, в системах, "склеенных" в кольцо по одной из координат).

Для геоточек в географической системе координат true обозначает неограниченную точку, false - ограниченную.

Возвращает:

Тип Описание
YMaps.ICoordPoint Объект-точку.

getMaxZoom

{Integer} getMaxZoom()

Возвращает максимальный коэффициент масштабирования.

Возвращает:

Тип Описание
Integer Максимальный коэффициент масштабирования.

getWorldSize

{YMaps.Size} getWorldSize()

Возвращает размеры мира (в пикселах) при максимальном масштабе в виде объекта YMaps.Size.

Возвращает:

Тип Описание
YMaps.Size Размеры мира (в пикселах).

restrict

{YMaps.ICoordPoint} restrict(coordPoint)

Позволяет ограничить область отображения географических объектов на карте. Например, не отображать околополярные (с широтой выше 89.3 градусов) области в проекции Меркатора. Если точка попадает в неотображаемую область карты, то метод вернет координаты ближайшей точки, которую возможно отобразить.

Параметры:

Имя Тип Описание
coordPoint YMaps.ICoordPoint Точка в координатной системе.

Возвращает:

Тип Описание
YMaps.ICoordPoint Точку в координатной системе с примененными ограничениями.

rulerDistance

{Number} rulerDistance(coordPoint1, coordPoint2)

Возвращает расстояние "по линейке" между двумя точками координатной системы.

Параметры:

Имя Тип Описание
coordPoint1 YMaps.ICoordPoint Первая точка.
coordPoint2 YMaps.ICoordPoint Вторая точка.

Возвращает:

Тип Описание
Number Расстояние "по линейке".

toCoordPoint

{YMaps.ICoordPoint} toCoordPoint(pixelPoint, unbounded)

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

См.: Преобразование координат

Параметры:

Имя Тип Необязательный По умолчанию Описание
pixelPoint YMaps.Point Пиксельные координаты точки при максимальном масштабе карты.
unbounded Boolean false

Флаг, указывающий тип возвращаемой точки. Требуется для координатных систем, в которых точка может изменять свое положение на карте в зависимости от положения обозревателя (например, в системах, "склеенных" в кольцо по одной из координат).

Для геоточек в географической системе координат true обозначает неограниченную точку, false - ограниченную.

Возвращает:

Тип Описание
YMaps.ICoordPoint Точку в координатной системе.