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 | Пиксельные координаты точки, рассчитанные при максимальном коэффициенте масштабирования. |