YMaps.TileCoordinates

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

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

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

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

Параметры:

Имя Тип Описание
map YMaps.Map Карта.

Методы

Имя Возвращает Описание
fromPixels(pixelPoint, zoom, tileSize) Object

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

scale(point, fromZoom, toZoom) YMaps.Point

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

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

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

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

fromPixels

{Object} fromPixels(pixelPoint, zoom, tileSize)

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

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

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

Параметры:

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

Возвращает:

Тип Описание
Object Объект с полями number (номер тайла) и offset (смещение точки в пикселах внутри тайла).

scale

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

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

Параметры:

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

Возвращает:

Тип Описание
YMaps.Point Пиксельные координаты точки на требуемом масштабе.

toPixels

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

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

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

Параметры:

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

Возвращает:

Тип Описание
YMaps.Point Пиксельные координаты точки, рассчитанные при максимальном коэффициенте масштабирования.