YMaps.TileCoordinates

Содержит методы преобразования пиксельных координат в тайловые и обратно.

Пиксельные координаты рассчитываются при максимальном масштабе карты.

Объект класса YMaps.TileCoordinates существует в единственном экземпляре для каждой карты и доступен в объекте карты как YMaps.Map.tileCoordinates.

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

Параметры:

Методы

fromPixels

{Object} fromPixels(pixelPoint, zoom, tileSize)

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

Тайловые координаты возвращаются в виде объекта с двумя полями, задающими номер тайла (number) и смещение в пикселах внутри тайла (offset), соответственно.

В случае, если указанным пиксельным координатам соответствует тайл, лежащий вне области карты (несуществующий тайл), значение поля number будет равно null.

Параметры:

Имя	Тип	Необязательный	По умолчанию	Описание
pixelPoint	YMaps.Point			Пиксельные координаты точки, рассчитанные при максимальном масштабе карты.
zoom	Integer			Текущий коэффициент масштабирования карты.
tileSize	Integer		256	Размер стороны тайла; должен быть степенью 2.

Возвращает:

scale

{YMaps.Point} scale(point, fromZoom, toZoom)

Выполняет преобразование пиксельных координат при переходе от одного масштаба к другому.

Параметры:

Имя	Тип	Необязательный	По умолчанию	Описание
point	YMaps.Point			Точка в пиксельных координатах.
fromZoom	Integer			Исходный коэффициент масштабирования. По умолчанию равен текущему коэффициенту масштабирования карты.
toZoom	Integer			Требуемый коэффициент масштабирования. По умолчанию равен максимальному коэффициенту масштабирования координатной системы.

Возвращает:

toPixels

{YMaps.Point} toPixels(number, offset, zoom, tileSize)

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

Тайловые координаты точки задаются номером тайла и пиксельным смещением точки внутри тайла. Также указывается текущий коэффициент масштабирования карты.

Параметры:

Имя	Тип	Необязательный	По умолчанию	Описание
number	YMaps.Point			Номер тайла.
offset	YMaps.Point			Смещение точки в пикселах внутри тайла.
zoom	Integer			Текущий коэффициент масштабирования карты.
tileSize	Integer		256	Размер стороны тайла (должен быть равен одной из степеней числа 2.

Возвращает: