---
metadata:
  - name: generator
    content: Diplodoc Platform v5.37.1
alternate:
  - https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/tilecoordinates.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/jsapi-v1-1/doc/ru/llms.txt

# YMaps.TileCoordinates

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


{% note alert %}

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

{% endnote %}


Объект класса YMaps.TileCoordinates существует в единственном экземпляре для каждой карты и доступен в объекте карты как [YMaps.Map.tileCoordinates](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/map.md#tileCoordinates).

**См.:** [Преобразование координат](https://yandex.ru/dev/jsapi-v1-1/doc/ru/dg/concepts/coordinates_conversion.md)

**Параметры:**

Имя | Тип | Описание
----- | ----- | -----
map | [YMaps.Map](map.md) | Карта.

## Методы

Имя | Возвращает | Описание
----- | ----- | -----
[fromPixels](tilecoordinates.md#fromPixels)(pixelPoint, zoom, tileSize) | Object | Преобразует пиксельные координаты точки в тайловые.
[scale](tilecoordinates.md#scale)(point, fromZoom, toZoom) | [YMaps.Point](point.md) | Выполняет преобразование пиксельных координат при переходе от одного масштаба к другому.
[toPixels](tilecoordinates.md#toPixels)(number, offset, zoom, tileSize) | [YMaps.Point](point.md) | Преобразует тайловые координаты точки в пиксельные.

## Подробное описание методов {#method_detail}

### fromPixels {#fromPixels}

```javascript
{Object} fromPixels(pixelPoint, zoom, tileSize)
```

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

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

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

**Параметры:**

Имя | Тип | Необязательный | По умолчанию | Описание
----- | ----- | ----- | ----- | -----
`pixelPoint` | [YMaps.Point](point.md) |  |  | Пиксельные координаты точки, рассчитанные при максимальном масштабе карты.
`zoom` | Integer |  |  | Текущий коэффициент масштабирования карты.
`tileSize` | Integer | ![](../_images/check.png) | 256 | Размер стороны тайла; должен быть степенью 2.


**Возвращает:**

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

### scale {#scale}

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

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

**Параметры:**

Имя | Тип | Необязательный | По умолчанию | Описание
----- | ----- | ----- | ----- | -----
`point` | [YMaps.Point](point.md) |  |  | Точка в пиксельных координатах.
`fromZoom` | Integer | ![](../_images/check.png) |  | Исходный коэффициент масштабирования. По умолчанию равен текущему коэффициенту масштабирования карты.
`toZoom` | Integer | ![](../_images/check.png) |  | Требуемый коэффициент масштабирования. По умолчанию равен максимальному коэффициенту масштабирования координатной системы.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Point](point.md) | Пиксельные координаты точки на требуемом масштабе.

### toPixels {#toPixels}

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

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

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

**Параметры:**

Имя | Тип | Необязательный | По умолчанию | Описание
----- | ----- | ----- | ----- | -----
`number` | [YMaps.Point](point.md) |  |  | Номер тайла.
`offset` | [YMaps.Point](point.md) |  |  | Смещение точки в пикселах внутри тайла.
`zoom` | Integer |  |  | Текущий коэффициент масштабирования карты.
`tileSize` | Integer | ![](../_images/check.png) | 256 | Размер стороны тайла (должен быть равен одной из степеней числа 2.


**Возвращает:**

Тип | Описание
----- | -----
[YMaps.Point](point.md) | Пиксельные координаты точки, рассчитанные при максимальном коэффициенте масштабирования.