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} в координатной системе.
Параметры:
Имя |
Тип |
Необязательный |
По умолчанию |
Описание |
|
Number |
Первая координата. |
||
|
Number |
Вторая координата. |
||
|
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)
Преобразует пиксельные координаты точки в координаты, заданные в пользовательской координатной системе. Пиксельные координаты должны быть рассчитаны при максимальном масштабе карты.
Параметры:
Имя |
Тип |
Необязательный |
По умолчанию |
Описание |
|
Пиксельные координаты точки при максимальном масштабе карты. |
|||
|
Boolean |
false |
Флаг, указывающий тип возвращаемой точки. Требуется для координатных систем, в которых точка может изменять свое положение на карте в зависимости от положения обозревателя (например, в системах, "склеенных" в кольцо по одной из координат). Для геоточек в географической системе координат true обозначает неограниченную точку, false - ограниченную. |
Возвращает:
Тип | Описание |
---|---|
YMaps.ICoordPoint | Точку в координатной системе. |